Dps Certificate - Verify Certificate

Referência

Serviço:: IoT Hub Device Provisioning Service

Versão da API:: 2022-12-12

Verifique a propriedade da chave privada do certificado.
Verifica a propriedade da chave privada do certificado ao fornecer o certificado de folha emitido pelo certificado pré-carregado de verificação.

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

Com parâmetros opcionais:

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 do URI

Name	Em	Necessário	Tipo	Description
certificateName	path	True	string	O nome lógico obrigatório do certificado, que o serviço de aprovisionamento utiliza para aceder.
provisioningServiceName	path	True	string	Nome do serviço de aprovisionamento.
resourceGroupName	path	True	string	Nome do grupo de recursos.
subscriptionId	path	True	string	O identificador da subscrição.
api-version	query	True	string	A versão da API.
certificate.created	query		string date-time	Hora de criação do certificado.
certificate.hasPrivateKey	query		boolean	Indica se o certificado contém uma chave privada.
certificate.isVerified	query		boolean	Indica se o certificado foi verificado pelo proprietário da chave privada.
certificate.lastUpdated	query		string date-time	Hora da última atualização do certificado.
certificate.name	query		string	Nome Comum do certificado.
certificate.nonce	query		string	Número aleatório gerado para indicar Prova de Posse.
certificate.purpose	query		CertificatePurpose	Descreva o objetivo do certificado.
certificate.rawBytes	query		string byte	Dados não processados do certificado.

Cabeçalho do Pedido

Name	Necessário	Tipo	Description
If-Match	True	string	ETag do certificado.

Corpo do Pedido

Name	Tipo	Description
certificate	string	Representação base 64 do certificado X509 .cer ficheiro ou apenas conteúdo de ficheiro .pem.

Respostas

Name	Tipo	Description
200 OK	CertificateResponse	OK
Other Status Codes	ErrorDetails	Resposta de erro predefinida.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory.

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

Name	Description
user_impersonation	representar a sua conta de utilizador

Exemplos

DPSVerifyCertificate

Pedido de amostra

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

Resposta da amostra

Código de estado:: 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="
}

Definições

Name	Description
CertificateProperties	A descrição de um Certificado de AC X509.
CertificatePurpose	Descreva o objetivo do certificado.
CertificateResponse	O Certificado X509.
createdByType	O tipo de identidade que criou o recurso.
ErrorDetails	Detalhes do erro.
systemData	Metadados relativos à criação e última modificação do recurso.
VerificationCodeRequest	O certificado de folha serializado JSON

CertificateProperties

A descrição de um Certificado de AC X509.

Name	Tipo	Description
certificate	string	Representação base 64 do certificado X509 .cer ficheiro ou apenas conteúdo de ficheiro .pem.
created	string	A data e hora de criação do certificado.
expiry	string	A data e hora de expiração do certificado.
isVerified	boolean	Determina se o certificado foi verificado.
subject	string	O nome do requerente do certificado.
thumbprint	string	O thumbprint do certificado.
updated	string	A data e hora da última atualização do certificado.

CertificatePurpose

Descreva o objetivo do certificado.

Name	Tipo	Description
clientAuthentication	string
serverAuthentication	string

CertificateResponse

O Certificado X509.

Name	Tipo	Description
etag	string	A etiqueta de entidade.
id	string	O identificador do recurso.
name	string	O nome do certificado.
properties	CertificateProperties	propriedades de um certificado
systemData	systemData	Metadados relativos à criação e última modificação do recurso.
type	string	O tipo de recurso.

createdByType

O tipo de identidade que criou o recurso.

Name	Tipo	Description
Application	string
Key	string
ManagedIdentity	string
User	string

ErrorDetails

Detalhes do erro.

Name	Tipo	Description
code	integer	O código de erro.
details	string	Os detalhes do erro.
httpStatusCode	string	O código de estado HTTP.
message	string	A mensagem de erro.

systemData

Metadados relativos à criação e última modificação do recurso.

Name	Tipo	Description
createdAt	string	O carimbo de data/hora da criação de recursos (UTC).
createdBy	string	A identidade que criou o recurso.
createdByType	createdByType	O tipo de identidade que criou o recurso.
lastModifiedAt	string	O carimbo de data/hora da última modificação do recurso (UTC)
lastModifiedBy	string	A identidade que modificou o recurso pela última vez.
lastModifiedByType	createdByType	O tipo de identidade que modificou o recurso pela última vez.

VerificationCodeRequest

O certificado de folha serializado JSON

Name	Tipo	Description
certificate	string	Representação base 64 do certificado X509 .cer ficheiro ou apenas conteúdo de ficheiro .pem.

Partilhar via