# Fluxos de aprovação

Crie fluxos de aprovação: regras por diretório, grupo ou utilizador, com rejeição, aprovação automática ou aprovação humana sequencial.

Requires: workflows

> **Nota sobre o plano:** Os workflows de aprovação estão disponíveis a partir do plano Advanced (o Trial inclui até 3 workflows).

Um **fluxo de aprovação** é um conjunto de regras com nome que decide o que acontece quando um utilizador pede acesso a uma aplicação. Cada regra tem uma **condição** (a quem se aplica) e uma **conclusão** (o resultado). Quando chega um pedido, a plataforma avalia as regras do fluxo por ordem de prioridade e aplica a **primeira regra ativa correspondente**, pelo que deve ordenar as regras da mais específica para a mais geral.

Gere os fluxos em **Workflows → Fluxos de aprovação** na Admin Console.

[Image: A lista de fluxos de aprovação na Admin Console]

## Criar um fluxo

1. Abra **Workflows → Fluxos de aprovação** e escolha **Create approval flow**.
2. Atribua ao fluxo um **nome** descritivo (por exemplo, "Aplicações financeiras" ou "Acesso externo").
3. O fluxo abre em modo de edição, pronto para adicionar regras.

Um novo fluxo não tem regras até que as adicione. Um fluxo sem nenhuma regra correspondente não tem qualquer efeito sobre um pedido.

## Adicionar uma regra

Cada regra assenta numa estrutura **IF / THEN**: as condições delimitam os utilizadores a que a regra se aplica e a conclusão define o resultado.

1. No separador **Regras do workflow** do fluxo, selecione **Editar** e, em seguida, **Create rule**.
2. Introduza um **nome de regra** opcional para que a regra seja facilmente reconhecível mais tarde.
3. Defina as **condições** (todas têm de corresponder para que a regra se aplique):
   - **The user's directory is**: *qualquer diretório* ou um de uma lista selecionada de diretórios.
   - **The user's group membership includes**: *qualquer grupo* ou pelo menos um de uma lista selecionada de grupos.
   - **The user is**: *qualquer utilizador* ou pelo menos um de uma lista nominal de utilizadores, opcionalmente com utilizadores nomeados a **excluir**.
4. Defina a **conclusão**, ou seja, o que acontece quando as condições correspondem:
   - **Rejeitado**: o pedido é recusado automaticamente.
   - **Aprovado automaticamente**: o acesso é concedido de imediato, sem revisão humana.
   - **Passar por um processo de aprovação**: o pedido é encaminhado para os níveis de aprovação que definir abaixo.
5. Se tiver escolhido um processo de aprovação, configure os **níveis de aprovação** (ver abaixo).
6. Opcionalmente, assinale **Ativar regra após a criação** para que a regra produza efeito depois de publicada. (As regras inativas são ignoradas na avaliação.)
7. Guarde a regra.

[Image: O editor de regras com as condições IF e a conclusão THEN]

### Quem aprova [#who-approves]

Quando uma regra encaminha pedidos para um processo de aprovação, **Os aprovadores são** define de onde vêm os aprovadores:

