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