Skip to main content
Instalar o Access Manager não basta sozinho. Para começar a aplicar o controle de acesso, ligue-o em cada produto. Defina as variáveis do Auth no arquivo .env de qualquer produto ou plugin Lerian em que quiser o controle ativo.
Habilitar o Access Manager apenas liga a aplicação da autorização em um produto ou plugin. Você gerencia os dados de acesso separadamente, pelo Access Manager. Isso inclui usuários, grupos, applications, provedores, papéis e permissões.
Cada produto protegido deve habilitar a aplicação do controle e apontar para o Auth. A variável de endereço não é a mesma em todos os repositórios, então use a variável que o produto que você configura espera:
Depois que você habilita o Access Manager, as requisições de API protegidas devem incluir um header Authorization com um Bearer access token válido.Sem esse header, as requisições protegidas serão recusadas, mesmo em endpoints que antes eram acessíveis sem autenticação.Aprenda a gerar e usar access tokens.

​
Onde atualizar

Você encontra os arquivos .env relevantes nestes lugares:
  • Midaz
    • /midaz/components/ledger usa PLUGIN_AUTH_HOST.
    • /midaz/components/tracer usa PLUGIN_AUTH_ADDRESS
  • Outros produtos e plugins
    • Use o arquivo .env na raiz do produto ou do plugin, ou no diretório do componente quando o repositório é dividido em componentes.
    • Reporter e Bank Transfer usam PLUGIN_AUTH_ADDRESS.
    • O Pix Indireto BTG usa PLUGIN_AUTH_ADDRESS.
    • O Pix via JD usa PLUGIN_AUTH_HOST.
Se você não enxerga os arquivos, ajuste as configurações do seu sistema para mostrar arquivos ocultos. Arquivos .env costumam ficar ocultos por padrão.

​
Reconstruir após as mudanças

Depois de atualizar um arquivo .env, reconstrua e reinicie a partir da raiz do repositório que é dono daquele arquivo. Os comandos de ciclo de vida mudam conforme o repositório: na raiz do repositório do Midaz, rode make rebuild-up, porque o alvo make up dele sobe os serviços sem reconstruí-los. Para os outros produtos e plugins, use o comando de ciclo de vida documentado para esse produto.

​
Ciclo de vida do deploy

A configuração do Access Manager tem duas fases:
  • O bootstrap popula um ambiente novo com a organização base, os papéis, grupos, applications e conjuntos de permissões que a plataforma exige.
  • A operação começa depois que o ambiente está no ar. Daí em diante, gerencie o acesso pelas APIs do Identity ou pelo Lerian Console.
Use as APIs operacionais para acesso de usuário, atribuição de grupo, credenciais de application, provedores e MFA. Não mude um ambiente em execução editando os arquivos de seed do bootstrap.
O bootstrap aplica os dados de seed dele apenas durante a configuração inicial do ambiente. Mudanças em recursos, ações, papéis, grupos, applications ou conjuntos de permissões nativos em um ambiente existente devem ser entregues por atualizações controladas da plataforma. Entre os exemplos estão migrações e um conciliador idempotente.