스마트 카드 정책 가져오기
지정된 워크플로의 프로필 템플릿 정책을 가져옵니다. 이 데이터는 요청을 만드는 동안 사용됩니다. 워크플로 정책은 클라이언트가 요청을 만들기 위해 필요한 데이터를 지정합니다. 데이터에는 다양한 데이터 수집 항목, 요청 주석 및 일회성 암호 정책이 포함될 수 있습니다.
참고
이 문서의 URL은 API 배포 중에 선택한 호스트 이름(예: https://api.contoso.com)을 기준으로 합니다.
요청
| 메서드 | 요청 URL |
|---|---|
| GET | /CertificateManagement/api/v1.0/profiletemplates/{id}/policy/workflow/{type} |
URL 매개 변수
| 매개 변수 | Description |
|---|---|
| id | 필수 요소. 정책을 추출하는 프로필 템플릿에 해당하는 GUID입니다. |
| 형식 | 필수 요소. 요청한 정책의 형식입니다. 가능한 값은 "등록", "중복", "OfflineUnblock", "OnlineUpdate", "갱신", "복구", "RecoverOnBehalf", "복원", "사용 중지", "해지", "TemporaryEnroll" 및 "차단 해제"입니다. |
요청 헤더
일반적인 요청 헤더는 CM REST API 서비스 세부 정보의HTTP 요청 및 응답 헤더를 참조하세요.
요청 본문
없음
응답
이 섹션에서는 응답을 설명합니다.
응답 코드
| 코드 | Description |
|---|---|
| 200 | 확인 |
| 403 | 사용할 수 없음 |
| 204 | 내용 없음 |
| 500 | 내부 오류 |
응답 헤더
일반적인 응답 헤더는 CM REST API 서비스 세부 정보의HTTP 요청 및 응답 헤더를 참조하세요.
응답 본문
성공 시 ProfileTemplatePolicy 개체에 따라 정책 개체를 반환합니다. 최소한 정책 개체는 다음 표의 속성을 포함하지만 요청된 정책에 따라 추가 속성을 포함할 수 있습니다. 예를 들어 등록 정책에 대한 요청은 EnrollPolicy 개체를 반환합니다. 자세한 내용은 요청의 {type} 매개 변수와 관련된 정책 개체에 대한 설명서를 참조하세요. 다양한 유형의 정책 개체에 대한 설명서는 Microsoft.Clm.Shared.ProfileTemplates 네임스페이스 설명서에서 찾을 수 있습니다.
| 속성 | Description |
|---|---|
| ApprovalsNeeded | 정책에 대한 FIM(Forefront Identity Manager) CM(인증서 관리) 요청에 필요한 승인 수입니다. |
| AuthorizedApprover | 정책의 FIM CM 요청을 승인할 수 있는 권한이 있는 사용자에 대한 보안 설명자입니다. |
| AuthorizedEnrollmentAgent | 정책의 등록 에이전트 역할을 수행할 수 있는 사용자에 대한 보안 설명자입니다. |
| AuthorizedInitiator | 정책의 FIM CM 요청을 시작할 수 있는 사용자에 대한 보안 설명자입니다. |
| CollectComments | 정책의 FIM CM 요청에 대해 설명 컬렉션을 사용할 수 있는지 여부를 나타내는 부울 값입니다. |
| CollectRequestPriority | 정책의 FIM CM 요청에 대해 요청 우선 순위 컬렉션을 사용할 수 있는지 여부를 나타내는 부울 값입니다. |
| DefaultRequestPriority | 정책의 FIM CM 요청에 대한 기본 우선 순위입니다. |
| 문서 | 정책에 대해 구성된 정책 문서입니다. |
| 사용 | 정책을 사용할 수 있는지 여부를 나타내는 부울 값입니다. |
| EnrollAgentRequired | 정책의 FIM CM 요청에 등록 에이전트가 필요한지 여부를 나타내는 부울 값입니다. |
| OneTimePasswordPolicy | 정책에 대한 FIM CM 요청에 대한 일회성 암호에 대한 배포 방법입니다. |
| Personalization | 정책의 스마트 카드 개인 설정 옵션입니다. |
| PolicyDataCollection | 정책과 관련된 데이터 컬렉션 항목입니다. |
| SelfServiceEnabled | 정책의 FIM CM 요청에 대해 셀프 서비스 시작을 사용할 수 있는지 여부를 나타내는 부울 값입니다. |
예
이 섹션에서는 워크플로에 대한 프로필 템플릿 정책을 가져오는 예제를 제공합니다.
예: 요청 1
GET /CertificateManagement/api/v1.0/profiletemplates/97CD65FA-AF4B-4587-9309-0DD6BFD8B4E1/policies/enroll HTTP/1.1
예: 응답 1
HTTP/1.1 200 OK
... body coming soon
예: 요청 2
GET /CertificateManagement/api/v1.0/profiletemplates/97CD65FA-AF4B-4587-9309-0DD6BFD8B4E1/policies/renew HTTP/1.1
예: 응답 2
HTTP/1.1 200 OK
... body coming soon