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 매개 변수

Name	In(다음 안에)	필수	형식	Description
baseDomain	path	True	string	모든 Azure IoT Central 서비스 요청에 대한 기본 도메인입니다.
deviceId	path	True	string	디바이스의 고유 ID입니다.
subdomain	path	True	string	애플리케이션 하위 도메인입니다.
api-version	query	True	string	호출되는 API의 버전입니다.

응답

Name	형식	Description
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 Flow

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

Scopes

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

정의

Name	Description
Error	응답 오류 정의입니다.
ErrorDetails	오류의 세부 정보입니다.
SymmetricKey	대칭 키 정의입니다.
SymmetricKeyAttestation	대칭 키 증명 정의입니다.
Tpm	신뢰할 수 있는 플랫폼 모듈 정의입니다.
TpmAttestation	TPM 증명 정의입니다.
X509	X509 정의입니다.
X509Attestation	X509 증명 정의입니다.
X509Certificate	X509 인증서 정의입니다.
X509CertificateInfo	X509 인증서 정보입니다.
X509Certificates	X509 인증서 정의입니다.

Error

응답 오류 정의입니다.

Name	형식	Description
error	ErrorDetails	현재 요청에 대한 오류 세부 정보입니다.

ErrorDetails

오류의 세부 정보입니다.

Name	형식	Description
code	string	오류 코드
message	string	오류 메시지 세부 정보입니다.
requestId	string	현재 요청에 대한 상관 관계 ID입니다.
time	string	오류 요청이 실패한 시간입니다.

SymmetricKey

대칭 키 정의입니다.

Name	형식	Description
primaryKey	string	이 자격 증명의 기본 키입니다.
secondaryKey	string	이 자격 증명의 보조 키입니다.

SymmetricKeyAttestation

대칭 키 증명 정의입니다.

Name	형식	Description
symmetricKey	SymmetricKey	이 증명에 대한 대칭 키 자격 증명입니다.
type	string: symmetricKey	증명의 유형입니다.

Tpm

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

Name	형식	Description
endorsementKey	string	이 자격 증명에 대한 TPM 인증 키입니다.

TpmAttestation

TPM 증명 정의입니다.

Name	형식	Description
tpm	Tpm	이 증명에 대한 TPM 자격 증명입니다.
type	string: tpm	증명의 유형입니다.

X509

X509 정의입니다.

Name	형식	Description
clientCertificates	X509Certificates	이 자격 증명에 대한 X.509 클라이언트 인증서입니다.

X509Attestation

X509 증명 정의입니다.

Name	형식	Description
type	string: x509	증명의 유형입니다.
x509	X509	이 증명에 대한 X.509 자격 증명입니다.

X509Certificate

X509 인증서 정의입니다.

Name	형식	Description
certificate	string	이 인증서의 문자열 표현입니다.
info	X509CertificateInfo	이 인증서에 대한 정보입니다.

X509CertificateInfo

X509 인증서 정보입니다.

Name	형식	Description
sha1Thumbprint	string	인증서의 SHA-1 해시 값입니다.

X509Certificates

X509 인증서 정의입니다.

Name	형식	Description
primary	X509Certificate	이 자격 증명에 대한 기본 X.509 인증서입니다.
secondary	X509Certificate	이 자격 증명에 대한 보조 X.509 인증서입니다.