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