Dps Certificate - Verify Certificate

Référence

Service:: IoT Hub Device Provisioning Service

Version d'API:: 2022-12-12

Vérifiez la possession de la clé privée du certificat.
Vérifie la possession de la clé privée du certificat en fournissant le certificat feuille émis par le certificat de vérification préalablement chargé.

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

Avec des paramètres facultatifs:

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
certificateName	path	True	string	Nom logique obligatoire du certificat, que le service d’approvisionnement utilise pour accéder.
provisioningServiceName	path	True	string	Nom du service d’approvisionnement.
resourceGroupName	path	True	string	Nom du groupe de ressources.
subscriptionId	path	True	string	Identificateur de l’abonnement.
api-version	query	True	string	Version de l’API.
certificate.created	query		string date-time	Heure de création du certificat.
certificate.hasPrivateKey	query		boolean	Indique si le certificat contient une clé privée.
certificate.isVerified	query		boolean	Indique si le certificat a été vérifié par le propriétaire de la clé privée.
certificate.lastUpdated	query		string date-time	Heure de la dernière mise à jour du certificat.
certificate.name	query		string	Nom commun du certificat.
certificate.nonce	query		string	Nombre aléatoire généré pour indiquer la preuve de possession.
certificate.purpose	query		CertificatePurpose	Décrire l’objectif du certificat.
certificate.rawBytes	query		string byte	Données brutes du certificat.

En-tête de la demande

Nom	Obligatoire	Type	Description
If-Match	True	string	ETag du certificat.

Corps de la demande

Nom	Type	Description
certificate	string	Représentation en base 64 du fichier de certificat X509 .cer ou simplement du contenu du fichier .pem.

Réponses

Nom	Type	Description
200 OK	CertificateResponse	Ok
Other Status Codes	ErrorDetails	Réponse d’erreur par défaut.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory.

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom	Description
user_impersonation	Emprunter l’identité de votre compte d’utilisateur

Exemples

DPSVerifyCertificate

Exemple de requête

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

Exemple de réponse

Code d’état:: 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="
}

Définitions

Nom	Description
CertificateProperties	Description d’un certificat d’autorité de certification X509.
CertificatePurpose	Décrire l’objectif du certificat.
CertificateResponse	Certificat X509.
createdByType	Type d’identité qui a créé la ressource.
ErrorDetails	Détails de l’erreur.
systemData	Métadonnées relatives à la création et à la dernière modification de la ressource.
VerificationCodeRequest	Certificat feuille sérialisé JSON

CertificateProperties

Description d’un certificat d’autorité de certification X509.

Nom	Type	Description
certificate	string	Représentation en base 64 du fichier de certificat X509 .cer ou simplement du contenu du fichier .pem.
created	string	Date et heure de création du certificat.
expiry	string	Date et heure d’expiration du certificat.
isVerified	boolean	Détermine si le certificat a été vérifié.
subject	string	Nom de l’objet du certificat.
thumbprint	string	empreinte numérique du certificat.
updated	string	Date et heure de la dernière mise à jour du certificat.

CertificatePurpose

Décrire l’objectif du certificat.

Nom	Type	Description
clientAuthentication	string
serverAuthentication	string

CertificateResponse

Certificat X509.

Nom	Type	Description
etag	string	Étiquette d’entité.
id	string	Identificateur de ressource.
name	string	Nom du certificat.
properties	CertificateProperties	propriétés d’un certificat
systemData	systemData	Métadonnées relatives à la création et à la dernière modification de la ressource.
type	string	Type de ressource.

createdByType

Type d’identité qui a créé la ressource.

Nom	Type	Description
Application	string
Key	string
ManagedIdentity	string
User	string

ErrorDetails

Détails de l’erreur.

Nom	Type	Description
code	integer	Code d'erreur.
details	string	Détails de l’erreur.
httpStatusCode	string	Code d’état HTTP.
message	string	Message d’erreur.

systemData

Métadonnées relatives à la création et à la dernière modification de la ressource.

Nom	Type	Description
createdAt	string	Horodatage de la création de ressources (UTC).
createdBy	string	Identité qui a créé la ressource.
createdByType	createdByType	Type d’identité qui a créé la ressource.
lastModifiedAt	string	Horodatage de la dernière modification de la ressource (UTC)
lastModifiedBy	string	Identité qui a modifié la ressource pour la dernière fois.
lastModifiedByType	createdByType	Type d’identité qui a modifié la ressource pour la dernière fois.

VerificationCodeRequest

Certificat feuille sérialisé JSON

Nom	Type	Description
certificate	string	Représentation en base 64 du fichier de certificat X509 .cer ou simplement du contenu du fichier .pem.

Partager via