SqlColumnEncryptionKeyStoreProvider.SignColumnMasterKeyMetadataAsync Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Quando implementado em uma classe derivada, assina de forma assíncrona os metadados da chave mestra de coluna com a chave mestra de coluna referenciada pelo masterKeyPath parâmetro.
public virtual System.Threading.Tasks.Task<byte[]> SignColumnMasterKeyMetadataAsync(string masterKeyPath, bool allowEnclaveComputations, System.Threading.CancellationToken cancellationToken = default);abstract member SignColumnMasterKeyMetadataAsync : string * bool * System.Threading.CancellationToken -> System.Threading.Tasks.Task<byte[]>
override this.SignColumnMasterKeyMetadataAsync : string * bool * System.Threading.CancellationToken -> System.Threading.Tasks.Task<byte[]>Public Overridable Function SignColumnMasterKeyMetadataAsync (masterKeyPath As String, allowEnclaveComputations As Boolean, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Byte())Parâmetros
- masterKeyPath
- String
O caminho da chave mestra da coluna. O formato de caminho é específico para a implementação do provedor do repositório de chaves (por exemplo, uma impressão digital para o repositório de certificados ou uma URL do identificador de chave para Azure Key Vault).
- allowEnclaveComputations
- Boolean
true para indicar que a chave mestra de coluna dá suporte a cálculos de enclave; caso contrário, false. Quando truea assinatura gerada abrange a propriedade habilitada para enclave para que os metadados possam ser verificados posteriormente para uso de enclave.
- cancellationToken
- CancellationToken
Um token para cancelar a operação assíncrona.
Retornos
Uma tarefa que, quando concluída, retorna uma Byte matriz que representa a assinatura dos metadados da chave mestra da coluna. O formato de assinatura é específico do provedor.
Comentários
A implementação padrão primeiro verifica e cancellationToken retorna uma tarefa cancelada se o cancelamento foi solicitado. Caso contrário, ele chama o método síncrono SignColumnMasterKeyMetadata(String, Boolean) , que lança um NotImplementedException por padrão. Nesse caso, a tarefa retornada NotImplementedException terá falha em vez de ser lançada de forma síncrona.
Classes derivadas que executam E/S devem substituir esse método por uma implementação verdadeiramente assíncrona que honre o token de cancelamento.
Os principais provedores de repositório que desejam usar enclaves com Always Encrypted devem substituir esse método por uma implementação verdadeiramente assíncrona quando a operação de assinatura envolve E/S.