워크플로 정책 가져오기
지정된 워크플로에 대한 프로필 템플릿 정책을 가져옵니다. 데이터는 요청을 만드는 동안 사용됩니다. 워크플로 정책은 요청을 만들기 위해 클라이언트에 필요한 데이터를 지정합니다. 데이터에는 다양한 데이터 수집 항목, 요청 주석 및 일회성 암호 정책이 포함될 수 있습니다.
메모
이 문서의 URL은 API 배포 중에 선택한 호스트 이름(예: https://api.contoso.com)을 기준으로 합니다.
요청
| 메서드 | 요청 URL |
|---|---|
| 가져오기 | /CertificateManagement/api/v1.0/profiletemplates/{id}/policy/workflow/{type} |
URL 매개 변수
| 매개 변수 | 설명 |
|---|---|
| 아이디 | 필수 사항입니다. 정책을 추출할 프로필 템플릿에 해당하는 GUID입니다. |
| 유형 | 필수 사항입니다. 요청되는 정책의 유형입니다. 가능한 값은 "등록", "중복", "OfflineUnblock", "OnlineUpdate", "갱신", "복구", "RecoverOnBehalf", "복원", "사용 중지", "해지", "임시Enroll" 및 "차단 해제"입니다. |
요청 헤더
일반적인 요청 헤더는 CM REST API 서비스 세부 정보 HTTP 요청 및 응답 헤더를 참조하세요.
요청 메시지 본문
없음.
응답
이 섹션에서는 응답에 대해 설명합니다.
응답 코드
| 코드 | 설명 |
|---|---|
| 200 | 그래 |
| 403 | 금지 |
| 204 | 콘텐츠 없음 |
| 500 | 내부 오류 |
응답 헤더
일반적인 응답 헤더는 CM REST API 서비스 세부 정보 HTTP 요청 및 응답 헤더를 참조하세요.
응답 메시지 본문
성공하면 ProfileTemplatePolicy 개체를 기반으로 하는 정책 개체를 반환합니다. 최소한 정책 개체는 다음 표의 속성을 포함하지만 요청된 정책에 따라 추가 속성을 포함할 수 있습니다. 예를 들어 등록 정책에 대한 요청은 EnrollPolicy 개체를 반환합니다. 자세한 내용은 요청의 {type} 매개 변수와 연결된 정책 개체에 대한 설명서를 참조하세요. 다양한 유형의 정책 개체에 대한 설명서는 Microsoft.Clm.Shared.ProfileTemplates 네임스페이스 설명서에서 찾을 수 있습니다.
| 재산 | 설명 |
|---|---|
| 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 요청에 대한 일회성 암호에 대한 배포 방법입니다. |
| 개인화 | 정책에 대한 스마트 카드 개인 설정 옵션입니다. |
| 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