SqlColumnEncryptionKeyStoreProvider.SignColumnMasterKeyMetadataAsync Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Cuando se implementa en una clase derivada, firma asincrónicamente los metadatos de la clave maestra de columna con la clave maestra de columna a la que hace referencia el 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
Ruta de acceso de la clave maestra de columna. El formato de ruta de acceso es específico de la implementación del proveedor del almacén de claves (por ejemplo, una huella digital para el almacén de certificados o una dirección URL de identificador de clave para Azure Key Vault).
- allowEnclaveComputations
- Boolean
true para indicar que la clave maestra de columna admite cálculos de enclave; de lo contrario, false. Cuando truees , la firma generada cubre la propiedad habilitada para enclave para que los metadatos se puedan comprobar posteriormente para su uso en el enclave.
- cancellationToken
- CancellationToken
Token para cancelar la operación asincrónica.
Devoluciones
Una tarea que, cuando se completa, devuelve una Byte matriz que representa la firma de los metadatos de la clave maestra de columna. El formato de firma es específico del proveedor.
Comentarios
La implementación predeterminada comprueba primero y cancellationToken devuelve una tarea cancelada si se ha solicitado la cancelación. De lo contrario, llama al método sincrónico SignColumnMasterKeyMetadata(String, Boolean) , que produce una excepción de NotImplementedException forma predeterminada. En este caso, se producirá un error en la tarea devuelta en NotImplementedException lugar de iniciarse sincrónicamente.
Las clases derivadas que realizan E/S deben invalidar este método con una implementación verdaderamente asincrónica que respeta el token de cancelación.
Los proveedores de almacén de claves que desean usar enclaves con Always Encrypted deben invalidar este método con una implementación verdaderamente asincrónica cuando la operación de firma implica E/S.