- **Aprovadores designados**: as listas fixas por nível indicadas abaixo (a predefinição).
- **Responsáveis do workspace**: os responsáveis do [Workspace](https://dts-identity.com/pt/docs/governance/workspaces.md) que contém a aplicação pedida, determinados quando o pedido é processado (um único nível de aprovação). Utilize esta opção quando a aprovação deve acompanhar o Workspace em vez de uma lista fixa de nomes. Um responsável nunca aprova o seu próprio pedido: fica excluído dos aprovadores de um pedido que ele próprio tenha feito.

> **Nota:** Com **Responsáveis do workspace**, um pedido para uma aplicação que não está num Workspace, ou cujo Workspace não tem responsáveis além do requerente, não pode ser encaminhado: o pedido termina com um erro e nunca é aprovado automaticamente. Essas aplicações ficam também ocultas no catálogo de pedidos self-service. A opção está disponível quando os Workspaces estão ativados no seu plano.

### Níveis de aprovação

Um processo de aprovação suporta até **três níveis sequenciais**. Cada nível contém um conjunto de **aprovadores elegíveis**, e basta que **qualquer um** deles aprove para que o pedido avance para o nível seguinte.

- **Aprovadores de primeiro nível**: os utilizadores notificados quando o pedido é criado. (Obrigatório para um processo de aprovação.)
- **Aprovadores de segundo nível** *(opcional)*: notificados depois de um aprovador de primeiro nível conceder a aprovação.
- **Aprovadores de terceiro nível** *(opcional)*: notificados depois de um aprovador de segundo nível conceder a aprovação.

Adicione o segundo e o terceiro níveis apenas se pretender uma aprovação em várias fases; um único nível é o caso mais comum. Quando o último nível configurado aprova, o acesso é concedido.

### Como funciona a prioridade das regras

Não define números de prioridade manualmente: a plataforma deriva a prioridade de uma regra a partir da sua especificidade. As regras com condições de diretório, grupo ou utilizador têm precedência sobre as regras genéricas "any", e a **primeira regra ativa correspondente prevalece**. Coloque as exceções restritas (por exemplo, uma regra que exclui um utilizador específico) acima das regras genéricas, para que sejam avaliadas primeiro.

## Rascunho e publicação

As alterações às regras são mantidas como **rascunho** até as publicar; entretanto, o fluxo em produção continua a funcionar com as regras atualmente publicadas.

- Durante a edição, um aviso **Alterações não publicadas** indica que o seu rascunho difere da versão em produção.
- **Publicar** coloca o rascunho em produção e incrementa a versão do fluxo. **Todos os pedidos de aprovação em curso que utilizam este fluxo são repostos**, para que sejam reavaliados face às novas regras.
- **Descartar alterações** elimina o rascunho e mantém as regras em produção inalteradas.

> **Nota:** A publicação repõe os pedidos pendentes deste fluxo. Se houver pedidos em revisão, a consola avisa-o e mostra quantos são afetados antes de publicar.

## Ativar, desativar e eliminar regras

Na lista de regras (em modo de edição) pode:

- **Ativar / Desativar** uma regra: uma regra inativa continua definida, mas é ignorada na avaliação.
- **Eliminar** uma regra: estas alterações também passam pelo ciclo de rascunho/publicação.

O **nome** de um fluxo é editado no respetivo separador **Definições**; o mesmo separador contém a ação **Eliminar workflow** para remover o fluxo inteiro.

## Associar um fluxo a uma aplicação

Um fluxo não faz nada até que uma aplicação remeta para ele. Nas definições de política de uma aplicação, ative:

- **User can request access (self-service)**: escolha o fluxo que controla os pedidos de acesso iniciados pelos utilizadores.

Consulte [Aplicações](https://dts-identity.com/pt/docs/integrations/applications.md) para o procedimento completo.

## O que pode sujeitar a aprovação

Os fluxos de aprovação regem os **pedidos de acesso self-service**: um utilizador pede uma aplicação e o fluxo decide.

A aprovação de atribuições efetuadas *por administradores* não está disponível. Para controlar as atribuições de administradores, coloque a aplicação num [Workspace](https://dts-identity.com/pt/docs/governance/workspaces.md) com acesso gerido, o que limita quem a pode atribuir, e reveja os acessos concedidos com uma campanha de [certificação de acessos](https://dts-identity.com/pt/docs/workflows/access-certifications.md).

Quando um pedido é finalmente aprovado, a plataforma efetua a atribuição automaticamente, respeitando opcionalmente uma data de início e de fim definida pelo aprovador.

## Referência

### Resultados das regras

| Resultado | Efeito |
|---|---|
| Rejeitado | O pedido é recusado automaticamente; sem revisão. |
| Aprovado automaticamente | O acesso é concedido de imediato; sem revisão humana. |
| Processo de aprovação | O pedido passa por 1 a 3 níveis de aprovadores humanos. |

### Condições das regras

| Condição | Opções |
|---|---|
| Diretório | Qualquer diretório ou uma lista selecionada |
| Pertença a grupos | Qualquer grupo ou pelo menos um de uma lista selecionada |
| Utilizador | Qualquer utilizador ou uma lista nominal de inclusão com uma lista de exclusão opcional |

### Ações sobre o rascunho

| Ação | Efeito |
|---|---|
| Publicar | Coloca as regras do rascunho em produção, incrementa a versão e repõe os pedidos em curso |
| Descartar alterações | Elimina o rascunho e mantém as regras em produção |

## Resolução de problemas

- **Um pedido foi decidido de forma inesperada.** Lembre-se de que a **primeira regra ativa correspondente prevalece**, por ordem de especificidade. Uma regra genérica "qualquer utilizador → aprovado automaticamente" captura pedidos que pretendia que fossem tratados por uma regra mais restrita; torne a regra pretendida mais específica ou desative a regra genérica.
- **Um processo de aprovação nunca notifica ninguém.** Uma regra de processo precisa de pelo menos um **aprovador de primeiro nível**. Uma regra apenas com aprovadores de segundo ou terceiro nível configurados não pode ser executada.
- **Os pedidos terminam num estado de erro.** A regra utiliza **Responsáveis do workspace**, mas a aplicação não está num Workspace ou o respetivo Workspace não tem responsáveis. Adicione a aplicação a um Workspace com responsáveis ou altere a regra para aprovadores designados.
- **A aplicação não consegue selecionar um fluxo.** O controlo dos pedidos self-service requer a funcionalidade **workflows** no seu plano e a existência de pelo menos um fluxo de aprovação. Crie primeiro um fluxo e, em seguida, associe-o na aplicação.

## Relacionado

- [Aprovações](https://dts-identity.com/pt/docs/workflows/approvals.md): a caixa de entrada onde os pedidos pendentes são decididos
- [As suas tarefas e aprovações](https://dts-identity.com/pt/docs/getting-started/your-tasks-and-approvals.md): onde aparecem as aprovações que aguardam por si
- [Aplicações](https://dts-identity.com/pt/docs/integrations/applications.md): associar um fluxo a uma aplicação
- [Pessoas](https://dts-identity.com/pt/docs/directories/people.md): os utilizadores abrangidos pelas condições das regras
- [Planos e add-ons](https://dts-identity.com/pt/docs/getting-started/plans-and-addons.md): o que o seu plano inclui
