Skip to main content
Instalar Access Manager no basta por sí sola. Para empezar a hacer cumplir el acceso, actívalo en cada producto. Define las variables de Auth en el archivo .env de cualquier producto o plugin Lerian donde lo quieras activo.
Habilitar Access Manager solo activa el cumplimiento de autorización en un producto o plugin. Los datos de acceso los gestionas por separado mediante Access Manager. Esto incluye usuarios, grupos, aplicaciones, proveedores, roles y permisos.
Cada producto protegido debe habilitar el cumplimiento y apuntar a Auth. La variable de dirección no es la misma en todos los repositorios, así que usa la variable que espera el producto que configuras:
Después de que habilites Access Manager, las solicitudes de API protegidas deben incluir un header Authorization con un Bearer access token válido.Sin este header, las solicitudes protegidas se rechazan, incluso en endpoints que antes eran accesibles sin autenticación.Aprende a generar y usar access tokens.

​
Dónde actualizar

Encontrarás los archivos .env relevantes en estas ubicaciones:
  • Midaz
    • /midaz/components/ledger usa PLUGIN_AUTH_HOST.
    • /midaz/components/tracer usa PLUGIN_AUTH_ADDRESS
  • Otros productos y plugins
    • Usa el archivo .env en la raíz del producto o del plugin, o en el directorio del componente cuando el repositorio está dividido en componentes.
    • Reporter, Flowker y Bank Transfer usan PLUGIN_AUTH_ADDRESS.
    • Pix Indirect BTG usa PLUGIN_AUTH_ADDRESS.
    • Pix via JD usa PLUGIN_AUTH_HOST.
Si no ves los archivos, ajusta la configuración de tu sistema para mostrar los archivos ocultos. Los archivos .env suelen estar ocultos de forma predeterminada.

​
Reconstruye después de los cambios

Después de actualizar un archivo .env, reconstruye y reinicia desde la raíz del repositorio que es dueño de ese archivo. Los comandos de ciclo de vida difieren según el repositorio: en la raíz del repositorio de Midaz, ejecuta make rebuild-up, porque su target make up arranca los servicios sin reconstruirlos. Para otros productos y plugins, usa el comando de ciclo de vida documentado para ese producto.

​
Ciclo de vida del despliegue

La configuración de Access Manager tiene dos fases:
  • El bootstrap inicializa un entorno nuevo con la organización base, los roles, los grupos, las aplicaciones y los conjuntos de permisos que requiere la plataforma.
  • La operación empieza después de que el entorno esté en marcha. A partir de ese punto, gestiona el acceso mediante las APIs de Identity o Lerian Console.
Usa las APIs operativas para el acceso de usuarios, la asignación de grupos, las credenciales de aplicación, los proveedores y MFA. No cambies un entorno en ejecución editando los archivos de inicialización del bootstrap.
El bootstrap aplica sus datos de inicialización solo durante la configuración inicial del entorno. Los cambios a recursos, acciones, roles, grupos, aplicaciones o conjuntos de permisos integrados en un entorno existente deben entregarse mediante actualizaciones controladas de la plataforma. Entre los ejemplos están las migraciones y un conciliador idempotente.