HSM Security Domain - Transfer Key

Hizmet:

Key Vault

API Sürümü:

2025-07-01

Güvenlik Etki Alanı transfer anahtarını al

GET {vaultBaseUrl}/securitydomain/upload?api-version=2025-07-01

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
vaultBaseUrl	path	True	string (uri)
api-version	query	True	string minLength: 1	Bu işlem için kullanılacak API sürümü.

Yanıtlar

Name	Tür	Description
200 OK	TransferKey	İstek başarılı oldu.
Other Status Codes	KeyVaultError	Beklenmeyen bir hata yanıtı.

Güvenlik

OAuth2Auth

Tür: oauth2
Akış: implicit
Yetkilendirme URL’si: https://login.microsoftonline.com/common/oauth2/authorize

Kapsamlar

Name	Description
https://vault.azure.net/.default

Örnekler

Retrieve Security Domain transfer key

Örnek isteği

HTTP

GET https://myvault.vault.azure.net//securitydomain/upload?api-version=2025-07-01

Örnek yanıt

Durum kodu:

200

{
  "key_format": "jwk",
  "transfer_key": {
    "kid": "https://myvault.vault.azure.net/transfer_key",
    "kty": "RSA",
    "key_ops": [
      "encrypt"
    ],
    "n": "2HJAE5fU3Cw2Rt9hEuq-F6XjINKGa-zskfISVqopqUy60GOs2eyhxbWbJBeUXNor_gf-tXtNeuqeBgitLeVa640UDvnEjYTKWjCniTxZRaU7ewY8BfTSk-7KxoDdLsPSpX_MX4rwlAx-_1UGk5t4sQgTbm9T6Fm2oqFd37dsz5-Gj27UP2GTAShfJPFD7MqU_zIgOI0pfqsbNL5xTQVM29K6rX4jSPtylZV3uWJtkoQIQnrIHhk1d0SC0KwlBV3V7R_LVYjiXLyIXsFzSNYgQ68ZjAwt8iL7I8Osa-ehQLM13DVvLASaf7Jnu3sC3CWl3Gyirgded6cfMmswJzY87w",
    "e": "AQAB",
    "alg": "RSA-OAEP-256",
    "x5c": [
      "MIIEnTCCBAgIBATANBgkAoWgAwIqhkiG9w0BAQsFADAQMQ4wDAYDVQQDDAVjZXJ0QTAeFw0yMDA0MjYwM/mivTQ26aDwb1Pd8h+SGcgJNy1VOnmI5+uvgfh9Qj6glJZHEyvh6dat6f4DDTwRVf6Vvc5noB/yiilaMj1GPW0Bwg5u5atZcjzTb6wOFYOGd2Y1WFBwQqqxriWo62Fp/TO5+kQigYkgVZXcPjbm2c0hdkisPt+APqEdMotmYTANxtC6McP+9KOO8+12K2fj2a9NEhRJOboGQeZ0M7DJoQDl4wg8f2nswxH/36Vfc5ad+nxRYwYObRYfgOh8vpYaw3cpj5+UHBaPQ8ZiQNDoWHJWvX5z1nTmCc2NmLHdi3ijkoc7AKHIv/ZX7qbNhv11a76gJRi/IoHkcf1UTpxCoD+eTbo8Isxt4c9fBTk1vS4wSGsJCewxcyMlTB9FHufPM8k5Uz/ZCOrc+RoaznKPGamgMJOOwbPE1WcBnxuG4rQcskdCa59NiZXyZsx5vsCAwEAAaMCMAAwDQYJKoZIhvcNAQELBQADggIBAAjHy9GCPejDYIVb/iv8Wo40n317LQN7H6ay+YB5L2byEQATvC1ixde6VqwU6k9VdoQOTfP3xJhfstKrO+n5mFJBL4KG8BZBbd6XQu/ggPLKEIVZFbeQkX6o03K54gY8GxYjHr6gF12I6heLWVKA/Qi480GqSlp2Nz+LE1jgPp9u52xpUPjsvRHXtxYZ7Q3O2jhPToNr3D/TZSu3tmQOeqj9M/igLDe9TxqN9C9jraUGR7Lr4zN1srtvIKhxGMS3Q9kC4Mq+ZNNIwC9+jzzd8fB2pGJP/iTFDzB0pDh9Jz0/CR4O4aGoYqkQEx629aZH2TzhOh2yf04TaniwkHXnUEsPTxrpY8ty/OUG3HzBMHCDhS08ZSimrrxhiWyH6g0OEglXVGrI2nH6nnQIn1MTNILcjUTMRt/WSOz6G07oZciAouKD2YS/W1qPap600kGhTya81BuYThGmFoXVMs7Mk3XBzZ81b6hJ6ncwCLb3g4YzqeQ8bOf42jYJctq4tPNaXTfoC7N0FX7lPVJpRdh6BFcHYcg0NPWJsdk6LtSJB6bp2qptRAgJ5S94s843FRd8PRFE10TKDfj3YFRBNkx7qDjwUhtN8/JC9+RHHw0Ngd0x2/BLqeCEMAQaJoC53h0aMLW6PSyovnsLvdJbN/rYc15qUXSz8TtjaHFpjsy/Fo5H"
    ],
    "x5t": "dJKBile6IJDrRGqa3k5d8_IKFdI",
    "x5t#S256": "gIBQCTDDN"
  }
}

Tanımlar

Name	Description
Error
KeyVaultError	Anahtar kasası hata özel durumu.
SecurityDomainJsonWebKey	Güvenlik etki alanı işleminde kullanılmak üzere bir JSON Web Anahtarı (JWK).
TransferKey	Güvenlik Etki Alanı transfer anahtarı.

Error

Object

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

KeyVaultError

Object

Anahtar kasası hata özel durumu.

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

SecurityDomainJsonWebKey

Object

Güvenlik etki alanı işleminde kullanılmak üzere bir JSON Web Anahtarı (JWK).

Name	Tür	Description
alg	string	Anahtarla kullanılmak üzere tasarlanmış algoritma.
e	string	RSA genel üssü.
key_ops	string[]	Desteklenen temel işlemler.
kid	string	Anahtar tanımlayıcısı.
kty	string	JsonWebKey Anahtar Türü (kty), içinde https://tools.ietf.org/html/draft-ietf-jose-json-web-algorithms-40tanımlandığı gibi. Security Domain için bu değer RSA olmalıdır.
n	string	RSA modülü.
use	string	Ortak Anahtar Kullanım Parametresi. Bu isteğe bağlıdır ve varsa enc olmalıdır.
x5c	string[]	X509 sertifika zinciri parametresi.
x5t	string	X509 sertifikası SHA1 parmak izi. Bu isteğe bağlıdır.
x5t#S256	string	X509 sertifikası SHA256 parmak izi.

TransferKey

Object

Güvenlik Etki Alanı transfer anahtarı.

Name	Tür	Default value	Description
key_format	string	jwk	Aktarma anahtarının biçimini belirtir.
transfer_key	SecurityDomainJsonWebKey		Aktarım anahtarını JWK biçiminde belirtir.