Получение политики рабочего процесса
Возвращает политику шаблона профиля для указанного рабочего процесса. Данные используются во время создания запроса. Политика рабочих процессов указывает, какие данные необходимы клиенту для создания запроса. Данные могут включать различные элементы сбора данных, комментарии запросов и политику одноразовых паролей.
Примечание
URL-адреса в этой статье относятся к имени узла, выбранному во время развертывания API, например https://api.contoso.com.
Запрос
| Метод | URL-адрес запроса |
|---|---|
| GET | /CertificateManagement/api/v1.0/profiletemplates/{id}/policy/workflow/{type} |
Параметры URL-адреса
| Параметр | Описание |
|---|---|
| идентификатор | Обязательный. Идентификатор GUID, соответствующий шаблону профиля, из которого извлекается политика. |
| тип | Обязательный. Тип запрашиваемой политики. Возможные значения: "Enroll", "Duplicate", "OfflineUnblock", "OnlineUpdate", "Renew", "Recover", "RecoverOnBehalf", "Reinstate", "Retire", "Revoke", "TemporaryEnroll" и "Unblock". |
Заголовки запросов
Общие заголовки запросов см. в разделе Заголовки HTTP-запросов и ответов в службе REST API CM.
Текст запроса
Нет.
Ответ
В этом разделе описывается ответ.
Коды ответов
| Код | Описание |
|---|---|
| 200 | ОК |
| 403 | Запрещено |
| 204 | Нет содержимого |
| 500 | Внутренняя ошибка |
Заголовки ответов
Общие заголовки ответов см. в разделе Заголовки HTTP-запросов и ответов в службе REST API CM.
Текст ответа
При успешном выполнении возвращает объект политики, основанный на объекте ProfileTemplatePolicy . Как минимум, объект политики содержит свойства из следующей таблицы, но может содержать дополнительные свойства в зависимости от запрошенной политики. Например, запрос политики регистрации возвращает объект EnrollPolicy . Дополнительные сведения см. в документации по объекту политики, связанному с параметром {type} в запросе. Документацию по различным типам объектов политики можно найти в документации по пространству имен Microsoft.Clm.Shared.ProfileTemplates .
| Свойство | Описание |
|---|---|
| ApprovalsNeeded | Количество утверждений, необходимых для запросов forefront Identity Manager (FIM) Certificate Management (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