KeyVaultClient.WrapKeyWithHttpMessagesAsync Método

Definição

Namespace:

Microsoft.Azure.KeyVault

Assembly:

Microsoft.Azure.KeyVault.dll

Pacote:

Microsoft.Azure.KeyVault v3.0.5

Origem:

KeyVaultClient.cs

Encapsula uma chave simétrica usando uma chave especificada.

public System.Threading.Tasks.Task<Microsoft.Rest.Azure.AzureOperationResponse<Microsoft.Azure.KeyVault.Models.KeyOperationResult>> WrapKeyWithHttpMessagesAsync (string vaultBaseUrl, string keyName, string keyVersion, string algorithm, byte[] value, System.Collections.Generic.Dictionary<string,System.Collections.Generic.List<string>> customHeaders = default, System.Threading.CancellationToken cancellationToken = default);

abstract member WrapKeyWithHttpMessagesAsync : string * string * string * string * byte[] * System.Collections.Generic.Dictionary<string, System.Collections.Generic.List<string>> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Rest.Azure.AzureOperationResponse<Microsoft.Azure.KeyVault.Models.KeyOperationResult>>
override this.WrapKeyWithHttpMessagesAsync : string * string * string * string * byte[] * System.Collections.Generic.Dictionary<string, System.Collections.Generic.List<string>> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Rest.Azure.AzureOperationResponse<Microsoft.Azure.KeyVault.Models.KeyOperationResult>>

Public Function WrapKeyWithHttpMessagesAsync (vaultBaseUrl As String, keyName As String, keyVersion As String, algorithm As String, value As Byte(), Optional customHeaders As Dictionary(Of String, List(Of String)) = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of AzureOperationResponse(Of KeyOperationResult))

Parâmetros

vaultBaseUrl

String

O nome do cofre, por exemplo https://myvault.vault.azure.net, .

keyName

String

O nome da chave.

keyVersion

String

A versão da chave.

algorithm

String

identificador de algoritmo. Os valores possíveis incluem: 'RSA-OAEP', 'RSA-OAEP-256', 'RSA1_5'

value

Byte[]

customHeaders

Dictionary<String,List<String>>

Cabeçalhos que serão adicionados à solicitação.

cancellationToken

CancellationToken

O token de cancelamento.

Retornos

Task<AzureOperationResponse<KeyOperationResult>>

Implementações

WrapKeyWithHttpMessagesAsync(String, String, String, String, Byte[], Dictionary<String,List<String>>, CancellationToken)

Exceções

KeyVaultErrorException

Gerada quando a operação retornou um código de status inválido

SerializationException

Gerada quando não é possível desserializar a resposta

ValidationException

Gerado quando um parâmetro necessário é nulo

ArgumentNullException

Gerado quando um parâmetro necessário é nulo

Comentários

A operação WRAP oferece suporte à criptografia de uma chave simétrica usando uma chave de criptografia de chaves que foi armazenada anteriormente em um Cofre de Chaves do Azure. A operação WRAP só é estritamente necessária para chaves simétricas armazenadas no Cofre de Chaves do Azure, uma vez que a proteção com uma chave assimétrica pode ser realizada usando a parte pública da chave. Essa operação tem suporte para chaves assimétricas como uma conveniência para chamadores que tem uma chave de referência, mas não tem acesso ao material de chave público. Esta operação requer a permissão keys/wrapKey.