Dps Certificate - Verify Certificate

  • Referenz
Service:
IoT Hub Device Provisioning Service
API Version:
2018-01-22

Überprüfen Sie den Besitz des privaten Schlüssels des Zertifikats.
Überprüft den Besitz des privaten Schlüssels des Zertifikats, indem das Blattzertifikat bereitgestellt wird, das vom überprüfenden vorab hochgeladenen Zertifikat ausgestellt wurde.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/provisioningServices/{provisioningServiceName}/certificates/{certificateName}/verify?api-version=2018-01-22
With optional 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=2018-01-22

URI-Parameter

Name In Erforderlich Typ Beschreibung
certificateName
 path True

string

Der obligatorische logische Name des Zertifikats, auf das der Bereitstellungsdienst zugreift.
provisioningServiceName
 path True

string

Name des Bereitstellungsdiensts.
resourceGroupName
 path True

string

Ressourcengruppenname
subscriptionId
 path True

string

Die Abonnement-ID.
api-version
 query True

string

Die Version der API.
certificate.created
 query

string

date-time

Zertifikaterstellungszeit.
certificate.hasPrivateKey
 query

boolean

Gibt an, ob das Zertifikat einen privaten Schlüssel enthält.
certificate.isVerified
 query

boolean

Gibt an, ob das Zertifikat vom Besitzer des privaten Schlüssels überprüft wurde.
certificate.lastUpdated
 query

string

date-time

Die Letzte Aktualisierungszeit des Zertifikats.
certificate.name
 query

string

Allgemeiner Name für das Zertifikat.
certificate.nonce
 query

string

Zufallszahl, die generiert wird, um den Besitznachweis anzugeben.
certificate.purpose
 query

CertificatePurpose

Beschreiben Sie den Zweck des Zertifikats.
certificate.rawBytes
 query

string

byte

Rohdaten des Zertifikats.

Anforderungsheader

Name Erforderlich Typ Beschreibung
If-Match True

string

ETag des Zertifikats.

Anforderungstext

Name Typ Beschreibung
certificate

string

Base64-Darstellung des X509-Zertifikats .cer Datei oder nur PEM-Dateiinhalt.

Antworten

Name Typ Beschreibung
200 OK

CertificateResponse

OK
Other Status Codes

ErrorDetails

Standardfehlerantwort.

Sicherheit

azure_auth

Azure Active Directory OAuth2 Flow.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Beschreibung
user_impersonation Identitätswechsel Ihres Benutzerkontos

Beispiele

DPSVerifyCertificate

Sample Request

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=2018-01-22


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

Sample Response

Status code:
200 
{
  "properties": {
    "subject": "CN=andbucdevice1",
    "expiry": "Sat, 31 Dec 2039 23:59:59 GMT",
    "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="
}

Definitionen

Name Beschreibung
CertificateProperties

Die Beschreibung eines X509-Zertifizierungsstellenzertifikats.
CertificatePurpose

Beschreiben Sie den Zweck des Zertifikats.
CertificateResponse

Das X509-Zertifikat.
ErrorDetails

Fehlerdetails.
VerificationCodeRequest

Das JSON-serialisierte Blattzertifikat

CertificateProperties

Die Beschreibung eines X509-Zertifizierungsstellenzertifikats.

Name Typ Beschreibung
created

string

Erstellungsdatum und -uhrzeit des Zertifikats.
expiry

string

Ablaufdatum und -uhrzeit des Zertifikats.
isVerified

boolean

Bestimmt, ob das Zertifikat überprüft wurde.
subject

string

Der Antragstellername des Zertifikats.
thumbprint

string

Der Fingerabdruck des Zertifikats.
updated

string

Datum und Uhrzeit der letzten Aktualisierung des Zertifikats.

CertificatePurpose

Beschreiben Sie den Zweck des Zertifikats.

Name Typ Beschreibung
clientAuthentication

string

serverAuthentication

string

CertificateResponse

Das X509-Zertifikat.

Name Typ Beschreibung
etag

string

Das Entitätstag.
id

string

Der Ressourcenbezeichner.
name

string

Der Name des Zertifikats.
properties

CertificateProperties

Eigenschaften eines Zertifikats
type

string

Der Ressourcentyp.

ErrorDetails

Fehlerdetails.

Name Typ Beschreibung
code

string

Der Fehlercode.
details

string

Die Fehlerdetails.
httpStatusCode

string

Der HTTP-Statuscode.
message

string

Die Fehlermeldung.

VerificationCodeRequest

Das JSON-serialisierte Blattzertifikat

Name Typ Beschreibung
certificate

string

Base64-Darstellung des X509-Zertifikats .cer Datei oder nur PEM-Dateiinhalt.