Compartilhar via


Dps Certificate - Verify Certificate

Verifique a posse de chave privada do certificado.
Verifica a posse de chave privada do certificado fornecendo o certificado 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
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 URI

Nome Em Obrigatório Tipo Description
certificateName
path True

string

O nome lógico obrigatório do certificado que o serviço de provisionamento usa para acessar.

provisioningServiceName
path True

string

Nome do serviço de provisionamento.

resourceGroupName
path True

string

Nome do grupo de recursos.

subscriptionId
path True

string

O identificador da assinatura.

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 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 para o certificado.

certificate.nonce
query

string

Número aleatório gerado para indicar Prova de Posse.

certificate.purpose
query

CertificatePurpose

Descrever a finalidade do certificado.

certificate.rawBytes
query

string

byte

Dados brutos do certificado.

Cabeçalho da solicitação

Nome Obrigatório Tipo Description
If-Match True

string

ETag do certificado.

Corpo da solicitação

Nome Tipo Description
certificate

string

representação base-64 do certificado X509 .cer arquivo ou apenas o conteúdo do arquivo .pem.

Respostas

Nome Tipo Description
200 OK

CertificateResponse

OK

Other Status Codes

ErrorDetails

Resposta de erro padrão.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory.

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

Escopos

Nome Description
user_impersonation representar sua conta de usuário

Exemplos

DPSVerifyCertificate

Solicitação de exemplo

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 de exemplo

{
  "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

Nome Description
CertificateProperties

A descrição de um certificado de autoridade de certificação X509.

CertificatePurpose

Descrever a finalidade 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 folha serializado por JSON

CertificateProperties

A descrição de um certificado de autoridade de certificação X509.

Nome Tipo Description
certificate

string

representação base-64 do certificado X509 .cer arquivo ou apenas o conteúdo do arquivo .pem.

created

string

Data e hora de criação do certificado.

expiry

string

Data e hora de validade do certificado.

isVerified

boolean

Determina se o certificado foi verificado.

subject

string

O nome da entidade do certificado.

thumbprint

string

a impressão digital do certificado.

updated

string

Data e hora da última atualização do certificado.

CertificatePurpose

Descrever a finalidade do certificado.

Nome Tipo Description
clientAuthentication

string

serverAuthentication

string

CertificateResponse

O certificado X509.

Nome Tipo Description
etag

string

A marca da 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.

Nome Tipo Description
Application

string

Key

string

ManagedIdentity

string

User

string

ErrorDetails

Detalhes do erro.

Nome Tipo Description
code

integer

O código de erro.

details

string

Os detalhes do erro.

httpStatusCode

string

O código de status do HTTP.

message

string

A mensagem de erro.

systemData

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

Nome 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 folha serializado por JSON

Nome Tipo Description
certificate

string

representação base-64 do certificado X509 .cer arquivo ou apenas o conteúdo do arquivo .pem.