Devices - Get Attestation

Service:

IoT Central

API Version:

2022-07-31

デバイス構成証明を取得する

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

URI パラメーター

名前	/	必須	型	説明
baseDomain	path	True	string	すべての Azure IoT Central サービス要求の基本ドメイン。
deviceId	path	True	string	デバイスの一意の ID。
subdomain	path	True	string	アプリケーション サブドメイン。
api-version	query	True	string	呼び出される API のバージョン。

応答

名前	型	説明
200 OK	Attestation: SymmetricKeyAttestation TpmAttestation X509Attestation	Success
Other Status Codes	Error	IoT Central サービスから受信したエラー応答。 Headers x-ms-error-code: string

セキュリティ

azure_auth

Azure Active Directory OAuth2 フロー

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

Scopes

名前	説明
user_impersonation	ユーザー アカウントの借用

例

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

定義

名前	説明
Error	応答エラーの定義。
ErrorDetails	エラーの詳細情報。
SymmetricKey	対称キーの定義。
SymmetricKeyAttestation	対称キー構成証明の定義。
Tpm	信頼できるプラットフォーム モジュールの定義。
TpmAttestation	TPM 構成証明の定義。
X509	X509 定義。
X509Attestation	X509 構成証明の定義。
X509Certificate	X509 証明書の定義。
X509CertificateInfo	X509 証明書情報。
X509Certificates	X509 証明書の定義。

Error

応答エラーの定義。

名前	型	説明
error	ErrorDetails	現在の要求のエラーの詳細。

ErrorDetails

エラーの詳細情報。

名前	型	説明
code	string	エラー コード。
message	string	エラー メッセージの詳細。
requestId	string	現在の要求の関連付け ID。
time	string	エラー要求が失敗した時刻。

SymmetricKey

対称キーの定義。

名前	型	説明
primaryKey	string	この資格情報の主キー。
secondaryKey	string	この資格情報のセカンダリ キー。

SymmetricKeyAttestation

対称キー構成証明の定義。

名前	型	説明
symmetricKey	SymmetricKey	この構成証明の対称キー資格情報。
type	string: symmetricKey	構成証明の種類。

Tpm

信頼できるプラットフォーム モジュールの定義。

名前	型	説明
endorsementKey	string	この資格情報の TPM 保証キー。

TpmAttestation

TPM 構成証明の定義。

名前	型	説明
tpm	Tpm	この構成証明の TPM 資格情報。
type	string: tpm	構成証明の種類。

X509

X509 定義。

名前	型	説明
clientCertificates	X509Certificates	この資格情報の X.509 クライアント証明書。

X509Attestation

X509 構成証明の定義。

名前	型	説明
type	string: x509	構成証明の種類。
x509	X509	この構成証明の X.509 資格情報。

X509Certificate

X509 証明書の定義。

名前	型	説明
certificate	string	この証明書の文字列表現。
info	X509CertificateInfo	この証明書に関する情報。

X509CertificateInfo

X509 証明書情報。

名前	型	説明
sha1Thumbprint	string	証明書の SHA-1 ハッシュ値。

X509Certificates

X509 証明書の定義。

名前	型	説明
primary	X509Certificate	この資格情報のプライマリ X.509 証明書。
secondary	X509Certificate	この資格情報のセカンダリ X.509 証明書。