Dps Certificate - Verify Certificate

Referens

Tjänst:: IoT Hub Device Provisioning Service

API-version:: 2022-12-12

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=2022-12-12

Med valfria parametrar:

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

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

Name	Description
user_impersonation	personifiera ditt användarkonto

Exempel

DPSVerifyCertificate

Exempelbegäran

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

Exempelsvar

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

Definitioner

Name	Description
CertificateProperties	Beskrivningen av ett X509 CA-certifikat.
CertificatePurpose	Beskriv syftet med certifikatet.
CertificateResponse	X509-certifikatet.
createdByType	Den typ av identitet som skapade resursen.
ErrorDetails	Felinformation.
systemData	Metadata som rör skapande och senaste ändring av resursen.
VerificationCodeRequest	Det JSON-serialiserade lövcertifikatet

CertificateProperties

Beskrivningen av ett X509 CA-certifikat.

Name	Typ	Description
certificate	string	base-64-representation av X509-certifikatet .cer fil eller bara .pem-filinnehåll.
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
systemData	systemData	Metadata som rör skapande och senaste ändring av resursen.
type	string	Resurstypen.

createdByType

Den typ av identitet som skapade resursen.

Name	Typ	Description
Application	string
Key	string
ManagedIdentity	string
User	string

ErrorDetails

Felinformation.

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

systemData

Metadata som rör skapande och senaste ändring av resursen.

Name	Typ	Description
createdAt	string	Tidsstämpeln för resursskapande (UTC).
createdBy	string	Identiteten som skapade resursen.
createdByType	createdByType	Den typ av identitet som skapade resursen.
lastModifiedAt	string	Tidsstämpeln för resursens senaste ändring (UTC)
lastModifiedBy	string	Identiteten som senast ändrade resursen.
lastModifiedByType	createdByType	Den typ av identitet som senast ändrade resursen.

VerificationCodeRequest

Det JSON-serialiserade lövcertifikatet

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

Dela via