Import Certificate - Import Certificate

Referencia

Service:: Key Vault

API Version:: 7.4

Tanúsítvány importálása egy megadott kulcstartóba.
Importál egy meglévő, titkos kulcsot tartalmazó érvényes tanúsítványt az Azure Key Vault. Ehhez a művelethez a tanúsítványokra/importálásra vonatkozó engedély szükséges. Az importálandó tanúsítvány LEHET PFX vagy PEM formátumú. Ha a tanúsítvány PEM formátumban van, a PEM-fájlnak tartalmaznia kell a kulcsot és az x509-tanúsítványokat. Key Vault csak PKCS#8 formátumú kulcsot fogad el.

POST {vaultBaseUrl}/certificates/{certificate-name}/import?api-version=7.4

URI-paraméterek

Name In Kötelező Típus Description

Name	In	Kötelező	Típus	Description
certificate-name	path	True	string	A tanúsítvány neve. A megadott érték globálisan másolható a szolgáltatás futtatása céljából. A megadott érték nem tartalmazhat személyazonosításra alkalmas vagy bizalmas adatokat. Regex pattern: `^[0-9a-zA-Z-]+$`
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.

certificate-name

path

True

string

A tanúsítvány neve. A megadott érték globálisan másolható a szolgáltatás futtatása céljából. A megadott érték nem tartalmazhat személyazonosításra alkalmas vagy bizalmas adatokat.

Regex pattern: ^[0-9a-zA-Z-]+$

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
value	True	string	Az importálni kívánt tanúsítványobjektum Base64 kódolású ábrázolása. A tanúsítványnak tartalmaznia kell a titkos kulcsot.
attributes		CertificateAttributes	A tanúsítvány attribútumai (nem kötelező).
policy		CertificatePolicy	A tanúsítvány felügyeleti szabályzata.
pwd		string	Ha a base64EncodedCertificate titkos kulcsa titkosítva van, a titkosításhoz használt jelszó.
tags		object	Alkalmazásspecifikus metaadatok kulcs-érték párok formájában.

Válaszok

Name	Típus	Description
200 OK	CertificateBundle	Importált tanúsítványcsomag a tárolóba.
Other Status Codes	KeyVaultError	Key Vault hibaválasz, amely leírja, hogy a művelet miért hiúsult meg.

Példák

ImportCertificate

Sample Request

HTTP

POST https://myvault.vault.azure.net//certificates/importCert01/import?api-version=7.4

{
  "value": "MIIJ...",
  "pwd": "123",
  "policy": {
    "key_props": {
      "exportable": true,
      "kty": "RSA",
      "key_size": 2048,
      "reuse_key": false
    },
    "secret_props": {
      "contentType": "application/x-pkcs12"
    }
  }
}

Sample Response

Status code:: 200

{
  "id": "https://myvault.vault.azure.net/certificates/importCert01/f00e72f0ddee4dddadc27c0f605d84d7",
  "kid": "https://myvault.vault.azure.net/keys/importCert01/f00e72f0ddee4dddadc27c0f605d84d7",
  "sid": "https://myvault.vault.azure.net/secrets/importCert01/f00e72f0ddee4dddadc27c0f605d84d7",
  "x5t": "fLi3U52HunIVNXubkEnf8tP6Wbo",
  "cer": "MIIC...",
  "attributes": {
    "enabled": true,
    "nbf": 1430344421,
    "exp": 2208988799,
    "created": 1493938557,
    "updated": 1493938557,
    "recoveryLevel": "Recoverable+Purgeable"
  },
  "policy": {
    "id": "https://myvault.vault.azure.net/certificates/importCert01/policy",
    "key_props": {
      "exportable": true,
      "kty": "RSA",
      "key_size": 2048,
      "reuse_key": false
    },
    "secret_props": {
      "contentType": "application/x-pkcs12"
    },
    "x509_props": {
      "subject": "CN=KeyVaultTest",
      "ekus": [],
      "key_usage": [],
      "validity_months": 297
    },
    "lifetime_actions": [
      {
        "trigger": {
          "lifetime_percentage": 80
        },
        "action": {
          "action_type": "EmailContacts"
        }
      }
    ],
    "issuer": {
      "name": "Unknown"
    },
    "attributes": {
      "enabled": true,
      "created": 1493938557,
      "updated": 1493938557
    }
  }
}

Definíciók

