Devices - Get Attestation

Mendapatkan pengesahan perangkat

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

Parameter URI

Name In Required Type Description
baseDomain
path True
  • string

Domain dasar untuk semua permintaan layanan Azure IoT Central.

deviceId
path True
  • string

ID unik perangkat.

subdomain
path True
  • string

Subdomain aplikasi.

api-version
query True
  • string

Versi API yang dipanggil.

Respons

Name Type Description
200 OK Attestation:

Berhasil

Other Status Codes

Respons kesalahan diterima dari IoT Central Service.

Headers

  • x-ms-error-code: string

Keamanan

azure_auth

Alur OAuth2 Azure Active Directory

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

Scopes

Name Description
user_impersonation meniru akun pengguna Anda

Contoh

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

Definisi

Error

Definisi kesalahan respons.

ErrorDetails

Informasi detail kesalahan.

SymmetricKey

Definisi kunci konten.

SymmetricKeyAttestation

Definisi pengesahan kunci konten.

Tpm

Definisi modul platform tepercaya.

TpmAttestation

Definisi pengesahan TPM.

X509

Definisi X509.

X509Attestation

Definisi pengesahan X509.

X509Certificate

Definisi sertifikat X509.

X509CertificateInfo

Info sertifikat X509.

X509Certificates

Definisi sertifikat X509.

Error

Definisi kesalahan respons.

Name Type Description
error

Detail kesalahan untuk permintaan saat ini.

ErrorDetails

Informasi detail kesalahan.

Name Type Description
code
  • string

Kode Kesalahan.

message
  • string

Detail pesan kesalahan.

requestId
  • string

Id Korelasi untuk permintaan saat ini.

time
  • string

Waktu permintaan kesalahan gagal.

SymmetricKey

Definisi kunci konten.

Name Type Description
primaryKey
  • string

Kunci primer untuk kredensial ini.

secondaryKey
  • string

Kunci sekunder untuk kredensial ini.

SymmetricKeyAttestation

Definisi pengesahan kunci konten.

Name Type Description
symmetricKey

Info masuk kunci konten untuk pengesahan ini.

type string:
  • symmetricKey

Jenis pengesahan.

Tpm

Definisi modul platform tepercaya.

Name Type Description
endorsementKey
  • string

Kunci dukungan TPM untuk kredensial ini.

TpmAttestation

Definisi pengesahan TPM.

Name Type Description
tpm

Kredensial TPM untuk pengesahan ini.

type string:
  • tpm

Jenis pengesahan.

X509

Definisi X509.

Name Type Description
clientCertificates

Sertifikat klien X.509 untuk kredensial ini.

X509Attestation

Definisi pengesahan X509.

Name Type Description
type string:
  • x509

Jenis pengesahan.

x509

Kredensial X.509 untuk pengesahan ini.

X509Certificate

Definisi sertifikat X509.

Name Type Description
certificate
  • string

Representasi string sertifikat ini.

info

Informasi tentang sertifikat ini.

X509CertificateInfo

Info sertifikat X509.

Name Type Description
sha1Thumbprint
  • string

Nilai hash SHA-1 sertifikat.

X509Certificates

Definisi sertifikat X509.

Name Type Description
primary

Sertifikat X.509 utama untuk kredensial ini.

secondary

Sertifikat X.509 sekunder untuk kredensial ini.