Devices - Get Attestation

Service:

IoT Central

API Version:

2022-07-31

Obter atestado do dispositivo

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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	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

Nome	Tipo	Description
200 OK	Attestation: SymmetricKeyAttestation TpmAttestation X509Attestation	Êxito
Other Status Codes	Error	Uma resposta de erro recebida do Serviço do IoT Central. Headers x-ms-error-code: string

Segurança

azure_auth

Fluxo do OAuth2 do Azure Active Directory

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

Scopes

Nome	Description
user_impersonation	representar sua conta de usuário

Exemplos

Get device attestation

Sample Request

HTTP

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

Sample Response

Status code:

200

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

Definições

Nome	Description
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.

Nome	Tipo	Description
error	ErrorDetails	Detalhes do erro para a solicitação atual.

ErrorDetails

As informações detalhadas do erro.

Nome	Tipo	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.

Nome	Tipo	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.

Nome	Tipo	Description
symmetricKey	SymmetricKey	As credenciais de chave simétrica para esse atestado.
type	string: symmetricKey	Tipo do atestado.

Tpm

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

Nome	Tipo	Description
endorsementKey	string	A chave de endosso do TPM para essa credencial.

TpmAttestation

A definição de atestado do TPM.

Nome	Tipo	Description
tpm	Tpm	As credenciais do TPM para esse atestado.
type	string: tpm	Tipo do atestado.

X509

A definição X509.

Nome	Tipo	Description
clientCertificates	X509Certificates	Os certificados de cliente X.509 para essa credencial.

X509Attestation

A definição de atestado X509.

Nome	Tipo	Description
type	string: x509	Tipo do atestado.
x509	X509	As credenciais X.509 para esse atestado.

X509Certificate

A definição do certificado X509.

Nome	Tipo	Description
certificate	string	A representação de cadeia de caracteres desse certificado.
info	X509CertificateInfo	Informações sobre esse certificado.

X509CertificateInfo

As informações do certificado X509.

Nome	Tipo	Description
sha1Thumbprint	string	O valor de hash SHA-1 do certificado.

X509Certificates

A definição de certificados X509.

Nome	Tipo	Description
primary	X509Certificate	O certificado X.509 primário para essa credencial.
secondary	X509Certificate	O certificado X.509 secundário para essa credencial.