APIs de identidad

Con las APIs de identidad, puedes crear y administrar cuentas de usuario, configurar aplicaciones M2M y consultar grupos de permisos. También puedes configurar proveedores, vincular proveedores a aplicaciones y administrar la configuración de MFA. En implementaciones multi-tenant, el token bearer determina el ámbito de los resultados de usuarios, grupos y aplicaciones. Se recomienda que los clientes no pasen la propiedad del tenant a través de los payloads de las solicitudes.

​

Endpoints disponibles

---

​

API de grupos

Consulta los grupos de permisos predefinidos:

• Listar grupos - Recupera todos los grupos disponibles en el sistema.
• Obtener detalles del grupo - Obtén información detallada sobre un grupo específico, incluidos los usuarios asignados.

Cada grupo contiene un conjunto predefinido de permisos. Usa los ID de grupo que se devuelven aquí al crear o actualizar usuarios.

​

API de aplicaciones

Administra las credenciales de las aplicaciones M2M:

• Crear una aplicación - Registra una nueva aplicación para la autenticación máquina a máquina.
• Listar aplicaciones - Recupera todas las aplicaciones registradas.
• Obtener detalles de la aplicación - Obtén información detallada sobre una aplicación específica.
• Eliminar una aplicación - Elimina una aplicación y sus credenciales.

Los nombres actuales de las aplicaciones M2M incluyen midaz, plugin-fees, plugin-crm, reporter, plugin-br-pix-jd, plugin-br-pix-indirect-btg y plugin-br-bank-transfer.

​

API de proveedores

Administra los proveedores de comunicación para la entrega de MFA:

• Listar proveedores - Recupera los proveedores de comunicación disponibles.
• Crear un proveedor - Crea un nuevo proveedor de comunicación.
• Obtener un proveedor - Obtén los detalles de un proveedor específico.
• Actualizar un proveedor - Actualiza la configuración del proveedor.
• Eliminar un proveedor - Elimina un proveedor.

​

API de proveedores de aplicaciones

Administra los vínculos de proveedores para las aplicaciones:

• Listar proveedores de la aplicación - Recupera los proveedores vinculados a una aplicación.
• Vincular un proveedor a una aplicación - Vincula un proveedor a una aplicación.
• Actualizar el vínculo de proveedor de la aplicación - Actualiza un vínculo de proveedor.
• Desvincular un proveedor de una aplicación - Elimina un vínculo de proveedor de una aplicación.
• Establecer el proveedor predeterminado de la aplicación - Selecciona el proveedor predeterminado para una aplicación.

​

API de usuarios

Administra las cuentas de usuario y las credenciales:

• Crear un usuario - Crea una nueva cuenta de usuario con asignaciones de grupo.
• Listar usuarios - Recupera todos los usuarios del sistema.
• Obtener detalles del usuario - Obtén información detallada sobre un usuario específico.
• Actualizar un usuario - Modifica la información del usuario y las membresías de grupo.
• Eliminar un usuario - Elimina un usuario del sistema.
• Restablecer la contraseña de un usuario - Restablece la contraseña de un usuario (acción de administrador).
• Actualizar la contraseña de un usuario - Cambia la contraseña de un usuario con verificación de la contraseña actual.

​

API de MFA

Administra la configuración de MFA y las preferencias de MFA del usuario:

• Iniciar la configuración de MFA - Inicia la configuración de MFA para un usuario.
• Verificar el código MFA - Verifica un código de configuración de MFA.
• Habilitar MFA - Habilita MFA después de la verificación de la configuración.
• Obtener el estado de MFA - Recupera el estado actual de MFA de un usuario.
• Establecer el método de MFA preferido - Cambia el método de MFA preferido del usuario.
• Deshabilitar MFA - Deshabilita MFA para un usuario.

​

Referencias relacionadas

---

• APIs de autenticación - Solicita tokens, actualiza tokens, recupera información del usuario y valida permisos.
• Lista de errores de Access Manager - Revisa los códigos de error de identidad.