Registrar una app OAuth

Una app OAuth es el registro de una aplicación externa que necesita conectarse a Prolibu, como una integración que hayas desarrollado o un cliente MCP. Cuando la registras, Prolibu le asigna un Client ID, y tú decides a qué direcciones puede volver después de que el usuario autorice el acceso, qué tipo de token puede pedir y qué puede hacer con él.

Las apps se gestionan en Configuración → Control de Acceso → Apps OAuth, en el menú lateral. Los ajustes generales del servidor OAuth de la cuenta, como la vigencia de los tokens o si se aceptan clientes públicos, no están aquí: están en Preferencias → Seguridad → Servidor OAuth, que solo pueden abrir los administradores.

Abrir la lista de apps OAuth

1. Si el menú lateral está recogido, ábrelo con la flecha de la esquina superior izquierda.
2. Baja hasta el grupo CONFIGURACIÓN y despliega Control de Acceso.
3. Pulsa Apps OAuth.

Si todavía no hay ninguna app, la tabla aparece vacía y en el centro tienes el botón Agrega tu primer registro.

Cada fila de la lista es una app. Las columnas son:

• Cliente: el nombre de la app.
• Tipo de cliente: Público o Confidencial.
• Últimos cuatro del client secret: los cuatro últimos caracteres del secreto de la app, para que sepas cuál está en uso.
• Activo: el interruptor que la habilita o la deshabilita.
• Tipos de concesión: los flujos OAuth que la app tiene permitidos.
• Ámbitos: cuántos permisos tiene. Si pulsas el número, se despliega la lista completa.
• Fecha de creación.

Buscar y filtrar apps

1. En la barra superior, escribe parte del nombre de la app en Buscar en OAuth Apps y pulsa Enter. La tabla deja solo las apps que coinciden y, abajo a la izquierda, aparece Ordenado por relevancia.
2. Para volver a ver todas, pulsa la x del buscador.
3. Si necesitas acotar más, usa el icono de filtros, a la derecha de la barra (por ejemplo, para ver solo las apps que creaste tú o las de una fecha). Funciona igual que en el resto de Prolibu y se explica en Filtros.

Crear una app

1. En la lista de Apps OAuth, pulsa Agrega tu primer registro. Si ya hay apps, usa el botón redondo + de la esquina inferior derecha. Se abre el panel Crear App OAuth.
2. Comprueba que el interruptor Activo de arriba esté encendido. Viene encendido de fábrica.
3. En Cliente, escribe un nombre que identifique la aplicación. Es obligatorio.
4. Deja vacío Client ID: está en gris porque Prolibu lo genera al guardar.
5. En URI de redirección, escribe la dirección a la que Prolibu debe devolver al usuario cuando autorice el acceso, por ejemplo https://tu-app.com/callback, y pulsa Enter. La dirección queda como una etiqueta. Si la app usa más de una dirección (por ejemplo, la de producción y http://localhost:3000/callback para pruebas), escribe la siguiente y vuelve a pulsar Enter. Para quitar una, pulsa la x de su etiqueta. Este campo también es obligatorio.
6. En Días de expiración del token, indica cuántos días dura el token de acceso. De fábrica son 30. Puedes escribir el número o ajustarlo con − y +.
7. Revisa Tipos de concesión. Vienen puestos authorizationCode y refreshToken. Para quitar uno, pulsa la x de su etiqueta. Para añadir otro, escríbelo y pulsa Enter. Solo se aceptan authorizationCode, refreshToken y clientCredentials. Si escribes otro valor, la app no se guarda y aparece un aviso con esta lista.
8. Elige el Tipo de cliente y, si hace falta, enciende PKCE obligatorio (los dos se explican en la sección siguiente).
9. Si quieres limitar lo que puede hacer el token, configura los Ámbitos, como se explica más abajo.
10. Pulsa Crear.

El panel se cierra y la app aparece en la lista con su tipo de cliente, los cuatro últimos caracteres de su secreto, sus tipos de concesión y sus ámbitos.

Elegir el tipo de cliente y PKCE

Tipo de cliente tiene dos opciones. La pantalla lo explica así:

• Público (el valor que viene puesto): para aplicaciones que no pueden guardar un secreto, como una aplicación web de una sola página o una app móvil.
• Confidencial: para aplicaciones que sí pueden guardarlo, como un servidor backend.

Para cambiarlo, abre el desplegable Tipo de cliente y elige la opción.

Debajo está el interruptor PKCE obligatorio, que viene apagado. Si lo enciendes, la app tiene que usar PKCE, una comprobación adicional, al pedir tokens con authorization_code. Según el texto de ayuda, en los clientes públicos esta comprobación se aplica siempre, como establece OAuth 2.1.

