wrap Key - wrap Key
Szimmetrikus kulcs burkolása egy megadott kulccsal.
A WRAP művelet támogatja a szimmetrikus kulcs titkosítását olyan kulcstitkosítási kulccsal, amelyet korábban egy Azure-Key Vault tároltak. A WRAP művelet csak az Azure-Key Vault tárolt szimmetrikus kulcsokhoz szükséges, mivel az aszimmetrikus kulccsal történő védelem a kulcs nyilvános részével végezhető el. Ezt a műveletet az aszimmetrikus kulcsok támogatják a kulcshivatkozással rendelkező hívók kényelmeként, de nem férnek hozzá a nyilvános kulcsok anyagához. Ehhez a művelethez kulcsok/wrapKey engedély szükséges.
POST {vaultBaseUrl}/keys/{key-name}/{key-version}/wrapkey?api-version=7.4
URI-paraméterek
Name | In | Kötelező | Típus | Description |
---|---|---|---|---|
key-name
|
path | True |
string |
A kulcs neve. |
key-version
|
path | True |
string |
A kulcs verziója. |
vault
|
path | True |
string |
A tároló neve, például https://myvault.vault.azure.net: . |
api-version
|
query | True |
string |
Ügyfél API-verziója. |
Kérelem törzse
Name | Kötelező | Típus | Description |
---|---|---|---|
alg | True |
algoritmus azonosítója |
|
value | True |
string |
|
aad |
string |
A hitelesített titkosítási algoritmusok használatakor további adatok hitelesítésére, de titkosításra/visszafejtésére nem. |
|
iv |
string |
Kriptográfiailag véletlenszerű, nem ismétlődő inicializálási vektor szimmetrikus algoritmusokhoz. |
|
tag |
string |
A hitelesített algoritmussal végzett visszafejtés során hitelesítendő címke. |
Válaszok
Name | Típus | Description |
---|---|---|
200 OK |
A burkolt szimmetrikus kulcs. |
|
Other Status Codes |
Key Vault hibaválasz leírja, hogy miért hiúsult meg a művelet. |
Példák
Wrapkey
Sample Request
POST https://myvault.vault.azure.net//keys/sdktestkey/0698c2156c1a4e1da5b6bab6f6422fd6/wrapkey?api-version=7.4
{
"alg": "RSA1_5",
"value": "ovQIlbB0DgWhZA7sgkPxbg9H-Ly-VlNGPSgGrrZvlIo"
}
Sample Response
{
"kid": "https://myvault.vault.azure.net/keys/sdktestkey/0698c2156c1a4e1da5b6bab6f6422fd6",
"value": "khwIe26NuAZazS7upywDBpGRmRNMW5-4h_JQKxOdB78nYVxZWnBXwCxOv7a3Sr_mCjiVzKsoQQZwL-CJzhYa0512tfYem56zls5a44y5QsdcfvuSzOvpthVhA9XkEfCJSqSY_sip5d8BelT_w_ikvd_8KqiQ_0H54RqYUN8svCpu28paHgBocHFNXTQ9NtU9ec2qgESXk7Jp4OTy9HJtQJavKDUqTJ3YmtLxUgsgBCe0FNMHUSEYC0Ys6PavYzdTwIzYCq84idmAxJOj-O_6eALJFH2sDTOQYHjzOae2t8eFmw6C-t55qjrCI91a9mUJEGPhYixiG4gR4PaEJ7wGvw"
}
Definíciók
Name | Description |
---|---|
Error |
A Key Vault-kiszolgáló hibája. |
Json |
algoritmus azonosítója |
Key |
A kulcsművelet eredménye. |
Key |
A fő műveleti paraméterek. |
Key |
A Key Vault hibakivétele. |
Error
A Key Vault-kiszolgáló hibája.
Name | Típus | Description |
---|---|---|
code |
string |
A hibakód. |
innererror |
A Key Vault-kiszolgáló hibája. |
|
message |
string |
A hibaüzenet. |
JsonWebKeyEncryptionAlgorithm
algoritmus azonosítója
Name | Típus | 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
A kulcsművelet eredménye.
Name | Típus | Description |
---|---|---|
aad |
string |
|
iv |
string |
|
kid |
string |
Kulcsazonosító |
tag |
string |
|
value |
string |
KeyOperationsParameters
A fő műveleti paraméterek.
Name | Típus | Description |
---|---|---|
aad |
string |
A hitelesített titkosítási algoritmusok használatakor további adatok hitelesítésére, de titkosításra/visszafejtésére nem. |
alg |
algoritmus azonosítója |
|
iv |
string |
Kriptográfiailag véletlenszerű, nem ismétlődő inicializálási vektor szimmetrikus algoritmusokhoz. |
tag |
string |
A hitelesített algoritmussal végzett visszafejtés során hitelesítendő címke. |
value |
string |
KeyVaultError
A Key Vault hibakivétele.
Name | Típus | Description |
---|---|---|
error |
A Key Vault-kiszolgáló hibája. |