Dps Certificate - Verify Certificate

Referens

Service:: IoT Hub Device Provisioning Service

API Version:: 2018-01-22

Verifiera certifikatets privata nyckelinnehav.
Verifierar certifikatets privata nyckelinnehav genom att tillhandahålla lövcertifikatet som utfärdats av det verifierande förladdade certifikatet.

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

Name	I	Obligatorisk	Typ	Description
certificateName	path	True	string	Certifikatets obligatoriska logiska namn, som etableringstjänsten använder för åtkomst.
provisioningServiceName	path	True	string	Etableringstjänstnamn.
resourceGroupName	path	True	string	Namn på resursgrupp.
subscriptionId	path	True	string	Prenumerationsidentifieraren.
api-version	query	True	string	Versionen av API:et.
certificate.created	query		string date-time	Tiden då certifikatet skapades.
certificate.hasPrivateKey	query		boolean	Anger om certifikatet innehåller en privat nyckel.
certificate.isVerified	query		boolean	Anger om certifikatet har verifierats av ägaren av den privata nyckeln.
certificate.lastUpdated	query		string date-time	Certifikatet uppdaterades senast.
certificate.name	query		string	Eget namn för certifikatet.
certificate.nonce	query		string	Slumptal som genereras för att indikera bevis på innehav.
certificate.purpose	query		CertificatePurpose	Beskriv syftet med certifikatet.
certificate.rawBytes	query		string byte	Rådata för certifikat.

Begärandehuvud

Name	Obligatorisk	Typ	Description
If-Match	True	string	ETag för certifikatet.

Begärandetext

Name	Typ	Description
certificate	string	base-64-representation av X509-certifikatet .cer fil eller bara .pem-filinnehåll.

Svar

Name	Typ	Description
200 OK	CertificateResponse	OK
Other Status Codes	ErrorDetails	Standardfelsvar.

Säkerhet

azure_auth

Azure Active Directory OAuth2 Flow.

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

Scopes

Name	Description
user_impersonation	personifiera ditt användarkonto

Exempel

DPSVerifyCertificate

Sample Request

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

Definitioner

Name	Description
CertificateProperties	Beskrivningen av ett X509 CA-certifikat.
CertificatePurpose	Beskriv syftet med certifikatet.
CertificateResponse	X509-certifikatet.
ErrorDetails	Felinformation.
VerificationCodeRequest	Det JSON-serialiserade lövcertifikatet

CertificateProperties

Beskrivningen av ett X509 CA-certifikat.

Name	Typ	Description
created	string	Certifikatets skapandedatum och tid.
expiry	string	Certifikatets förfallodatum och tid.
isVerified	boolean	Avgör om certifikatet har verifierats.
subject	string	Certifikatets ämnesnamn.
thumbprint	string	Certifikatets tumavtryck.
updated	string	Certifikatets senaste uppdateringsdatum och -tid.

CertificatePurpose

Beskriv syftet med certifikatet.

Name	Typ	Description
clientAuthentication	string
serverAuthentication	string

CertificateResponse

X509-certifikatet.

Name	Typ	Description
etag	string	Entitetstaggen.
id	string	Resursidentifieraren.
name	string	Namnet på certifikatet.
properties	CertificateProperties	egenskaper för ett certifikat
type	string	Resurstypen.

ErrorDetails

Felinformation.

Name	Typ	Description
code	string	Felkoden.
details	string	Felinformationen.
httpStatusCode	string	HTTP-statuskoden.
message	string	Felmeddelandet.

VerificationCodeRequest

Det JSON-serialiserade lövcertifikatet

Name	Typ	Description
certificate	string	base-64-representation av X509-certifikatet .cer fil eller bara .pem-filinnehåll.