wrap Key - wrap Key

Başvuru

Service:: Key Vault

API Version:: 7.4

Belirtilen anahtarı kullanarak simetrik anahtarı sarmalar.
WRAP işlemi, daha önce Azure Key Vault depolanan bir anahtar şifreleme anahtarı kullanılarak simetrik anahtarın şifrelenmesini destekler. Wrap işlemi yalnızca Azure Key Vault depolanan simetrik anahtarlar için kesinlikle gereklidir çünkü asimetrik anahtarla koruma anahtarın ortak bölümü kullanılarak gerçekleştirilebilir. Bu işlem, anahtar başvurusu olan ancak ortak anahtar malzemesine erişimi olmayan arayanlar için kolaylık sağlamak amacıyla asimetrik anahtarlar için desteklenir. Bu işlem anahtarlar/wrapKey izni gerektirir.

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

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
key-name	path	True	string	Anahtarın adı.
key-version	path	True	string	Anahtarın sürümü.
vaultBaseUrl	path	True	string	Kasa adı, örneğin https://myvault.vault.azure.net.
api-version	query	True	string	İstemci API sürümü.

İstek Gövdesi

Name	Gerekli	Tür	Description
alg	True	JsonWebKeyEncryptionAlgorithm	algoritma tanımlayıcısı
value	True	string
aad		string	Kimliği doğrulanmış şifreleme algoritmaları kullanılırken kimlik doğrulaması için ek veriler kullanılır ancak şifrelenmez/şifresi çözülemez.
iv		string	Simetrik algoritmalar için kriptografik olarak rastgele, yinelenmeyen başlatma vektörleri.
tag		string	Kimliği doğrulanmış bir algoritmayla şifre çözme gerçekleştirirken kimlik doğrulaması için kullanılan etiket.

Yanıtlar

Name	Tür	Description
200 OK	KeyOperationResult	Sarmalanmış simetrik anahtar.
Other Status Codes	KeyVaultError	İşlemin neden başarısız olduğunu açıklayan hata yanıtı Key Vault.

Örnekler

Wrapkey

Sample Request

HTTP

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

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

Sample Response

Status code:: 200

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

Tanımlar

Name	Description
Error	Anahtar kasası sunucusu hatası.
JsonWebKeyEncryptionAlgorithm	algoritma tanımlayıcısı
KeyOperationResult	Anahtar işlemi sonucu.
KeyOperationsParameters	Anahtar işlemleri parametreleri.
KeyVaultError	Anahtar kasası hata özel durumu.

Error

Anahtar kasası sunucusu hatası.

Name	Tür	Description
code	string	Hata kodu.
innererror	Error	Anahtar kasası sunucusu hatası.
message	string	Hata iletisi.

JsonWebKeyEncryptionAlgorithm

algoritma tanımlayıcısı

Name	Tür	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

Anahtar işlemi sonucu.

Name	Tür	Description
aad	string
iv	string
kid	string	Anahtar tanımlayıcısı
tag	string
value	string

KeyOperationsParameters

Anahtar işlemleri parametreleri.

Name	Tür	Description
aad	string	Kimliği doğrulanmış şifreleme algoritmaları kullanılırken kimlik doğrulaması için ek veriler kullanılır ancak şifrelenmez/şifresi çözülemez.
alg	JsonWebKeyEncryptionAlgorithm	algoritma tanımlayıcısı
iv	string	Simetrik algoritmalar için kriptografik olarak rastgele, yinelenmeyen başlatma vektörleri.
tag	string	Kimliği doğrulanmış bir algoritmayla şifre çözme gerçekleştirirken kimlik doğrulaması için kullanılan etiket.
value	string

KeyVaultError

Anahtar kasası hata özel durumu.

Name	Tür	Description
error	Error	Anahtar kasası sunucusu hatası.

Aracılığıyla paylaş