Devices - Get Attestation

Service:

IoT Central

API Version:

2022-07-31

Mendapatkan pengesahan perangkat

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

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
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

Nama	Jenis	Deskripsi
200 OK	Attestation: SymmetricKeyAttestation TpmAttestation X509Attestation	Berhasil
Other Status Codes	Error	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

Nama	Deskripsi
user_impersonation	meniru akun pengguna Anda

Contoh

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

Definisi

Nama	Deskripsi
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.

Nama	Jenis	Deskripsi
error	ErrorDetails	Detail kesalahan untuk permintaan saat ini.

ErrorDetails

Informasi detail kesalahan.

Nama	Jenis	Deskripsi
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.

Nama	Jenis	Deskripsi
primaryKey	string	Kunci primer untuk kredensial ini.
secondaryKey	string	Kunci sekunder untuk kredensial ini.

SymmetricKeyAttestation

Definisi pengesahan kunci konten.

Nama	Jenis	Deskripsi
symmetricKey	SymmetricKey	Info masuk kunci konten untuk pengesahan ini.
type	string: symmetricKey	Jenis pengesahan.

Tpm

Definisi modul platform tepercaya.

Nama	Jenis	Deskripsi
endorsementKey	string	Kunci dukungan TPM untuk kredensial ini.

TpmAttestation

Definisi pengesahan TPM.

Nama	Jenis	Deskripsi
tpm	Tpm	Kredensial TPM untuk pengesahan ini.
type	string: tpm	Jenis pengesahan.

X509

Definisi X509.

Nama	Jenis	Deskripsi
clientCertificates	X509Certificates	Sertifikat klien X.509 untuk kredensial ini.

X509Attestation

Definisi pengesahan X509.

Nama	Jenis	Deskripsi
type	string: x509	Jenis pengesahan.
x509	X509	Kredensial X.509 untuk pengesahan ini.

X509Certificate

Definisi sertifikat X509.

Nama	Jenis	Deskripsi
certificate	string	Representasi string sertifikat ini.
info	X509CertificateInfo	Informasi tentang sertifikat ini.

X509CertificateInfo

Info sertifikat X509.

Nama	Jenis	Deskripsi
sha1Thumbprint	string	Nilai hash SHA-1 sertifikat.

X509Certificates

Definisi sertifikat X509.

Nama	Jenis	Deskripsi
primary	X509Certificate	Sertifikat X.509 utama untuk kredensial ini.
secondary	X509Certificate	Sertifikat X.509 sekunder untuk kredensial ini.