> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Habilitando o Access Manager

> Ative o Access Manager nos produtos Lerian definindo as variáveis de ambiente do Auth em cada produto para que os seus serviços comecem a aplicar o controle de acesso.

[Instalar o Access Manager](https://docs.lerian.studio/pt/platform/access-manager/installing-access-manager.md) 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 ambiente de qualquer produto ou plugin Lerian em que quiser o controle ativo.

> [!NOTE]
>
> 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 produtos, então use a variável que o produto que você configura espera:

```text Text theme={null}
# Most products and plugins
PLUGIN_AUTH_ENABLED=true
PLUGIN_AUTH_ADDRESS=http://plugin-auth:4000
```

```text Text theme={null}
# Midaz Ledger and Pix via JD
PLUGIN_AUTH_ENABLED=true
PLUGIN_AUTH_HOST=http://plugin-auth:4000
```

> [!CAUTION]
>
> 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.**](https://docs.lerian.studio/pt/platform/access-manager/using-access-manager.md)

## Onde atualizar

***

| Produto | Variável de endereço |
| - | - |
| [Midaz Ledger](https://docs.lerian.studio/pt/products/midaz/midaz-environment-variables.md) | `PLUGIN_AUTH_HOST` |
| [Tracer](https://docs.lerian.studio/pt/products/tracer/tracer-environment-variables.md) | `PLUGIN_AUTH_ADDRESS` |
| [Reporter](https://docs.lerian.studio/pt/products/reporter/reporter-environment-variables.md) | `PLUGIN_AUTH_ADDRESS` |
| [Bank Transfer (TED)](https://docs.lerian.studio/pt/interfaces/ted-jd/ted-environment-variables.md) | `PLUGIN_AUTH_ADDRESS` |
| [Pix Indireto BTG](https://docs.lerian.studio/pt/interfaces/pix-btg/indirect-pix-environment-variables.md) | `PLUGIN_AUTH_ADDRESS` |
| [Pix via JD](https://docs.lerian.studio/pt/interfaces/pix-jd/pix-jd-environment-variables.md) | `PLUGIN_AUTH_HOST` |

## 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.

> [!WARNING]
>
> 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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.