Devices - Get Attestation

Szolgáltatás:

IoT Central

API-verzió:

2022-07-31

Eszközigazolás lekérése

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

URI-paraméterek

Name	In	Kötelező	Típus	Description
baseDomain	path	True	string	Az Azure IoT Central szolgáltatáskéréseinek alaptartománya.
deviceId	path	True	string	Az eszköz egyedi azonosítója.
subdomain	path	True	string	Az alkalmazás altartománya.
api-version	query	True	string	A meghívott API verziója.

Válaszok

Name	Típus	Description
200 OK	Attestation: SymmetricKeyAttestation TpmAttestation X509Attestation	Siker
Other Status Codes	Error	Hibaválasz érkezett az IoT Central szolgáltatástól. Fejlécek x-ms-error-code: string

Biztonság

azure_auth

Azure Active Directory OAuth2 Flow

Típus: oauth2
Folyamat: implicit
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/authorize

Hatókörök

Name	Description
user_impersonation	a felhasználói fiók megszemélyesítése

Példák

Get device attestation

Mintakérelem

HTTP

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

Mintaválasz

Állapotkód:

200

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

Definíciók

Name	Description
Error	A válaszhiba definíciója.
ErrorDetails	A hiba részletes információi.
SymmetricKey	A szimmetrikus kulcsdefiníció.
SymmetricKeyAttestation	A szimmetrikus kulcsigazolási definíció.
Tpm	A megbízható platformmodul definíciója.
TpmAttestation	A TPM igazolási definíciója.
X509	Az X509-definíció.
X509Attestation	Az X509 igazolás definíciója.
X509Certificate	Az X509-tanúsítvány definíciója.
X509CertificateInfo	Az X509-tanúsítvány adatai.
X509Certificates	Az X509-tanúsítványok definíciója.

Error

Objektum

A válaszhiba definíciója.

Name	Típus	Description
error	ErrorDetails	Az aktuális kérés hibaadatai.

ErrorDetails

Objektum

A hiba részletes információi.

Name	Típus	Description
code	string	Hibakód.
message	string	Hibaüzenet részletei.
requestId	string	Az aktuális kérés korrelációs azonosítója.
time	string (date-time-rfc1123)	A hibakérés sikertelen volt.

SymmetricKey

Objektum

A szimmetrikus kulcsdefiníció.

Name	Típus	Description
primaryKey	string	A hitelesítő adatok elsődleges kulcsa.
secondaryKey	string	A hitelesítő adatok másodlagos kulcsa.

SymmetricKeyAttestation

Objektum

A szimmetrikus kulcsigazolási definíció.

Name	Típus	Description
symmetricKey	SymmetricKey	Az igazolás szimmetrikus kulcsának hitelesítő adatai.
type	string: symmetricKey	Az igazolás típusa.

Tpm

Objektum

A megbízható platformmodul definíciója.

Name	Típus	Description
endorsementKey	string	A hitelesítő adatok TPM-jóváhagyási kulcsa.

TpmAttestation

Objektum

A TPM igazolási definíciója.

Name	Típus	Description
tpm	Tpm	Az igazoláshoz tartozó TPM-hitelesítő adatok.
type	string: tpm	Az igazolás típusa.

X509

Objektum

Az X509-definíció.

Name	Típus	Description
clientCertificates	X509Certificates	A hitelesítő adatok X.509-ügyféltanúsítványai.

X509Attestation

Objektum

Az X509 igazolás definíciója.

Name	Típus	Description
type	string: x509	Az igazolás típusa.
x509	X509	Az igazoláshoz tartozó X.509-hitelesítő adatok.

X509Certificate

Objektum

Az X509-tanúsítvány definíciója.

Name	Típus	Description
certificate	string	A tanúsítvány sztring-ábrázolása.
info	X509CertificateInfo	A tanúsítványsal kapcsolatos információk.

X509CertificateInfo

Objektum

Az X509-tanúsítvány adatai.

Name	Típus	Description
sha1Thumbprint	string	A tanúsítvány SHA-1 kivonatértéke.

X509Certificates

Objektum

Az X509-tanúsítványok definíciója.

Name	Típus	Description
primary	X509Certificate	A hitelesítő adatok elsődleges X.509-tanúsítványa.
secondary	X509Certificate	A hitelesítő adatok másodlagos X.509-tanúsítványa.