스마트 카드 제안 PIN 가져오기
서버에서 생성된 사용자 PIN을 가져옵니다.
중요
프로필 템플릿 정책이 PIN을 수행해야 한다고 나타내는 경우에만 서버에서 PIN을 설정합니다. 그렇지 않으면 사용자가 PIN을 제공해야 합니다.
참고
이 문서의 URL은 API 배포 중에 선택한 호스트 이름(예: https://api.contoso.com)을 기준으로 합니다.
요청
| 메서드 | 요청 URL |
|---|---|
| GET | /CertificateManagement/api/v1.0/smartcards/{id}/serverproposedpin |
URL 매개 변수
| 매개 변수 | Description |
|---|---|
| id | MIM(Microsoft Identity Manager) CM(인증서 관리)과 관련된 스마트 카드 ID입니다. ID는 Microsft.Clm.Shared.Smartcard 개체에서 가져옵니다. |
쿼리 매개 변수
| 매개 변수 | Description |
|---|---|
| atr | 스마트 카드 ATR(재설정 응답) 문자열입니다. |
| cardid | 스마트 카드 ID입니다. |
| challenge | 스마트 카드에서 발급한 챌린지를 나타내는 base-64로 인코딩된 문자열입니다. |
요청 헤더
일반적인 요청 헤더는 CM REST API 서비스 세부 정보의HTTP 요청 및 응답 헤더를 참조하세요.
요청 본문
없음
응답
이 섹션에서는 응답에 대해 설명합니다.
응답 코드
| 코드 | Description |
|---|---|
| 200 | 확인 |
| 204 | 내용 없음 |
| 403 | 사용할 수 없음 |
| 500 | 내부 오류 |
응답 헤더
일반적인 응답 헤더는 CM REST API 서비스 세부 정보의HTTP 요청 및 응답 헤더를 참조하세요.
응답 본문
성공하면 서버에서 제안한 PIN을 나타내는 문자열을 반환합니다.
예
이 섹션에서는 서버에서 생성된 사용자 PIN을 가져오는 예제를 제공합니다.
예: 요청
GET GET /CertificateManagement/api/v1.0/smartcards/C6BAD97C-F97F-4920-8947-BE980C98C6B5/serverproposedpin HTTP/1.1
예: 응답
HTTP/1.1 200 OK
... body coming soon