Configurar la API de roles y permisos en el aprovisionamiento personalizado
Puede administrar los roles y permisos de la aplicación externa desde el panel de control de miniOrange. En la aplicación de aprovisionamiento personalizado, puede crear, actualizar, eliminar, asignar o desasignar roles con permisos y asignar o desasignar roles a usuarios.
Configure la aplicación de aprovisionamiento personalizado e integre las API de su aplicación externa. Consulte la guía para agregar la aplicación de aprovisionamiento personalizado.
Esta guía le ayudará a configurar las API relacionadas con la gestión de roles y permisos de la aplicación externa.
Obtenga ayuda de instalación gratuita
miniOrange ofrece ayuda gratuita mediante una llamada de consulta con nuestros ingenieros de sistemas para instalar o configurar la solución ADFS SSO en su entorno con una prueba gratuita de 30 días.
Para ello, solo tienes que enviarnos un correo electrónico a idpsupport@xecurify.com para reservar una cita y te ayudaremos enseguida.
1. Configurar la aplicación externa en miniOrange
Consulte esta guía: Cómo agregar una aplicación de aprovisionamiento personalizada para configurar una aplicación de aprovisionamiento personalizada en miniOrange.
1.1 Configurar la API de rol de importación
Esta API se utilizará para importar los roles existentes en la aplicación externa.
- En la sección Aplicación externa a miniOrange , haz clic en Agregar configuración.
- Proporcionar un Nombre de configuración del evento. Seleccione Tipo de evento as Solicitud de rol de importación. Añade el Punto final GET para importar/obtener roles.
- Seleccione el elemento Autorización que se configura en la pestaña Autorización.
- Proporcione cabeceras requerido para la API.
- Configurar Asignación de atributos:
- Mapear el Clave principal de datos de roles Con la clave de roles (que corresponde a la cual se obtienen todos los roles) en la respuesta de la API. Déjela en blanco si la lista de roles no está asignada a ningún campo.
- Configurar Asignación de atributos para mapear atributos de roles individuales con atributos miniOrange como ID de rol, nombre de rol, etc.
- Configurar Configuración de paginación:
- Configurar el Tipo de paginación y conectar Clave de paginación si lo admite la API.
- Haga clic en Guardar configuración.
- A Importar roles, Haga clic en el botón de importación (flecha hacia abajo) correspondiente a la Importar rol evento en la lista en el Aplicación externa a miniOrange .
1.2 Configurar la API de permisos de importación
Esta API se utilizará para importar los permisos permitidos en la aplicación externa, los cuales se pueden agregar a los roles, decidiendo el nivel de acceso del usuario en la aplicación.
- Vaya a la Aplicación externa al miniOrange lengüeta. Haga clic en Agregar configuración.
- Proporcionar un Nombre de configuración del evento. Seleccione Tipo de evento as Solicitud de permisos de importación. Añade el Punto final GET para importar/obtener permisos.
- Seleccione el elemento Autorización que se configura en la pestaña Autorización.
- Proporcione cabeceras requerido para la API.
- Configurar Configuración de paginación:
- Configurar el Tipo de paginación y conectar Clave de paginación si lo admite la API.
- Configurar Asignación de atributos para mapear atributos de permisos individuales con atributos miniOrange.
- Mapear el Clave principal de datos de permisos con la clave de permisos (correspondiente a la cual obtienes todos los permisos) que viene en la respuesta de la API.
- Si los permisos se reciben como una lista de cadenas, utilice el atributo Lista de nombres de permisos.
- Si los permisos se reciben como pares clave-valor, utilice atributos Nombre del permiso y descripción de los permisos.
- Haga clic en Guardar configuración.
- A Permisos de importación, Haga clic en el botón de importación (flecha hacia abajo) correspondiente a la Permisos de importación evento en la lista en el Aplicación externa a miniOrange .
1.3 Configurar la API de asignación de roles y permisos de importación
Esta API se utilizará para importar los roles y las asignaciones de permisos para determinar qué permisos existen bajo un rol en particular.
- Vaya a la Aplicación externa a miniOrange lengüeta. Haga clic en Agregar configuración.
- Proporcionar un Nombre de configuración del evento. Seleccione Tipo de evento as Solicitud de asignación de roles y permisos de importación. Añade el Punto final GET Para importar/obtener permisos de un rol, debe agregar el ID de rol externo en el punto final (presione la barra espaciadora > @ > seleccione Id. de rol externo).
- Seleccione el elemento Autorización que se configura en la pestaña Autorización.
- Proporcione cabeceras requerido para la API.
- Configurar Configuración de paginación:
- Configurar Clave de página siguiente (si la API proporciona datos en lotes).
- Configurar Número de página de inicio (si la API admite paginación).
- Configurar Asignación de atributos para mapear atributos de permisos individuales con atributos miniOrange.
- Mapear el Clave principal de datos de permisos con la clave de permisos (correspondiente a la cual obtienes todos los permisos) que viene en la respuesta de la API.
- Si los permisos se reciben como una lista de cadenas, utilice el atributo Lista de nombres de permisos.
- Si los permisos se reciben como pares clave-valor, utilice atributos Nombre del permiso y Descripción de permisos.
- Haga clic en Guardar configuración.
- A Importar asignaciones de roles y permisos, Haga clic en el botón de importación (flecha hacia abajo) correspondiente a la Importar rol evento en la lista en el Aplicación externa a miniOrange .
2. Configurar miniOrange para las API de aplicaciones externas
En la aplicación de aprovisionamiento personalizado, vaya a la pestaña "Aplicación externa de miniOrange".
2.1 Configurar la API de creación de roles
Esta API se utilizará cuando cree un rol en la sección Roles y permisos.
- En la sección miniOrange a aplicación externa , haz clic en Agregar configuración.
- Proporcionar un Nombre de configuración del evento. Seleccione Tipo de evento as Crear Rol. Añade el Punto final POST para crear un rol en la aplicación externa.
- Seleccione el elemento Autorización configurado en la pestaña Autorización.
- Proporcione cabeceras requerido para la API.
- Configurar Carrocería Para agregar el cuerpo de la solicitud, consulte la estructura en la documentación de la aplicación externa. Según los atributos del cuerpo, agregue los atributos miniOrange para el rol presionando la barra espaciadora > @ > seleccione los atributos del rol correspondientes.
- Configurar Configuración de respuesta para mapear el Tecla de estado, Tecla de error, y identificador externo del rol recibido en la respuesta. Mantenga las claves de estado y error tal como están si no están presentes en la respuesta.
- Haga clic en Guardar configuración.
2.2 Configurar la API de rol de actualización
Esta API se utilizará cuando actualice un rol en la sección Roles y permisos.
- Vaya a la miniOrange a aplicación externa pestaña y haga clic en Agregar configuración.
- Proporcionar un Nombre de configuración del evento. Seleccione Tipo de evento as Actualizar Rol. Añade el Punto final POST/PUT Necesitas agregar Id./nombre del rol externo en el punto final (presione la barra espaciadora > @ > seleccione Id./nombre de rol externo).
- Seleccione el elemento Autorización configurado en la pestaña Autorización.
- Proporcione cabeceras requerido para la API.
- Configurar Carrocería Para agregar el cuerpo de la solicitud. Según los atributos del cuerpo, agregue los atributos miniOrange para el rol presionando la barra espaciadora > @ > seleccione los atributos del rol correspondientes.
- Configurar Configuración de respuesta para mapear el Tecla de estado y Clave de error Recibido en la respuesta.
- Haga clic en Guardar configuración.
2.3 Configurar la API de eliminación de roles
Esta API se utilizará cuando elimines un rol en la sección Roles y permisos.
- Vaya a la miniOrange a aplicación externa lengüeta. Haga clic en Agregar configuración.
- Proporcionar un Nombre de configuración del evento.
- Seleccionar Tipo de evento as Eliminar rol.
- Agregar el formulario Punto final POST/PUT/DELETE Necesitas agregar Id./nombre del rol externo en el punto final (presione la barra espaciadora > @ > seleccione Id./nombre de rol externo).
- Seleccione el elemento Autorización configurado en la pestaña Autorización.
- Proporcione cabeceras requerido para la API.
- Configurar Carrocería Para agregar el cuerpo de la solicitud, si es necesario. Según los atributos del cuerpo, agregue los atributos miniOrange para el rol presionando la barra espaciadora > @ > seleccione los atributos del rol correspondientes.
- Configurar Configuración de respuesta para mapear el Tecla de estado y Clave de error Recibido en la respuesta.
- Haga clic en Guardar configuración.
2.4. Configurar la API de asignación de permisos a roles
Esta API se utilizará cuando asigne permisos a un rol durante la configuración del rol en la sección Roles y permisos.
- Vaya a la miniOrange a aplicación externa lengüeta. Haga clic en Agregar configuración.
- Proporcionar un Nombre de configuración del evento.
- Seleccionar Tipo de evento as Asignar permisos a un rol..
- Agregar el formulario Punto final POST/PUT. Necesitas agregar Id./nombre del rol externo en el punto final (presione la barra espaciadora > @ > seleccione Id./nombre de rol externo).
- Seleccione el elemento Autorización que se configura en la pestaña Autorización.
- Proporcione cabeceras requerido para la API.
- Configurar Carrocería Para agregar el cuerpo de la solicitud. Según los atributos de permiso del cuerpo, agregue los atributos miniOrange para los permisos presionando la barra espaciadora > @ > seleccione los atributos de permiso correspondientes.
- Si los permisos se deben enviar como una lista de cadenas, utilice el atributo Lista de nombres de permisos.
- Si los permisos se deben enviar como pares clave-valor, utilice atributos Nombre del permiso y Descripción de permisos.
- Configurar Configuración de respuesta para mapear el Tecla de estado y Clave de error Recibido en la respuesta.
- Haga clic en Guardar configuración.
2.5 Configurar la API de asignación de roles al usuario
Esta API se utilizará al asignar un grupo a un rol durante la configuración del rol en la sección Roles y permisos. Los usuarios del grupo asignado se asignarán al rol en la aplicación externa. Esta API también se activa al asignar un usuario a un grupo en Grupos >> Administrar grupos.
2.6 Configurar la cancelación de asignación de roles desde la API de usuario
Esta API se utilizará al desasignar un grupo de un rol durante la actualización del rol en la sección Roles y permisos. Los usuarios de ese grupo se desasignarán del rol en la aplicación externa. Esta API también se activa al desasignar un usuario de un grupo en Grupos >> Administrar grupos.