Limitar lo que puede hacer el token (Ámbitos)

Con Ámbitos vacío (aparece Sin permisos), el token puede hacer todo lo que puede hacer el usuario que lo autorizó, como si hubiera iniciado sesión normalmente. Para restringirlo:

1. En el panel de la app, pulsa Editar permisos, a la derecha de Ámbitos. Se abre la ventana Permisos a pantalla completa. Es el mismo editor que se usa en Roles.
2. En Buscar, escribe el objeto que quieres permitir, por ejemplo Contacto.
3. En la fila del objeto, pulsa la celda Permisos de métodos.
4. Enciende las acciones que quieres permitir. Por ejemplo, Otorgar acceso de lectura enciende a la vez Listar, Obtener uno y Buscar.
5. El objeto pasa a la sección Permisos configurados, arriba. Repite los pasos 2 a 4 con los demás objetos que la app necesite.
6. Pulsa Listo.

De vuelta en el panel, Ámbitos muestra un resumen, por ejemplo 3 permisos en 1 modelos. En la lista de apps, la columna Ámbitos indica cuántos hay; si pulsas el número, aparecen los permisos uno por uno, como Resource@Contact.find.

Editar una app

1. En la lista de Apps OAuth, pulsa el menú ⋯ al final de la fila de la app.
2. Elige Editar. Se abre el panel Editar App OAuth, que muestra arriba quién la creó y cuándo.

3. Copia el Client ID si lo necesitas para configurar la aplicación externa. Prolibu lo generó al crear la app y no se puede modificar.
4. Cambia lo que haga falta: el nombre, las URI de redirección, los ámbitos, los días de expiración, los tipos de concesión, el tipo de cliente o PKCE.
5. Pulsa Guardar. El botón se activa en cuanto cambias algo.

Desactivar una app

Si quieres que una app deje de estar habilitada sin perder su configuración:

1. En la lista de Apps OAuth, busca la fila de la app.
2. Apaga el interruptor de la columna Activo. El cambio se guarda en el momento.

Al actualizar la lista, el nombre de la app aparece tachado en rojo. Para volver a habilitarla, enciende el mismo interruptor.

Cambiar varias apps a la vez

Si varias apps necesitan el mismo ajuste, por ejemplo que sus tokens duren 7 días en lugar de 30, puedes cambiarlas juntas:

1. En la lista de Apps OAuth, marca la casilla a la izquierda de cada app. Abajo aparece una barra con lo que puedes hacer con la selección: Exportar selección, Editar seleccionados, Eliminar seleccionados y Mover seleccionados al espacio de trabajo.

2. Pulsa Editar seleccionados. Se abre una ventana con el mismo nombre.
3. En Elige un campo, elige el dato que quieres cambiar. Están todos los del formulario: Activo, Ámbitos, Cliente, Días de expiración del token, PKCE obligatorio, Tipo de cliente, Tipos de concesión y URI de redirección.
4. Escribe o elige el valor nuevo. Si lo que quieres es dejar ese dato vacío en todas, enciende Vaciar valor.
5. Para cambiar otro dato en la misma pasada, pulsa Agregar campo y repite los pasos 3 y 4.
6. Pulsa Aplicar a N registros (N es el número de apps marcadas).

Prolibu pone el cambio en cola y te avisa con el mensaje «Actualización encolada». El avance se ve en el panel Importar datos, en la esquina inferior derecha, como «Edición masiva». Cuando termina, el panel indica cuántas apps se actualizaron.

Para eliminar varias apps de una vez, márcalas, pulsa Eliminar seleccionados y confirma en la ventana ¿Eliminar N registros?. Igual que al eliminar una sola, no se puede deshacer.

Exportar la lista de apps

1. En la lista de Apps OAuth, pulsa el menú ⋯ de la esquina superior derecha (Más acciones).
2. Pulsa Exportar todo.
3. Elige Reporte si quieres un archivo para leer, con los nombres visibles, o Datos si lo necesitas para volver a importarlo, con los identificadores internos.
4. Elige el formato: Excel (.xlsx) o JSON.

El archivo se descarga y Prolibu muestra cuántos registros exportó. Si antes marcaste algunas apps, se exportan solo esas. Los detalles de cada formato están en Exportar tus registros.

Eliminar una app

1. En la lista de Apps OAuth, pulsa el menú ⋯ de la fila de la app.
2. Elige Eliminar.
3. En la ventana ¿Eliminar este registro?, pulsa Eliminar. Esta acción no se puede deshacer.

La app desaparece de la lista. Si solo quieres dejar de usarla por un tiempo, es mejor desactivarla.