Devices - Get Attestation

Obter atestado do dispositivo

GET https://{subdomain}.{baseDomain}/api/devices/{deviceId}/attestation?api-version=2022-07-31

Parâmetros de URI

Name In Required Type Description
baseDomain
path True
  • string

O domínio base para todas as solicitações de serviço do Azure IoT Central.

deviceId
path True
  • string

ID exclusiva do dispositivo.

subdomain
path True
  • string

O subdomínio do aplicativo.

api-version
query True
  • string

A versão da API que está sendo chamada.

Respostas

Name Type Description
200 OK Attestation:

Sucesso

Other Status Codes

Uma resposta de erro recebida do Serviço Central de IoT.

Headers

  • x-ms-error-code: string

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory

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

Scopes

Name Description
user_impersonation representar sua conta de usuário

Exemplos

Get device attestation

Sample Request

GET https://appsubdomain.azureiotcentral.com/api/devices/CheckoutThermostat/attestation?api-version=2022-07-31

Sample Response

{
  "type": "x509",
  "x509": {
    "clientCertificates": {
      "primary": {
        "info": {
          "sha1Thumbprint": "<thumbprint>"
        }
      }
    }
  }
}

Definições

Error

A definição de erro de resposta.

ErrorDetails

As informações detalhadas do erro.

SymmetricKey

A definição de chave simétrica.

SymmetricKeyAttestation

A definição de atestado de chave simétrica.

Tpm

A definição do módulo de plataforma confiável.

TpmAttestation

A definição de atestado do TPM.

X509

A definição X509.

X509Attestation

A definição de atestado X509.

X509Certificate

A definição do certificado X509.

X509CertificateInfo

As informações do certificado X509.

X509Certificates

A definição de certificados X509.

Error

A definição de erro de resposta.

Name Type Description
error

Detalhes do erro da solicitação atual.

ErrorDetails

As informações detalhadas do erro.

Name Type Description
code
  • string

Código do erro.

message
  • string

Detalhes da mensagem de erro.

requestId
  • string

ID de correlação para a solicitação atual.

time
  • string

A hora em que a solicitação de erro falhou.

SymmetricKey

A definição de chave simétrica.

Name Type Description
primaryKey
  • string

A chave primária para essa credencial.

secondaryKey
  • string

A chave secundária para essa credencial.

SymmetricKeyAttestation

A definição de atestado de chave simétrica.

Name Type Description
symmetricKey

As credenciais de chave simétrica para esse atestado.

type string:
  • symmetricKey

Tipo de atestado.

Tpm

A definição do módulo de plataforma confiável.

Name Type Description
endorsementKey
  • string

A chave de endosso do TPM para essa credencial.

TpmAttestation

A definição de atestado do TPM.

Name Type Description
tpm

As credenciais do TPM para esse atestado.

type string:
  • tpm

Tipo de atestado.

X509

A definição X509.

Name Type Description
clientCertificates

Os certificados de cliente X.509 para essa credencial.

X509Attestation

A definição de atestado X509.

Name Type Description
type string:
  • x509

Tipo de atestado.

x509

As credenciais X.509 para esse atestado.

X509Certificate

A definição do certificado X509.

Name Type Description
certificate
  • string

A representação de cadeia de caracteres desse certificado.

info

Informações sobre esse certificado.

X509CertificateInfo

As informações do certificado X509.

Name Type Description
sha1Thumbprint
  • string

O valor de hash SHA-1 do certificado.

X509Certificates

A definição de certificados X509.

Name Type Description
primary

O certificado X.509 primário para essa credencial.

secondary

O certificado X.509 secundário para essa credencial.