Dps Certificate - Verify Certificate

Referentie

Service:: IoT Hub Device Provisioning Service

API-versie:: 2022-12-12

Controleer het bezit van de persoonlijke sleutel van het certificaat.
Controleert het bezit van de persoonlijke sleutel van het certificaat door het leaf-certificaat op te geven dat is uitgegeven door het vooraf geüploade verificatiecertificaat.

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 de inrichtingsservice gebruikt om toegang te krijgen.
provisioningServiceName	path	True	string	Naam van inrichtingsservice.
resourceGroupName	path	True	string	Naam van de resourcegroep.
subscriptionId	path	True	string	De abonnements-id.
api-version	query	True	string	De versie van de API.
certificate.created	query		string date-time	De aanmaaktijd van het certificaat.
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	Tijdstip waarop het certificaat voor het laatst is bijgewerkt.
certificate.name	query		string	Algemene naam voor het certificaat.
certificate.nonce	query		string	Willekeurig getal dat wordt gegenereerd om het 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-stroom.

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 laatste wijzigen van de resource.
VerificationCodeRequest	Het JSON-geserialiseerde leaf-certificaat

CertificateProperties

De beschrijving van een X509 CA-certificaat.

Name	Type	Description
certificate	string	base-64-weergave van X509-certificaat .cer bestand of alleen .pem-bestandsinhoud.
created	string	De aanmaakdatum en -tijd van het certificaat.
expiry	string	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	De datum en tijd van de laatste update van het certificaat.

CertificatePurpose

Beschrijf het doel van het certificaat.

Name	Type	Description
clientAuthentication	string
serverAuthentication	string

CertificateResponse

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 laatste wijzigen van de resource.
type	string	Het resourcetype.

createdByType

Het type identiteit waarmee de resource is gemaakt.

Name	Type	Description
Application	string
Key	string
ManagedIdentity	string
User	string

ErrorDetails

Foutdetails.

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

systemData

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

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

VerificationCodeRequest

Het JSON-geserialiseerde leaf-certificaat

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

Delen via