sign - sign

Riferimento

Service:: Key Vault

API Version:: 7.4

Crea una firma da un digest usando la chiave specificata.
L'operazione SIGN è applicabile alle chiavi asimmetriche e simmetriche archiviate in Azure Key Vault poiché questa operazione usa la parte privata della chiave. Questa operazione richiede l'autorizzazione chiavi/firma.

POST {vaultBaseUrl}/keys/{key-name}/{key-version}/sign?api-version=7.4

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
key-name	path	True	string	Nome della chiave.
key-version	path	True	string	Versione della chiave.
vaultBaseUrl	path	True	string	Nome dell'insieme di credenziali, ad esempio https://myvault.vault.azure.net.
api-version	query	True	string	Versione API client.

Corpo della richiesta

Nome	Necessario	Tipo	Descrizione
alg	True	JsonWebKeySignatureAlgorithm	Identificatore dell'algoritmo di firma/verifica. Per altre informazioni sui tipi di algoritmo possibili, vedere JsonWebKeySignatureAlgorithm.
value	True	string

Risposte

Nome	Tipo	Descrizione
200 OK	KeyOperationResult	Valore della firma.
Other Status Codes	KeyVaultError	Key Vault risposta di errore che descrive perché l'operazione non è riuscita.

Esempio

Sign

Sample Request

HTTP

POST https://myvault.vault.azure.net//keys/testkey/9885aa558e8d448789683188f8c194b0/sign?api-version=7.4

{
  "alg": "RS512",
  "value": "RUE3Nzg4NTQ4QjQ5RjFFN0U2NzAyQzhDNEMwMkJDOTA1MTYyOTUzNjI5NDhBNzZDQTlFOTM1NDA2M0ZGMjk2Mg"
}

Sample Response

Status code:: 200

{
  "kid": "https://myvault.vault.azure.net/keys/testkey/9885aa558e8d448789683188f8c194b0",
  "value": "aKFG8NXcfTzqyR44rW42484K_zZI_T7zZuebvWuNgAoEI1gXYmxrshp42CunSmmu4oqo4-IrCikPkNIBkHXnAW2cv03Ad0UpwXhVfepK8zzDBaJPMKVGS-ZRz8CshEyGDKaLlb3J3zEkXpM3RrSEr0mdV6hndHD_mznLB5RmFui5DsKAhez4vUqajgtkgcPfCekMqeSwp6r9ItVL-gEoAohx8XMDsPedqu-7BuZcBcdayaPuBRL4wWoTDULA11P-UN_sJ5qMj3BbiRYhIlBWGR04wIGfZ3pkJjHJUpOvgH2QajdYPzUBauOCewMYbq9XkLRSzI_A7HkkDVycugSeAA"
}

Definizioni

Nome	Descrizione
Error	Errore del server dell'insieme di credenziali delle chiavi.
JsonWebKeySignatureAlgorithm	Identificatore dell'algoritmo di firma/verifica. Per altre informazioni sui tipi di algoritmo possibili, vedere JsonWebKeySignatureAlgorithm.
KeyOperationResult	Risultato dell'operazione chiave.
KeySignParameters	Parametri delle operazioni chiave.
KeyVaultError	Eccezione di errore dell'insieme di credenziali delle chiavi.

Error

Errore del server dell'insieme di credenziali delle chiavi.

Nome	Tipo	Descrizione
code	string	Codice di errore.
innererror	Error	Errore del server dell'insieme di credenziali delle chiavi.
message	string	Messaggio di errore.

JsonWebKeySignatureAlgorithm

Identificatore dell'algoritmo di firma/verifica. Per altre informazioni sui tipi di algoritmo possibili, vedere JsonWebKeySignatureAlgorithm.

Nome	Tipo	Descrizione
ES256	string	ECDSA usando P-256 e SHA-256, come descritto in https://tools.ietf.org/html/rfc7518.
ES256K	string	ECDSA usando P-256K e SHA-256, come descritto in https://tools.ietf.org/html/rfc7518
ES384	string	ECDSA usando P-384 e SHA-384, come descritto in https://tools.ietf.org/html/rfc7518
ES512	string	ECDSA usando P-521 e SHA-512, come descritto in https://tools.ietf.org/html/rfc7518
PS256	string	RSASSA-PSS usando SHA-256 e MGF1 con SHA-256, come descritto in https://tools.ietf.org/html/rfc7518
PS384	string	RSASSA-PSS usando SHA-384 e MGF1 con SHA-384, come descritto in https://tools.ietf.org/html/rfc7518
PS512	string	RSASSA-PSS usando SHA-512 e MGF1 con SHA-512, come descritto in https://tools.ietf.org/html/rfc7518
RS256	string	RSASSA-PKCS1-v1_5 usando SHA-256, come descritto in https://tools.ietf.org/html/rfc7518
RS384	string	RSASSA-PKCS1-v1_5 usando SHA-384, come descritto in https://tools.ietf.org/html/rfc7518
RS512	string	RSASSA-PKCS1-v1_5 usando SHA-512, come descritto in https://tools.ietf.org/html/rfc7518
RSNULL	string	Riservato

KeyOperationResult

Risultato dell'operazione chiave.

Nome	Tipo	Descrizione
aad	string
iv	string
kid	string	Identificatore chiave
tag	string
value	string

KeySignParameters

Parametri delle operazioni chiave.

Nome	Tipo	Descrizione
alg	JsonWebKeySignatureAlgorithm	Identificatore dell'algoritmo di firma/verifica. Per altre informazioni sui tipi di algoritmo possibili, vedere JsonWebKeySignatureAlgorithm.
value	string

KeyVaultError

Eccezione di errore dell'insieme di credenziali delle chiavi.

Nome	Tipo	Descrizione
error	Error	Errore del server dell'insieme di credenziali delle chiavi.

Share via