Dps Certificate - Verify Certificate

Referencia

Szolgáltatás:: IoT Hub Device Provisioning Service

API-verzió:: 2022-12-12

Ellenőrizze a tanúsítvány titkos kulcsának birtoklását.
Az előre feltöltött tanúsítvány által kibocsátott levéltanúsítvány megadásával ellenőrzi a tanúsítvány titkos kulcsának birtoklását.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/provisioningServices/{provisioningServiceName}/certificates/{certificateName}/verify?api-version=2022-12-12

Opcionális paraméterekkel:

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/provisioningServices/{provisioningServiceName}/certificates/{certificateName}/verify?certificate.name={certificate.name}&certificate.rawBytes={certificate.rawBytes}&certificate.isVerified={certificate.isVerified}&certificate.purpose={certificate.purpose}&certificate.created={certificate.created}&certificate.lastUpdated={certificate.lastUpdated}&certificate.hasPrivateKey={certificate.hasPrivateKey}&certificate.nonce={certificate.nonce}&api-version=2022-12-12

URI-paraméterek

Name	In	Kötelező	Típus	Description
certificateName	path	True	string	A tanúsítvány kötelező logikai neve, amelyet a kiépítési szolgáltatás a hozzáféréshez használ.
provisioningServiceName	path	True	string	Kiépítési szolgáltatás neve.
resourceGroupName	path	True	string	Az erőforráscsoport neve.
subscriptionId	path	True	string	Az előfizetés azonosítója.
api-version	query	True	string	Az API verziója.
certificate.created	query		string date-time	Tanúsítványlétrehozás ideje.
certificate.hasPrivateKey	query		boolean	Azt jelzi, hogy a tanúsítvány tartalmaz-e titkos kulcsot.
certificate.isVerified	query		boolean	Azt jelzi, hogy a tanúsítványt a titkos kulcs tulajdonosa ellenőrizte-e.
certificate.lastUpdated	query		string date-time	A tanúsítvány utolsó frissítésének időpontja.
certificate.name	query		string	A tanúsítvány általános neve.
certificate.nonce	query		string	Véletlenszerűen generált szám, amely a birtoklás igazolására szolgál.
certificate.purpose	query		CertificatePurpose	Írja le a tanúsítvány célját.
certificate.rawBytes	query		string byte	A tanúsítvány nyers adatai.

Kérelem fejléce

Name	Kötelező	Típus	Description
If-Match	True	string	A tanúsítvány ETagje.

Kérelem törzse

Name	Típus	Description
certificate	string	az X509-tanúsítvány 64-ben .cer fájl vagy csak a .pem fájl tartalma.

Válaszok

Name	Típus	Description
200 OK	CertificateResponse	OK
Other Status Codes	ErrorDetails	Alapértelmezett hibaválasz.

Biztonság

azure_auth

Azure Active Directory OAuth2 Flow.

Típus: oauth2
Folyamat: implicit
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/authorize

Hatókörök

Name	Description
user_impersonation	felhasználói fiók megszemélyesítése

Példák

DPSVerifyCertificate

Mintakérelem

HTTP

POST https://management.azure.com/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/resourceGroups/myResourceGroup/providers/Microsoft.Devices/provisioningServices/myFirstProvisioningService/certificates/cert/verify?certificate.name={certificate.name}&certificate.rawBytes={certificate.rawBytes}&certificate.isVerified={certificate.isVerified}&certificate.purpose={certificate.purpose}&certificate.created={certificate.created}&certificate.lastUpdated={certificate.lastUpdated}&certificate.hasPrivateKey={certificate.hasPrivateKey}&certificate.nonce={certificate.nonce}&api-version=2022-12-12


{
  "certificate": "#####################################"
}

Mintaválasz

Állapotkód:: 200

{
  "properties": {
    "subject": "CN=andbucdevice1",
    "expiry": "Sat, 31 Dec 2039 23:59:59 GMT",
    "certificate": "MA==",
    "thumbprint": "97388663832D0393C9246CAB4FBA2C8677185A25",
    "isVerified": true,
    "created": "Thu, 12 Oct 2017 19:23:50 GMT",
    "updated": "Thu, 12 Oct 2017 19:26:56 GMT"
  },
  "id": "/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/resourceGroups/myResourceGroup/providers/Microsoft.Devices/ProvisioningServices/myFirstProvisioningService/certificates/cert",
  "name": "cert",
  "type": "Microsoft.Devices/ProvisioningServices/Certificates",
  "etag": "AAAAAAExpTQ="
}

Definíciók

Name	Description
CertificateProperties	X509 hitelesítésszolgáltatói tanúsítvány leírása.
CertificatePurpose	Írja le a tanúsítvány célját.
CertificateResponse	Az X509-tanúsítvány.
createdByType	Az erőforrást létrehozó identitás típusa.
ErrorDetails	Hiba részletei.
systemData	Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.
VerificationCodeRequest	A JSON-szerializált levéltanúsítvány

CertificateProperties

X509 hitelesítésszolgáltatói tanúsítvány leírása.

Name	Típus	Description
certificate	string	az X509-tanúsítvány 64-ben .cer fájl vagy csak a .pem fájl tartalma.
created	string	A tanúsítvány létrehozásának dátuma és időpontja.
expiry	string	A tanúsítvány lejárati dátuma és időpontja.
isVerified	boolean	Meghatározza, hogy a tanúsítvány ellenőrizve lett-e.
subject	string	A tanúsítvány tulajdonosának neve.
thumbprint	string	A tanúsítvány ujjlenyomata.
updated	string	A tanúsítvány utolsó frissítési dátuma és időpontja.

CertificatePurpose

Írja le a tanúsítvány célját.

Name	Típus	Description
clientAuthentication	string
serverAuthentication	string

CertificateResponse

Az X509-tanúsítvány.

Name	Típus	Description
etag	string	Az entitáscímke.
id	string	Az erőforrás azonosítója.
name	string	A tanúsítvány neve.
properties	CertificateProperties	tanúsítvány tulajdonságai
systemData	systemData	Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.
type	string	Az erőforrás típusa.

createdByType

Az erőforrást létrehozó identitás típusa.

Name	Típus	Description
Application	string
Key	string
ManagedIdentity	string
User	string

ErrorDetails

Hiba részletei.

Name	Típus	Description
code	integer	A hibakód.
details	string	A hiba részletei.
httpStatusCode	string	A HTTP-állapotkód.
message	string	A hibaüzenet.

systemData

Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.

Name	Típus	Description
createdAt	string	Az erőforrás-létrehozás időbélyege (UTC).
createdBy	string	Az erőforrást létrehozó identitás.
createdByType	createdByType	Az erőforrást létrehozó identitás típusa.
lastModifiedAt	string	Az erőforrás utolsó módosításának időbélyege (UTC)
lastModifiedBy	string	Az az identitás, amely legutóbb módosította az erőforrást.
lastModifiedByType	createdByType	Az erőforrást legutóbb módosító identitás típusa.

VerificationCodeRequest

A JSON-szerializált levéltanúsítvány

Name	Típus	Description
certificate	string	az X509-tanúsítvány 64-ben .cer fájl vagy csak a .pem fájl tartalma.

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