Docs
PlataformaAgentes

Publicar e desativar

O rascunho, a barra de publicação, os estados efetiva e pendente, a revisão publicada, o histórico de revisões e o kill switch do agente.

Toda edição no grafo, na lista ou nos painéis muda o rascunho do agente. As chamadas continuam usando a revisão publicada até a próxima publicação. Isso permite montar uma mudança grande com calma, revisar e só então aplicar.

A barra de publicação

A barra fica no pé do editor, visível no grafo, na lista e em tela cheia. À esquerda, o estado do rascunho e o estado de execução. À direita, as ações.

Sem mudanças, a barra diz "No unpublished changes" e mostra a revisão que vale agora:

Barra sem mudanças, revisão efetiva

Depois de uma edição, ela conta as mudanças e libera as ações:

Barra com mudanças no rascunho

  • Discard draft joga fora o rascunho e volta à revisão publicada.
  • Review & publish mostra o que muda e publica.

Efetiva e pendente

Publicar grava a nova revisão no PostgreSQL e escreve as relações no OpenFGA. Enquanto o OpenFGA não confirma, a revisão fica pendente, e a anterior continua valendo:

Barra com revisão pendente

A publicação confere tudo antes de aceitar: provedores confiáveis, tools revisadas, trusted attributes ligados e a existência de cada sujeito no provedor. Uma referência quebrada impede a publicação.

Uma falha no meio nunca abre acesso: as remoções são aplicadas antes das inclusões, e um reconciliador em segundo plano termina o trabalho sozinho. Por isso não há botão de reparo nem detalhe do OpenFGA na tela (Publicação e reconciliação).

Ver a revisão publicada

Published, na barra de ferramentas, mostra a revisão que vale agora, só leitura. É o jeito de comparar o rascunho com o que está em produção antes de publicar.

Revisão publicada

Histórico de revisões

Cada publicação e cada revogação fica guardada como uma revisão, com autor, horário, nota e o documento de permissões completo. Cada troca entre Enforce e Report-only também fica, como um evento. Nada no histórico é editado ou apagado, nem depois que o agente é excluído.

History, na barra de publicação, abre o histórico num painel lateral. O autor da última revisão na barra, o link History do aviso de Report-only e a revisão de permissões de uma chamada no inspetor também abrem; este último vai direto à revisão que valia naquela chamada.

Histórico de revisões com uma troca de modo

A linha do tempo à esquerda lista revisões e trocas de modo, da mais nova para a mais antiga, com a nota, o autor e o horário em UTC. Uma barra marca a entrada selecionada; uma troca de modo tem um olho no lugar do ponto. À direita:

  • uma revisão mostra o que acrescentou, removeu ou alterou em relação à anterior, agrupado por quem pode delegar, servers e tools, e regras;
  • uma troca de modo mostra quem trocou, quando, a nota, a passagem de um modo para o outro e a data de revisão. Ela valeu na hora, sem publicação.

Desativar o agente

Disable agent, no cabeçalho, é o kill switch. Ele pede confirmação ("It gets no token, and its next call is rejected.") e não depende de rascunho nem de publicação: confirmado, vale na hora. Enable agent religa o agente sem confirmação.

Agente desativado

Um agente desativado:

  • não recebe token novo no token exchange;
  • tem a próxima chamada recusada, mesmo com um token ainda válido;
  • aparece com o estado Disabled e o grafo esmaecido.

A configuração e a chave ficam guardadas. Enable agent devolve o agente exatamente como estava. Use quando um agente se comporta de forma inesperada, quando a chave pode ter vazado ou quando a equipe precisa de tempo para investigar.