Megosztás a következőn keresztül:


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.

vaultBaseUrl
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

JsonWebKeyEncryptionAlgorithm

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

KeyOperationResult

A burkolt szimmetrikus kulcs.

Other Status Codes

KeyVaultError

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.

JsonWebKeyEncryptionAlgorithm

algoritmus azonosítója

KeyOperationResult

A kulcsművelet eredménye.

KeyOperationsParameters

A fő műveleti paraméterek.

KeyVaultError

A Key Vault hibakivétele.

Error

A Key Vault-kiszolgáló hibája.

Name Típus Description
code

string

A hibakód.

innererror

Error

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

JsonWebKeyEncryptionAlgorithm

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

Error

A Key Vault-kiszolgáló hibája.