Name	Description
Action	A végrehajtandó művelet.
CertificateAttributes	A tanúsítványkezelési attribútumok.
CertificateBundle	A tanúsítványcsomag egy tanúsítványból (X509) és attribútumaiból áll.
CertificateImportParameters	A tanúsítványimportálási paraméterek.
CertificatePolicy	Tanúsítvány felügyeleti szabályzata.
CertificatePolicyAction	A művelet típusa.
DeletionRecoveryLevel	Az aktuális tárolóban lévő tanúsítványok törlési helyreállítási szintjét tükrözi. Ha a "Helyreállítható" értéket tartalmazza, a tanúsítványt véglegesen törölheti egy kiemelt felhasználó; ellenkező esetben csak a rendszer törölheti a tanúsítványt a megőrzési időköz végén.
Error	A Key Vault-kiszolgáló hibája.
IssuerParameters	A tanúsítvány X509-összetevőjének kiállítójának paraméterei.
JsonWebKeyCurveName	Elliptikus görbe neve. Érvényes értékekért lásd: JsonWebKeyCurveName.
JsonWebKeyType	A tanúsítványhoz használandó kulcspár típusa.
KeyProperties	A tanúsítványt alátámasztó kulcspár tulajdonságai.
KeyUsageType	Meghatározza a tanúsítvány kulcsának használatát.
KeyVaultError	A key vault hibakivétele.
LifetimeAction	Művelet és annak eseményindítója, amelyet Key Vault hajt végre egy tanúsítvány élettartama során.
SecretProperties	A tanúsítványt alátámasztó kulcs tulajdonságai.
SubjectAlternativeNames	Egy X509-objektum tulajdonosának alternatív nevei.
Trigger	A művelet végrehajtásához teljesítendő feltétel.
X509CertificateProperties	A tanúsítvány X509-összetevőjének tulajdonságai.

Action

A végrehajtandó művelet.

Name	Típus	Description
action_type	CertificatePolicyAction	A művelet típusa.

CertificateAttributes

A tanúsítványkezelési attribútumok.

Name	Típus	Description
created	integer	Létrehozás időpontja UTC-ben.
enabled	boolean	Meghatározza, hogy az objektum engedélyezve van-e.
exp	integer	Lejárati dátum UTC-ben.
nbf	integer	Dátum előtt nem UTC-ben.
recoverableDays	integer	softDelete adatmegőrzési napok. Ha a softDelete engedélyezve van >, akkor az érték =7 és <=90 lehet, ellenkező esetben 0.
recoveryLevel	DeletionRecoveryLevel	Az aktuális tárolóban lévő tanúsítványok törlési helyreállítási szintjét tükrözi. Ha a "Helyreállítható" értéket tartalmazza, a tanúsítványt véglegesen törölheti egy kiemelt felhasználó; ellenkező esetben csak a rendszer törölheti a tanúsítványt a megőrzési időköz végén.
updated	integer	Utolsó frissítés időpontja UTC-ben.

CertificateBundle

A tanúsítványcsomag egy tanúsítványból (X509) és attribútumaiból áll.

Name	Típus	Description
attributes	CertificateAttributes	A tanúsítványattribútumok.
cer	string	Az x509-tanúsítvány CER-tartalma.
contentType	string	A titkos kód tartalomtípusa. például: "application/x-pem-file" vagy "application/x-pkcs12",
id	string	A tanúsítvány azonosítója.
kid	string	A kulcs azonosítója.
policy	CertificatePolicy	A felügyeleti szabályzat.
sid	string	A titkos azonosító.
tags	object	Alkalmazásspecifikus metaadatok kulcs-érték párok formájában
x5t	string	A tanúsítványhoz tartozó ujjlenyomat.

CertificateImportParameters

A tanúsítványimportálási paraméterek.

Name	Típus	Description
attributes	CertificateAttributes	A tanúsítvány attribútumai (nem kötelező).
policy	CertificatePolicy	A tanúsítvány felügyeleti szabályzata.
pwd	string	Ha a base64EncodedCertificate titkos kulcsa titkosítva van, a titkosításhoz használt jelszó.
tags	object	Alkalmazásspecifikus metaadatok kulcs-érték párok formájában.
value	string	Az importálni kívánt tanúsítványobjektum Base64 kódolású ábrázolása. A tanúsítványnak tartalmaznia kell a titkos kulcsot.

CertificatePolicy

Tanúsítvány felügyeleti szabályzata.

