SqlColumnEncryptionKeyStoreProvider.VerifyColumnMasterKeyMetadataAsync 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 implementada em uma classe derivada, verifica de forma assíncrona se a assinatura especificada é válida para a chave mestra de coluna com o caminho de chave especificado e o comportamento do enclave especificado. A implementação padrão retorna uma tarefa com falha com NotImplementedException.
public virtual System.Threading.Tasks.Task<bool> VerifyColumnMasterKeyMetadataAsync(string masterKeyPath, bool allowEnclaveComputations, byte[] signature, System.Threading.CancellationToken cancellationToken = default);
abstract member VerifyColumnMasterKeyMetadataAsync : string * bool * byte[] * System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>
override this.VerifyColumnMasterKeyMetadataAsync : string * bool * byte[] * System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>
Public Overridable Function VerifyColumnMasterKeyMetadataAsync (masterKeyPath As String, allowEnclaveComputations As Boolean, signature As Byte(), Optional cancellationToken As CancellationToken = Nothing) As Task(Of Boolean)
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
Indica se a chave mestra de coluna dá suporte a cálculos de enclave. Esse valor deve corresponder ao que foi passado quando SignColumnMasterKeyMetadata(String, Boolean) a assinatura foi gerada.
- signature
- Byte[]
A assinatura a ser verificada, conforme retornado anteriormente por SignColumnMasterKeyMetadata(String, Boolean). O formato é específico do provedor.
- cancellationToken
- CancellationToken
Um token para cancelar a operação assíncrona.
Retornos
Uma tarefa que, quando concluída, retorna true se a assinatura especificada é válida ou false se não é válida.
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 VerifyColumnMasterKeyMetadata(String, Boolean, Byte[]) , 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.