Dps Certificate - Verify Certificate

Reference

Service:: IoT Hub Device Provisioning Service

API Version:: 2022-12-12

Ověřte vlastnictví privátního klíče certifikátu.
Ověří vlastnictví privátního klíče certifikátu tím, že poskytne listový certifikát vydaný předem nahraným certifikátem.

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

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
certificateName	path	True	string	Povinný logický název certifikátu, který služba zřizování používá pro přístup.
provisioningServiceName	path	True	string	Název služby zřizování.
resourceGroupName	path	True	string	Název skupiny prostředků.
subscriptionId	path	True	string	Identifikátor předplatného.
api-version	query	True	string	Verze rozhraní API
certificate.created	query		string date-time	Čas vytvoření certifikátu.
certificate.hasPrivateKey	query		boolean	Označuje, jestli certifikát obsahuje privátní klíč.
certificate.isVerified	query		boolean	Označuje, jestli byl certifikát ověřen vlastníkem privátního klíče.
certificate.lastUpdated	query		string date-time	Čas poslední aktualizace certifikátu
certificate.name	query		string	Běžný název certifikátu.
certificate.nonce	query		string	Náhodné číslo vygenerované pro označení dokladu o vlastnictví.
certificate.purpose	query		CertificatePurpose	Popište účel certifikátu.
certificate.rawBytes	query		string byte	Nezpracovaná data certifikátu.

Hlavička požadavku

Name	Vyžadováno	Typ	Description
If-Match	True	string	Značka ETag certifikátu.

Text požadavku

Name	Typ	Description
certificate	string	base-64 reprezentace certifikátu X509 .cer souboru nebo jenom obsahu souboru .pem.

Odpovědi

Name	Typ	Description
200 OK	CertificateResponse	OK
Other Status Codes	ErrorDetails	Výchozí odpověď na chybu.

Zabezpečení

azure_auth

Tok Azure Active Directory OAuth2

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

Scopes

Name	Description
user_impersonation	zosobnění uživatelského účtu

Příklady

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


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

Sample Response

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

Definice

Name	Description
CertificateProperties	Popis certifikátu certifikační autority X509.
CertificatePurpose	Popište účel certifikátu.
CertificateResponse	Certifikát X509.
createdByType	Typ identity, která vytvořila prostředek.
ErrorDetails	Podrobnosti o chybě.
systemData	Metadata týkající se vytvoření a poslední změny prostředku
VerificationCodeRequest	Listový certifikát serializovaný ve formátu JSON

CertificateProperties

Popis certifikátu certifikační autority X509.

Name	Typ	Description
certificate	string	base-64 reprezentace certifikátu X509 .cer souboru nebo jenom obsahu souboru .pem.
created	string	Datum a čas vytvoření certifikátu
expiry	string	Datum a čas vypršení platnosti certifikátu
isVerified	boolean	Určuje, jestli byl certifikát ověřen.
subject	string	Název subjektu certifikátu.
thumbprint	string	Kryptografický otisk certifikátu.
updated	string	Datum a čas poslední aktualizace certifikátu

CertificatePurpose

Popište účel certifikátu.

Name	Typ	Description
clientAuthentication	string
serverAuthentication	string

CertificateResponse

Certifikát X509.

Name	Typ	Description
etag	string	Značka entity.
id	string	Identifikátor prostředku.
name	string	Název certifikátu.
properties	CertificateProperties	vlastnosti certifikátu
systemData	systemData	Metadata týkající se vytvoření a poslední změny prostředku
type	string	Typ prostředku.

createdByType

Typ identity, která vytvořila prostředek.

Name	Typ	Description
Application	string
Key	string
ManagedIdentity	string
User	string

ErrorDetails

Podrobnosti o chybě.

Name	Typ	Description
code	integer	Kód chyby
details	string	Podrobnosti o chybě
httpStatusCode	string	Stavový kód HTTP
message	string	Chybová zpráva

systemData

Metadata týkající se vytvoření a poslední změny prostředku

Name	Typ	Description
createdAt	string	Časové razítko vytvoření prostředku (UTC)
createdBy	string	Identita, která prostředek vytvořila.
createdByType	createdByType	Typ identity, která vytvořila prostředek.
lastModifiedAt	string	Časové razítko poslední změny prostředku (UTC)
lastModifiedBy	string	Identita, která naposledy změnila prostředek.
lastModifiedByType	createdByType	Typ identity, která naposledy změnila prostředek.

VerificationCodeRequest

Listový certifikát serializovaný ve formátu JSON

Name	Typ	Description
certificate	string	base-64 reprezentace certifikátu X509 .cer souboru nebo jenom obsahu souboru .pem.