Name	Típus	Description
attributes	CertificateAttributes	A tanúsítványattribútumok.
id	string	A tanúsítvány azonosítója.
issuer	IssuerParameters	A tanúsítvány X509-összetevőjének kiállítójának paraméterei.
key_props	KeyProperties	A tanúsítványt alátámasztó kulcs tulajdonságai.
lifetime_actions	LifetimeAction[]	A Key Vault által a tanúsítvány élettartama során végrehajtandó műveletek.
secret_props	SecretProperties	A tanúsítványt tartalmazó titkos kód tulajdonságai.
x509_props	X509CertificateProperties	A tanúsítvány X509-összetevőjének tulajdonságai.

CertificatePolicyAction

A művelet típusa.

Name	Típus	Description
AutoRenew	string
EmailContacts	string

DeletionRecoveryLevel

Az aktuális tárolóban lévő tanúsítványok törlési helyreállítási szintjét tükrözi. Ha a "Helyreállítható" értéket tartalmazza, a tanúsítványt véglegesen törölheti egy kiemelt felhasználó; ellenkező esetben csak a rendszer törölheti a tanúsítványt a megőrzési időköz végén.

Name	Típus	Description
CustomizedRecoverable	string	Olyan tárolóállapotot jelöl, amelyben a törlés helyreállítható anélkül, hogy azonnali és végleges törlésre van lehetőség (azaz törlés, ha 7< = SoftDeleteRetentionInDays < 90). Ez a szint garantálja a törölt entitás helyreállíthatóságát a megőrzési időköz alatt, és amíg az előfizetés továbbra is elérhető.
CustomizedRecoverable+ProtectedSubscription	string	Azt a tárolót és előfizetési állapotot jelöli, amelyben a törlés helyreállítható, az azonnali és végleges törlés (azaz a végleges törlés) nem engedélyezett, és amelyben maga az előfizetés nem mondható le véglegesen, ha 7<= SoftDeleteRetentionInDays < 90. Ez a szint garantálja a törölt entitás helyreállíthatóságát a megőrzési időköz alatt, és azt is tükrözi, hogy maga az előfizetés nem mondható le.
CustomizedRecoverable+Purgeable	string	Azt a tárolóállapotot jelöli, amelyben a törlés helyreállítható, és amely lehetővé teszi az azonnali és végleges törlést is (azaz a törlést, amikor 7< = SoftDeleteRetentionInDays < 90). Ez a szint garantálja a törölt entitás helyreállíthatóságát a megőrzési időtartam alatt, kivéve, ha törlési műveletet kérnek, vagy az előfizetést lemondják.
Purgeable	string	Olyan tárolóállapotot jelöl, amelyben a törlés visszafordíthatatlan művelet, a helyreállítás lehetősége nélkül. Ez a szint nem felel meg a Törlés művelet elleni védelemnek; az adatok helyrehozhatatlanul elvesznek egy törlési művelet entitásszinten vagy magasabb szinten (tároló, erőforráscsoport, előfizetés stb.) elfogadásakor.
Recoverable	string	Olyan tárolóállapotot jelöl, amelyben a törlés helyreállítható anélkül, hogy azonnali és végleges törlésre (azaz végleges törlésre) van lehetőség. Ez a szint garantálja a törölt entitás helyreállíthatóságát a megőrzési időköz (90 nap) alatt, és amíg az előfizetés továbbra is elérhető. A rendszer 90 nap elteltével véglegesen törli, ha nem állítható helyre
Recoverable+ProtectedSubscription	string	Azt a tárolót és előfizetési állapotot jelöli, amelyben a törlés helyreállítható a megőrzési időtartamon belül (90 nap), az azonnali és végleges törlés (azaz végleges törlés) nem engedélyezett, és amelyben maga az előfizetés nem mondható le véglegesen. A rendszer 90 nap elteltével véglegesen törli, ha nem állítható helyre
Recoverable+Purgeable	string	Olyan tárolóállapotot jelöl, amelyben a törlés helyreállítható, és amely lehetővé teszi az azonnali és végleges törlést (azaz a végleges törlést). Ez a szint garantálja a törölt entitás helyreállíthatóságát a megőrzési időtartam alatt (90 nap), kivéve, ha törlési műveletet kérnek, vagy az előfizetést lemondják. A rendszer 90 nap elteltével véglegesen törli, ha nem állítható helyre

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.

IssuerParameters

A tanúsítvány X509-összetevőjének kiállítójának paraméterei.

