Obter política de fluxo de trabalho
Obtém a política de modelo de perfil para um fluxo de trabalho especificado. Os dados são utilizados durante a criação do pedido. A política de fluxo de trabalho especifica que dados são necessários pelo cliente para criar um pedido. Os dados podem incluir vários itens de recolha de dados, comentários de pedidos e uma política de palavra-passe única.
Nota
Os URLs neste artigo são relativos ao nome do anfitrião escolhido durante a implementação da API, como https://api.contoso.com.
Pedir
| Método | URL do Pedido |
|---|---|
| GET | /CertificateManagement/api/v1.0/profiletemplates/{id}/policy/workflow/{type} |
Parâmetros de URL
| Parâmetro | Descrição |
|---|---|
| ID | Obrigatório. O GUID correspondente ao modelo de perfil do qual a política deve ser extraída. |
| tipo | Obrigatório. O tipo de política que está a ser pedida. Os valores possíveis são "Enroll", "Duplicate", "OfflineUnblock", "OnlineUpdate", "Renew", "Recover", "RecoverOnBehalf", "Reinstate", "Retire", "Revoke", "TemporaryEnroll" e "Unblock". |
Cabeçalhos do pedido
Para obter os cabeçalhos de pedidos comuns, veja Cabeçalhos de pedidos e respostas HTTP nos detalhes do serviço da API REST do CM.
Corpo do pedido
Nenhum.
Resposta
Esta secção descreve a resposta.
Códigos de resposta
| Código | Descrição |
|---|---|
| 200 | OK |
| 403 | Proibido |
| 204 | Sem conteúdo |
| 500 | Erro Interno |
Cabeçalhos de resposta
Para obter cabeçalhos de resposta comuns, veja Cabeçalhos de pedidos e respostas HTTP nos detalhes do serviço API REST do CM.
Corpo da resposta
Com êxito, devolve um objeto de política baseado num objeto ProfileTemplatePolicy . No mínimo, o objeto de política contém as propriedades na tabela seguinte, mas pode conter propriedades adicionais consoante a política pedida. Por exemplo, um pedido para uma política de inscrição devolve um objeto EnrollPolicy . Para obter mais informações, veja a documentação do objeto de política associado ao parâmetro {type} no pedido. A documentação para os diferentes tipos de objetos de política pode ser encontrada na documentação do espaço de nomes Microsoft.Clm.Shared.ProfileTemplates .
| Propriedade | Descrição |
|---|---|
| AprovaçõesNeeded | O número de aprovações necessárias para pedidos de Gestão de Certificados (CM) do Forefront Identity Manager (FIM) para a política. |
| AuthorizedApprover | O descritor de segurança para utilizadores autorizados a aprovar pedidos de CM do FIM para a política. |
| AuthorizedEnrollmentAgent | O descritor de segurança para utilizadores que podem atuar como agentes de inscrição para a política. |
| AuthorizedInitiator | O descritor de segurança para utilizadores que podem iniciar pedidos de CM do FIM para a política. |
| CollectComments | Um valor booleano que indica se a coleção de comentários está ativada para pedidos DE CM do FIM para a política. |
| CollectRequestPriority | Um valor booleano que indica se a coleção de prioridade de pedidos está ativada para pedidos DE CM do FIM para a política. |
| DefaultRequestPriority | A prioridade predefinida para pedidos de CM do FIM para a política. |
| Documentos | Os documentos de política configurados para a política. |
| Ativado | Um valor booleano que indica se a política está ativada. |
| EnrollAgentRequired | Um valor booleano que indica se os agentes de inscrição são necessários para os pedidos de CM do FIM para a política. |
| OneTimePasswordPolicy | O método de distribuição para palavras-passe únicas para pedidos de CM do FIM para a política. |
| Personalização | As opções de personalização do smart card para a política. |
| PolicyDataCollection | Os itens de recolha de dados associados à política. |
| SelfServiceEnabled | Um valor booleano que indica se a iniciação self-service de pedidos DE CM do FIM está ativada para a política. |
Exemplo
Esta secção fornece um exemplo para obter a política de modelo de perfil para um fluxo de trabalho.
Exemplo: Pedido 1
GET /CertificateManagement/api/v1.0/profiletemplates/97CD65FA-AF4B-4587-9309-0DD6BFD8B4E1/policies/enroll HTTP/1.1
Exemplo: Resposta 1
HTTP/1.1 200 OK
... body coming soon
Exemplo: Pedido 2
GET /CertificateManagement/api/v1.0/profiletemplates/97CD65FA-AF4B-4587-9309-0DD6BFD8B4E1/policies/renew HTTP/1.1
Exemplo: Resposta 2
HTTP/1.1 200 OK
... body coming soon