App OAuth propia (BYOA)

Por defecto, las conexiones OAuth usan la app de la plataforma: una sola aplicación registrada por Zoan Automation ante el proveedor, compartida por todos los tenants. Esto da una experiencia de un clic, sin que configures nada.

BYOA (Bring Your Own App — “trae tu propia app”) te deja, opcionalmente, usar tu propia aplicación OAuth para un proveedor: tus credenciales (client_id / client_secret), tu pantalla de consentimiento y tus cuotas.

Es opcional

No necesitas BYOA para empezar. La app de la plataforma funciona para la mayoría de los casos. BYOA es para organizaciones con requisitos específicos.

Cuándo conviene usarla

• Marca propia: la pantalla de consentimiento muestra el nombre de tu organización, no “Zoan Automation”.
• Cumplimiento / TI: políticas que exigen que solo apps registradas por tu empresa accedan a su Workspace.
• Cuotas y límites: no compartes la cuota ni el límite de refresh tokens del app común — cada client_id de Google tiene un tope de refresh tokens, y al superarlo se invalida el más antiguo sin aviso.

Qué cambia y qué no

BYOA solo reemplaza el client_id y el client_secret. Las URLs del proveedor y el catálogo de scopes siguen viniendo de la plataforma. Todo lo demás (crear conexiones, autorizar, refrescar tokens) funciona igual.

	Con app de plataforma	Con BYOA
Quién registra la app	Zoan Automation	Tu organización
Consentimiento muestra	”Zoan Automation”	Tu marca
Cuotas / refresh tokens	Compartidos	Tuyos
Esfuerzo	Cero	Registrar una app una vez

Configurarla

1. En el proveedor (Google Cloud Console, Azure AD, etc.) registra tu propia app OAuth.
2. En el ambiente, abre Centro › Recursos › Integraciones › Administrar cuentas OAuth y permisos y pulsa Apps OAuth propias. Elige el proveedor y copia la Redirect URI que se muestra. El diálogo lista también los permisos que pedirá Zoan Cloud.
3. Registra esa Redirect URI en tu app del proveedor (es una sola URL, la misma para todos).
4. Agrega en tu app los scopes requeridos por el proveedor.
5. De vuelta en Apps OAuth propias, pega tu Client ID y Client Secret y pulsa Guardar.

La app propia es del tenant: vale para las conexiones de ese proveedor en todos los ambientes. Configurarla requiere el permiso de administrar conexiones.

Proveedores sin app compartida

Si un proveedor no tiene app de la plataforma, Nueva conexión lo avisa y te lleva a Apps OAuth propias: con ese proveedor, la app propia es obligatoria.

Desde ese momento, las conexiones de ese proveedor en tu tenant usan tu app. Las que ya existían seguirán funcionando; al reconectarlas pasan a usar tu app.

El secret se guarda cifrado

El client_secret se almacena cifrado y no se vuelve a mostrar. Al editar, deja el campo de secret vacío para conservar el actual; complétalo solo si quieres reemplazarlo.

Volver a la app de plataforma

En Apps OAuth propias, elige el proveedor y pulsa Eliminar. Las conexiones de ese proveedor vuelven a usar la app compartida de la plataforma en su próxima autorización.

Siguientes pasos

• Conexiones OAuth — crear y autorizar conexiones.