Dps Certificate - Verify Certificate

Service:

IoT Hub Device Provisioning Service

API-versie:

2022-12-12

Controleer het bezit van de persoonlijke sleutel van het certificaat.
Verifieert het persoonlijke sleutelbezit van het certificaat door het bladcertificaat op te geven dat is uitgegeven door het vooraf geüploade certificaat te verifiëren.

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

Met optionele parameters:

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-parameters

Name	In	Vereist	Type	Description
certificateName	path	True	string	De verplichte logische naam van het certificaat, die door de inrichtingsservice wordt gebruikt voor toegang.
provisioningServiceName	path	True	string	Naam van inrichtingsservice.
resourceGroupName	path	True	string	Naam van de resourcegroep.
subscriptionId	path	True	string	De abonnement-ID.
api-version	query	True	string	De versie van de API.
certificate.created	query		string (date-time)	Tijd voor het maken van certificaten.
certificate.hasPrivateKey	query		boolean	Geeft aan of het certificaat een persoonlijke sleutel bevat.
certificate.isVerified	query		boolean	Geeft aan of het certificaat is geverifieerd door de eigenaar van de persoonlijke sleutel.
certificate.lastUpdated	query		string (date-time)	Het certificaat is voor het laatst bijgewerkt.
certificate.name	query		string	Algemene naam voor het certificaat.
certificate.nonce	query		string	Willekeurig getal gegenereerd om bewijs van bezit aan te geven.
certificate.purpose	query		CertificatePurpose	Beschrijf het doel van het certificaat.
certificate.rawBytes	query		string (byte)	Onbewerkte gegevens van het certificaat.

Aanvraagkoptekst

Name	Vereist	Type	Description
If-Match	True	string	ETag van het certificaat.

Aanvraagbody

Name	Type	Description
certificate	string	base-64-weergave van X509-certificaat .cer bestand of alleen PEM-bestandsinhoud.

Antwoorden

Name	Type	Description
200 OK	CertificateResponse	OK
Other Status Codes	ErrorDetails	Standaardfoutreactie.

Beveiliging

azure_auth

Azure Active Directory OAuth2 Flow.

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name	Description
user_impersonation	Uw gebruikersaccount imiteren

Voorbeelden

DPSVerifyCertificate

Voorbeeldaanvraag

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": "#####################################"
}

Voorbeeldrespons

Statuscode:

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="
}

Definities

Name	Description
CertificateProperties	De beschrijving van een X509-CA-certificaat.
CertificatePurpose	Beschrijf het doel van het certificaat.
CertificateResponse	Het X509-certificaat.
createdByType	Het type identiteit waarmee de resource is gemaakt.
ErrorDetails	Foutdetails.
systemData	Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.
VerificationCodeRequest	Het JSON-geserialiseerde leaf-certificaat

CertificateProperties

Object

De beschrijving van een X509-CA-certificaat.

Name	Type	Description
certificate	string (byte)	base-64-weergave van X509-certificaat .cer bestand of alleen PEM-bestandsinhoud.
created	string (date-time-rfc1123)	De aanmaakdatum en -tijd van het certificaat.
expiry	string (date-time-rfc1123)	De vervaldatum en -tijd van het certificaat.
isVerified	boolean	Bepaalt of het certificaat is geverifieerd.
subject	string	De onderwerpnaam van het certificaat.
thumbprint	string	De vingerafdruk van het certificaat.
updated	string (date-time-rfc1123)	De datum en tijd van de laatste update van het certificaat.

CertificatePurpose

Inventarisatie

Beschrijf het doel van het certificaat.

Waarde	Description
clientAuthentication
serverAuthentication

CertificateResponse

Object

Het X509-certificaat.

Name	Type	Description
etag	string	De entiteitstag.
id	string	De resource-id.
name	string	De naam van het certificaat.
properties	CertificateProperties	eigenschappen van een certificaat
systemData	systemData	Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.
type	string	Het resourcetype.

createdByType

Inventarisatie

Het type identiteit waarmee de resource is gemaakt.

Waarde	Description
Application
Key
ManagedIdentity
User

ErrorDetails

Object

Foutdetails.

Name	Type	Description
code	integer (int32)	De foutcode.
details	string	De foutdetails.
httpStatusCode	string	De HTTP-statuscode.
message	string	Het foutbericht.

systemData

Object

Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.

Name	Type	Description
createdAt	string (date-time)	De tijdstempel van het maken van resources (UTC).
createdBy	string	De identiteit waarmee de resource is gemaakt.
createdByType	createdByType	Het type identiteit waarmee de resource is gemaakt.
lastModifiedAt	string (date-time)	De tijdstempel van de laatste wijziging van de resource (UTC)
lastModifiedBy	string	De identiteit die de resource voor het laatst heeft gewijzigd.
lastModifiedByType	createdByType	Het type identiteit dat de resource voor het laatst heeft gewijzigd.

VerificationCodeRequest

Object

Het JSON-geserialiseerde leaf-certificaat

Name	Type	Description
certificate	string	base-64-weergave van X509-certificaat .cer bestand of alleen PEM-bestandsinhoud.