Dps Certificate - Verify Certificate

Referencia

Service:: IoT Hub Device Provisioning Service

API Version:: 2022-12-12

Compruebe la posesión de la clave privada del certificado.
Comprueba la posesión de la clave privada del certificado proporcionando el certificado hoja emitido por el certificado previamente cargado.

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
certificateName	path	True	string	Nombre lógico obligatorio del certificado, que el servicio de aprovisionamiento usa para acceder.
provisioningServiceName	path	True	string	Nombre del servicio de aprovisionamiento.
resourceGroupName	path	True	string	Nombre del grupo de recursos.
subscriptionId	path	True	string	Identificador de la suscripción.
api-version	query	True	string	La versión de la API.
certificate.created	query		string date-time	Hora de creación del certificado.
certificate.hasPrivateKey	query		boolean	Indica si el certificado contiene una clave privada.
certificate.isVerified	query		boolean	Indica si el propietario de la clave privada ha comprobado el certificado.
certificate.lastUpdated	query		string date-time	Hora de la última actualización del certificado.
certificate.name	query		string	Nombre común del certificado.
certificate.nonce	query		string	Número aleatorio generado para indicar la prueba de posesión.
certificate.purpose	query		CertificatePurpose	Describir el propósito del certificado.
certificate.rawBytes	query		string byte	Datos sin procesar del certificado.

Encabezado de la solicitud

Nombre	Requerido	Tipo	Description
If-Match	True	string	ETag del certificado.

Cuerpo de la solicitud

Nombre	Tipo	Description
certificate	string	representación base 64 del certificado X509 .cer archivo o solo contenido del archivo .pem.

Respuestas

Nombre	Tipo	Description
200 OK	CertificateResponse	Aceptar
Other Status Codes	ErrorDetails	Respuesta de error predeterminada.

Seguridad

azure_auth

Flujo de OAuth2 de Azure Active Directory.

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

Scopes

Nombre	Description
user_impersonation	suplantación de su cuenta de usuario

Ejemplos

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

Definiciones

Nombre	Description
CertificateProperties	Descripción de un certificado de entidad de certificación X509.
CertificatePurpose	Describir el propósito del certificado.
CertificateResponse	El certificado X509.
createdByType	Tipo de identidad que creó el recurso.
ErrorDetails	Detalles del error.
systemData	Metadatos relacionados con la creación y la última modificación del recurso.
VerificationCodeRequest	El certificado hoja serializado por JSON

CertificateProperties

Descripción de un certificado de entidad de certificación X509.

Nombre	Tipo	Description
certificate	string	representación base 64 del certificado X509 .cer archivo o solo contenido del archivo .pem.
created	string	Fecha y hora de creación del certificado.
expiry	string	Fecha y hora de expiración del certificado.
isVerified	boolean	Determina si se ha comprobado el certificado.
subject	string	Nombre del firmante del certificado.
thumbprint	string	la huella digital del certificado.
updated	string	Fecha y hora de la última actualización del certificado.

CertificatePurpose

Describir el propósito del certificado.

Nombre	Tipo	Description
clientAuthentication	string
serverAuthentication	string

CertificateResponse

El certificado X509.

Nombre	Tipo	Description
etag	string	Etiqueta de entidad.
id	string	Identificador del recurso.
name	string	Nombre del certificado.
properties	CertificateProperties	propiedades de un certificado
systemData	systemData	Metadatos relacionados con la creación y la última modificación del recurso.
type	string	El tipo de recurso.

createdByType

Tipo de identidad que creó el recurso.

Nombre	Tipo	Description
Application	string
Key	string
ManagedIdentity	string
User	string

ErrorDetails

Detalles del error.

Nombre	Tipo	Description
code	integer	Código de error.
details	string	Los detalles del error.
httpStatusCode	string	El código de estado HTTP.
message	string	El mensaje de error.

systemData

Metadatos relacionados con la creación y la última modificación del recurso.

Nombre	Tipo	Description
createdAt	string	Marca de tiempo de creación de recursos (UTC).
createdBy	string	Identidad que creó el recurso.
createdByType	createdByType	Tipo de identidad que creó el recurso.
lastModifiedAt	string	Marca de tiempo de la última modificación del recurso (UTC)
lastModifiedBy	string	Identidad que modificó por última vez el recurso.
lastModifiedByType	createdByType	Tipo de identidad que modificó por última vez el recurso.

VerificationCodeRequest

El certificado hoja serializado por JSON

Nombre	Tipo	Description
certificate	string	representación base 64 del certificado X509 .cer archivo o solo contenido del archivo .pem.