Devices - Get Attestation

Gerätebestätigung abrufen

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

URI-Parameter

Name In Required Type Description
baseDomain
path True
  • string

Die Basisdomäne für alle Azure IoT Central-Dienstanforderungen.

deviceId
path True
  • string

Eindeutige ID des Geräts.

subdomain
path True
  • string

Die Anwendungsdomäne.

api-version
query True
  • string

Die Aufgerufene Version der API.

Antworten

Name Type Description
200 OK Attestation:

Erfolg

Other Status Codes

Eine Fehlerantwort, die vom IoT Central Service empfangen wurde.

Headers

  • x-ms-error-code: string

Sicherheit

azure_auth

Azure Active Directory OAuth2-Fluss

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

Scopes

Name Description
user_impersonation Identitätswechsel Ihres Benutzerkontos

Beispiele

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

Definitionen

Error

Die Antwortfehlerdefinition.

ErrorDetails

Die Detailinformationen des Fehlers.

SymmetricKey

Die symmetrische Schlüsseldefinition.

SymmetricKeyAttestation

Die symmetrische Schlüsselbestätigungsdefinition.

Tpm

Die Definition des vertrauenswürdigen Plattformmoduls.

TpmAttestation

Die TPM-Zertifizierungsdefinition.

X509

Die X509-Definition.

X509Attestation

Die X509-Zertifizierungsdefinition.

X509Certificate

Die X509-Zertifikatdefinition.

X509CertificateInfo

Die X509-Zertifikatinformationen.

X509Certificates

Die X509-Zertifikatdefinition.

Error

Die Antwortfehlerdefinition.

Name Type Description
error

Fehlerdetails für aktuelle Anforderung.

ErrorDetails

Die Detailinformationen des Fehlers.

Name Type Description
code
  • string

Fehlercode

message
  • string

Fehlermeldungsdetails.

requestId
  • string

Korrelations-ID für aktuelle Anforderung.

time
  • string

Der Zeitpunkt, an dem die Fehleranforderung fehlgeschlagen ist.

SymmetricKey

Die symmetrische Schlüsseldefinition.

Name Type Description
primaryKey
  • string

Der Primärschlüssel für diese Anmeldeinformationen.

secondaryKey
  • string

Der sekundäre Schlüssel für diese Anmeldeinformationen.

SymmetricKeyAttestation

Die symmetrische Schlüsselbestätigungsdefinition.

Name Type Description
symmetricKey

Die symmetrischen Schlüsselanmeldeinformationen für diese Bestätigung.

type string:
  • symmetricKey

Typ der Bescheinigung.

Tpm

Die Definition des vertrauenswürdigen Plattformmoduls.

Name Type Description
endorsementKey
  • string

Der TPM-Bestätigungsschlüssel für diese Anmeldeinformationen.

TpmAttestation

Die TPM-Zertifizierungsdefinition.

Name Type Description
tpm

Die TPM-Anmeldeinformationen für diese Bestätigung.

type string:
  • tpm

Typ der Bescheinigung.

X509

Die X509-Definition.

Name Type Description
clientCertificates

Die X.509-Clientzertifikate für diese Anmeldeinformationen.

X509Attestation

Die X509-Zertifizierungsdefinition.

Name Type Description
type string:
  • x509

Typ der Bescheinigung.

x509

Die X.509-Anmeldeinformationen für diese Bestätigung.

X509Certificate

Die X509-Zertifikatdefinition.

Name Type Description
certificate
  • string

Die Zeichenfolgendarstellung dieses Zertifikats.

info

Informationen zu diesem Zertifikat.

X509CertificateInfo

Die X509-Zertifikatinformationen.

Name Type Description
sha1Thumbprint
  • string

Der SHA-1-Hashwert des Zertifikats.

X509Certificates

Die X509-Zertifikatdefinition.

Name Type Description
primary

Das primäre X.509-Zertifikat für diese Anmeldeinformationen.

secondary

Das sekundäre X.509-Zertifikat für diese Anmeldeinformationen.