SqlColumnEncryptionKeyStoreProvider.SignColumnMasterKeyMetadataAsync Metoda

Definicja

Przestrzeń nazw:: Microsoft.Data.SqlClient

Zestaw:: Microsoft.Data.SqlClient.dll

Pakiet:: Microsoft.Data.SqlClient v7.1.0

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

W przypadku implementacji w klasie pochodnej asynchronicznie podpisuje metadane klucza głównego kolumny przy użyciu klucza głównego kolumny, do których odwołuje się masterKeyPath parametr .

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())

Parametry

masterKeyPath: String

Ścieżka klucza głównego kolumny. Format ścieżki jest specyficzny dla implementacji dostawcy magazynu kluczy (np. odcisk palca magazynu certyfikatów lub adres URL identyfikatora klucza dla Azure Key Vault).

allowEnclaveComputations: Boolean

true aby wskazać, że klucz główny kolumny obsługuje obliczenia enklawy; w przeciwnym razie, false. Gdy truewygenerowany podpis obejmuje właściwość z włączoną enklawą, dzięki czemu metadane można później zweryfikować pod kątem użycia enklawy.

cancellationToken: CancellationToken

Token umożliwiający anulowanie operacji asynchronicznej.

Zwraca

Task<Byte[]>

Zadanie, które po zakończeniu zwraca tablicę Byte reprezentującą podpis metadanych klucza głównego kolumny. Format podpisu jest specyficzny dla dostawcy.

Uwagi

Domyślna implementacja najpierw sprawdza cancellationToken i zwraca anulowane zadanie, jeśli zażądano anulowania. W przeciwnym razie wywołuje metodę synchroniczną SignColumnMasterKeyMetadata(String, Boolean) , która domyślnie zgłasza NotImplementedException wyjątek . W takim przypadku zwrócone zadanie zostanie uszkodzone NotImplementedException zamiast zgłaszać synchronicznie.

Klasy pochodne, które wykonują operacje we/wy, powinny zastąpić tę metodę prawdziwie asynchroniczną implementacją, która honoruje token anulowania.

Dostawcy magazynu kluczy, którzy chcą używać enklaw z funkcją Always Encrypted , powinni zastąpić tę metodę prawdziwie asynchroniczną implementacją, gdy operacja podpisywania obejmuje operację we/wy.

Dotyczy