wrap Key - wrap Key

Reference

Služba:: Key Vault

Verze rozhraní API:: 7.4

Zalomí symetrický klíč pomocí zadaného klíče.
Operace WRAP podporuje šifrování symetrického klíče pomocí šifrovacího klíče klíče, který byl dříve uložen v azure Key Vault. Operace WRAP je nezbytně nutná pouze pro symetrické klíče uložené v Azure Key Vault, protože ochranu asymetrickým klíčem je možné provést pomocí veřejné části klíče. Tato operace se podporuje u asymetrických klíčů jako usnadnění pro volající, kteří mají odkaz na klíč, ale nemají přístup k materiálům veřejného klíče. Tato operace vyžaduje oprávnění keys/wrapKey.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
key-name	path	True	string	Název klíče.
key-version	path	True	string	Verze klíče.
vaultBaseUrl	path	True	string	Název trezoru, například https://myvault.vault.azure.net.
api-version	query	True	string	Verze klientského rozhraní API

Text požadavku

Name	Vyžadováno	Typ	Description
alg	True	JsonWebKeyEncryptionAlgorithm	identifikátor algoritmu
value	True	string
aad		string	Další data k ověření, ale ne šifrování/dešifrování při použití ověřených kryptografických algoritmů
iv		string	Kryptograficky náhodný, neopakující se inicializační vektor pro symetrické algoritmy.
tag		string	Značka, která se má ověřit při dešifrování pomocí ověřeného algoritmu.

Odpovědi

Name	Typ	Description
200 OK	KeyOperationResult	Zabalený symetrický klíč.
Other Status Codes	KeyVaultError	Key Vault chybovou odpověď popisující příčinu selhání operace.

Příklady

Wrapkey

Ukázkový požadavek

HTTP

POST https://myvault.vault.azure.net//keys/sdktestkey/0698c2156c1a4e1da5b6bab6f6422fd6/wrapkey?api-version=7.4

{
  "alg": "RSA1_5",
  "value": "ovQIlbB0DgWhZA7sgkPxbg9H-Ly-VlNGPSgGrrZvlIo"
}

Ukázková odpověď

Stavový kód:: 200

{
  "kid": "https://myvault.vault.azure.net/keys/sdktestkey/0698c2156c1a4e1da5b6bab6f6422fd6",
  "value": "khwIe26NuAZazS7upywDBpGRmRNMW5-4h_JQKxOdB78nYVxZWnBXwCxOv7a3Sr_mCjiVzKsoQQZwL-CJzhYa0512tfYem56zls5a44y5QsdcfvuSzOvpthVhA9XkEfCJSqSY_sip5d8BelT_w_ikvd_8KqiQ_0H54RqYUN8svCpu28paHgBocHFNXTQ9NtU9ec2qgESXk7Jp4OTy9HJtQJavKDUqTJ3YmtLxUgsgBCe0FNMHUSEYC0Ys6PavYzdTwIzYCq84idmAxJOj-O_6eALJFH2sDTOQYHjzOae2t8eFmw6C-t55qjrCI91a9mUJEGPhYixiG4gR4PaEJ7wGvw"
}

Definice

Name	Description
Error	Chyba serveru trezoru klíčů.
JsonWebKeyEncryptionAlgorithm	identifikátor algoritmu
KeyOperationResult	Výsledek klíčové operace.
KeyOperationsParameters	Klíčové parametry operací.
KeyVaultError	Výjimka chyby trezoru klíčů

Error

Chyba serveru trezoru klíčů.

Name	Typ	Description
code	string	Kód chyby
innererror	Error	Chyba serveru trezoru klíčů.
message	string	Chybová zpráva

JsonWebKeyEncryptionAlgorithm

identifikátor algoritmu

Name	Typ	Description
A128CBC	string
A128CBCPAD	string
A128GCM	string
A128KW	string
A192CBC	string
A192CBCPAD	string
A192GCM	string
A192KW	string
A256CBC	string
A256CBCPAD	string
A256GCM	string
A256KW	string
RSA-OAEP	string
RSA-OAEP-256	string
RSA1_5	string

KeyOperationResult

Výsledek klíčové operace.

Name	Typ	Description
aad	string
iv	string
kid	string	Identifikátor klíče
tag	string
value	string

KeyOperationsParameters

Klíčové parametry operací.

Name	Typ	Description
aad	string	Další data k ověření, ale ne šifrování/dešifrování při použití ověřených kryptografických algoritmů
alg	JsonWebKeyEncryptionAlgorithm	identifikátor algoritmu
iv	string	Kryptograficky náhodný, neopakující se inicializační vektor pro symetrické algoritmy.
tag	string	Značka, která se má ověřit při dešifrování pomocí ověřeného algoritmu.
value	string

KeyVaultError

Výjimka chyby trezoru klíčů

Name	Typ	Description
error	Error	Chyba serveru trezoru klíčů.

Sdílet prostřednictvím