Devices - Get Attestation

디바이스 증명 가져오기

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

URI 매개 변수

Name In Required Type Description
baseDomain
path True
  • string

모든 Azure IoT Central 서비스 요청에 대한 기본 도메인입니다.

deviceId
path True
  • string

디바이스의 고유 ID입니다.

subdomain
path True
  • string

애플리케이션 하위 도메인입니다.

api-version
query True
  • string

호출되는 API의 버전입니다.

응답

Name Type Description
200 OK Attestation:

Success

Other Status Codes

IoT Central 서비스에서 받은 오류 응답입니다.

Headers

  • x-ms-error-code: string

보안

azure_auth

Azure Active Directory OAuth2 Flow

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

Scopes

Name Description
user_impersonation 사용자 계정 가장

예제

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

정의

Error

응답 오류 정의입니다.

ErrorDetails

오류의 세부 정보입니다.

SymmetricKey

대칭 키 정의입니다.

SymmetricKeyAttestation

대칭 키 증명 정의입니다.

Tpm

신뢰할 수 있는 플랫폼 모듈 정의입니다.

TpmAttestation

TPM 증명 정의입니다.

X509

X509 정의입니다.

X509Attestation

X509 증명 정의입니다.

X509Certificate

X509 인증서 정의입니다.

X509CertificateInfo

X509 인증서 정보입니다.

X509Certificates

X509 인증서 정의입니다.

Error

응답 오류 정의입니다.

Name Type Description
error

현재 요청에 대한 오류 세부 정보입니다.

ErrorDetails

오류의 세부 정보입니다.

Name Type Description
code
  • string

오류 코드

message
  • string

오류 메시지 세부 정보입니다.

requestId
  • string

현재 요청에 대한 상관 관계 ID입니다.

time
  • string

오류 요청이 실패한 시간입니다.

SymmetricKey

대칭 키 정의입니다.

Name Type Description
primaryKey
  • string

이 자격 증명의 기본 키입니다.

secondaryKey
  • string

이 자격 증명의 보조 키입니다.

SymmetricKeyAttestation

대칭 키 증명 정의입니다.

Name Type Description
symmetricKey

이 증명에 대한 대칭 키 자격 증명입니다.

type string:
  • symmetricKey

증명의 유형입니다.

Tpm

신뢰할 수 있는 플랫폼 모듈 정의입니다.

Name Type Description
endorsementKey
  • string

이 자격 증명에 대한 TPM 인증 키입니다.

TpmAttestation

TPM 증명 정의입니다.

Name Type Description
tpm

이 증명에 대한 TPM 자격 증명입니다.

type string:
  • tpm

증명의 유형입니다.

X509

X509 정의입니다.

Name Type Description
clientCertificates

이 자격 증명에 대한 X.509 클라이언트 인증서입니다.

X509Attestation

X509 증명 정의입니다.

Name Type Description
type string:
  • x509

증명의 유형입니다.

x509

이 증명에 대한 X.509 자격 증명입니다.

X509Certificate

X509 인증서 정의입니다.

Name Type Description
certificate
  • string

이 인증서의 문자열 표현입니다.

info

이 인증서에 대한 정보입니다.

X509CertificateInfo

X509 인증서 정보입니다.

Name Type Description
sha1Thumbprint
  • string

인증서의 SHA-1 해시 값입니다.

X509Certificates

X509 인증서 정의입니다.

Name Type Description
primary

이 자격 증명에 대한 기본 X.509 인증서입니다.

secondary

이 자격 증명에 대한 보조 X.509 인증서입니다.