Name	Típus	Description
cert_transparency	boolean	Azt jelzi, hogy az ebben a szabályzatban létrehozott tanúsítványokat közzé kell-e tenni a tanúsítvány áttetszőségi naplóiban.
cty	string	A szolgáltató által támogatott tanúsítványtípus (nem kötelező); például "OV-SSL", "EV-SSL"
name	string	A hivatkozott kiállítóobjektum vagy fenntartott nevek neve; például az "Ön" vagy az "Ismeretlen".

JsonWebKeyCurveName

Elliptikus görbe neve. Érvényes értékekért lásd: JsonWebKeyCurveName.

Name	Típus	Description
P-256	string
P-256K	string
P-384	string
P-521	string

JsonWebKeyType

A tanúsítványhoz használandó kulcspár típusa.

Name	Típus	Description
EC	string
EC-HSM	string
RSA	string
RSA-HSM	string
oct	string
oct-HSM	string

KeyProperties

A tanúsítványt alátámasztó kulcspár tulajdonságai.

Name	Típus	Description
crv	JsonWebKeyCurveName	Elliptikus görbe neve. Érvényes értékekért lásd: JsonWebKeyCurveName.
exportable	boolean	Azt jelzi, hogy exportálható-e a titkos kulcs. Az exportálható kulcs első verziójának létrehozásakor kiadási szabályzatot kell megadni.
key_size	integer	A kulcs mérete bitekben. Például: 2048, 3072 vagy 4096 RSA esetén.
kty	JsonWebKeyType	A tanúsítványhoz használandó kulcspár típusa.
reuse_key	boolean	Azt jelzi, hogy ugyanazt a kulcspárt használja-e a rendszer a tanúsítványmegújításhoz.

KeyUsageType

Meghatározza a tanúsítvány kulcsának használatát.

Name	Típus	Description
cRLSign	string
dataEncipherment	string
decipherOnly	string
digitalSignature	string
encipherOnly	string
keyAgreement	string
keyCertSign	string
keyEncipherment	string
nonRepudiation	string

KeyVaultError

A key vault hibakivétele.

Name	Típus	Description
error	Error	A Key Vault-kiszolgáló hibája.

LifetimeAction

Művelet és annak eseményindítója, amelyet Key Vault hajt végre egy tanúsítvány élettartama során.

Name	Típus	Description
action	Action	A végrehajtandó művelet.
trigger	Trigger	A műveletet végrehajtó feltétel.

SecretProperties

A tanúsítványt alátámasztó kulcs tulajdonságai.

Name	Típus	Description
contentType	string	Az adathordozó típusa (MIME-típus).

SubjectAlternativeNames

Egy X509-objektum tulajdonosának alternatív nevei.

Name	Típus	Description
dns_names	string[]	Tartománynevek.
emails	string[]	Email címeket.
upns	string[]	Egyszerű felhasználónevek.

Trigger

A művelet végrehajtásához teljesítendő feltétel.

Name	Típus	Description
days_before_expiry	integer	A megújítás megkísérléséhez a lejárat előtt napokat kell elvégezni. Az értéknek 1 és validity_in_months között kell lennie, 27-sel megszorozva. Ha validity_in_months 36, akkor az értéknek 1 és 972 között kell lennie (36 * 27).
lifetime_percentage	integer	Az aktiválandó élettartam százalékos aránya. Az értéknek 1 és 99 között kell lennie.

X509CertificateProperties

A tanúsítvány X509-összetevőjének tulajdonságai.

Name	Típus	Description
ekus	string[]	A továbbfejlesztett kulcshasználat.
key_usage	KeyUsageType[]	Meghatározza a tanúsítvány kulcsának használatát.
sans	SubjectAlternativeNames	A tulajdonos alternatív nevei.
subject	string	A tulajdonos neve. Érvényes X509 megkülönböztető névnek kell lennie.
validity_months	integer	A tanúsítvány hónapokban érvényes időtartama.

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

Import Certificate - Import Certificate

URI-paraméterek

Kérelem törzse

Válaszok

Példák

ImportCertificate

Sample Request

Sample Response

Definíciók

Action

CertificateAttributes

CertificateBundle

CertificateImportParameters

CertificatePolicy

CertificatePolicyAction

DeletionRecoveryLevel

Error

IssuerParameters

JsonWebKeyCurveName

JsonWebKeyType

KeyProperties

KeyUsageType

KeyVaultError

LifetimeAction

SecretProperties

SubjectAlternativeNames

Trigger

X509CertificateProperties

További források