Devices - Get Attestation

Servicio:

IoT Central

Versión de la API:

2022-07-31

Obtención de la atestación de dispositivos

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
baseDomain	path	True	string	Dominio base para todas las solicitudes de servicio de Azure IoT Central.
deviceId	path	True	string	Identificador único del dispositivo.
subdomain	path	True	string	Subdominio de aplicación.
api-version	query	True	string	Versión de la API a la que se llama.

Respuestas

Nombre	Tipo	Description
200 OK	Attestation: SymmetricKeyAttestation TpmAttestation X509Attestation	Éxito
Other Status Codes	Error	Respuesta de error recibida del servicio IoT Central. Encabezados x-ms-error-code: string

Seguridad

azure_auth

Flujo de OAuth2 de Azure Active Directory

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre	Description
user_impersonation	suplantar la cuenta de usuario

Ejemplos

Get device attestation

Solicitud de ejemplo

HTTP

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

Respuesta de muestra

status code:

200

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

Definiciones

Nombre	Description
Error	Definición de error de respuesta.
ErrorDetails	Información detallada del error.
SymmetricKey	Definición de clave simétrica.
SymmetricKeyAttestation	Definición de atestación de clave simétrica.
Tpm	Definición del módulo de plataforma segura.
TpmAttestation	Definición de atestación de TPM.
X509	Definición X509.
X509Attestation	Definición de atestación X509.
X509Certificate	Definición del certificado X509.
X509CertificateInfo	Información del certificado X509.
X509Certificates	Definición de certificados X509.

Error

Object

Definición de error de respuesta.

Nombre	Tipo	Description
error	ErrorDetails	Detalles del error de la solicitud actual.

ErrorDetails

Object

Información detallada del error.

Nombre	Tipo	Description
code	string	Código de error.
message	string	Detalles del mensaje de error.
requestId	string	Id. de correlación para la solicitud actual.
time	string (date-time-rfc1123)	Hora en que se produjo un error en la solicitud de error.

SymmetricKey

Object

Definición de clave simétrica.

Nombre	Tipo	Description
primaryKey	string	Clave principal de esta credencial.
secondaryKey	string	Clave secundaria para esta credencial.

SymmetricKeyAttestation

Object

Definición de atestación de clave simétrica.

Nombre	Tipo	Description
symmetricKey	SymmetricKey	Credenciales de clave simétrica para esta atestación.
type	string: symmetricKey	Tipo de atestación.

Tpm

Object

Definición del módulo de plataforma segura.

Nombre	Tipo	Description
endorsementKey	string	Clave de aprobación de TPM para esta credencial.

TpmAttestation

Object

Definición de atestación de TPM.

Nombre	Tipo	Description
tpm	Tpm	Credenciales de TPM para esta atestación.
type	string: tpm	Tipo de atestación.

X509

Object

Definición X509.

Nombre	Tipo	Description
clientCertificates	X509Certificates	Los certificados de cliente X.509 para esta credencial.

X509Attestation

Object

Definición de atestación X509.

Nombre	Tipo	Description
type	string: x509	Tipo de atestación.
x509	X509	Credenciales X.509 para esta atestación.

X509Certificate

Object

Definición del certificado X509.

Nombre	Tipo	Description
certificate	string	Representación de cadena de este certificado.
info	X509CertificateInfo	Información sobre este certificado.

X509CertificateInfo

Object

Información del certificado X509.

Nombre	Tipo	Description
sha1Thumbprint	string	Valor hash SHA-1 del certificado.

X509Certificates

Object

Definición de certificados X509.

Nombre	Tipo	Description
primary	X509Certificate	Certificado X.509 principal para esta credencial.
secondary	X509Certificate	Certificado X.509 secundario para esta credencial.