# Acceso administrativo de SaaS para agentes de IA: sustituye los tokens amplios Los agentes de IA pueden encargarse de la administración de SaaS sin llevar un token de administrador con poderes ilimitados. El diseño seguro es más limitado y exige más trabajo: describe cada cambio permitido como una acción, vincúlalo a un único tenant y a un conjunto pequeño de entradas, mantén las credenciales fuera del modelo y exige una decisión humana cuando la consecuencia lo merezca. Un token amplio parece eficiente porque elimina obstáculos durante la configuración. También convierte cada prompt, documento importado, respuesta de un conector y error del modelo en una posible solicitud de administrador. He visto equipos llamar «temporal» a este acceso y descubrir meses después que su pequeña automatización tenía control sobre usuarios, facturas, asignaciones de roles y configuración del espacio de trabajo a través de una credencial olvidada. El consejo habitual de aplicar el mínimo privilegio es correcto, pero incompleto. Los scopes rara vez responden por sí solos a si un agente debe eliminar a un usuario concreto, modificar un grupo concreto o cambiar una suscripción. Los administradores necesitan límites que correspondan al trabajo y pruebas que les permitan reconstruir cada solicitud después. ## Los tokens de administrador amplios convierten el trabajo rutinario en respuesta a incidentes Un único token de administrador da al agente una autoridad que supera casi cualquier tarea que le asignarás. La mayor parte de la administración de SaaS pertenece a cuatro clases de riesgo distintas: gestionar la cuenta de una persona, cambiar la pertenencia a grupos, leer o afectar al dinero y modificar el propio espacio de trabajo. Tratar todo eso como un único conjunto de permisos es la forma en que el trabajo rutinario de soporte encuentra una salida hacia la transferencia de propiedad o la eliminación de cuentas. Considera la solicitud: «Elimina a los contratistas cuyos encargos terminaron esta semana». El agente necesita una lista fiable de identidades aprobadas, un espacio de trabajo de destino y permiso para suspender o desaprovisionar esas identidades. No necesita crear un espacio de trabajo, cambiar una configuración de dominio, modificar facturas ni concederse un rol de administrador. Sin embargo, un token de API de administrador suele permitir muchas o todas esas llamadas. El problema no empieza únicamente cuando el modelo es malicioso o defectuoso. Empieza cuando el agente lee un ticket de soporte con un nombre ambiguo, recibe una hoja de cálculo con una instrucción hostil incrustada en una celda o reintenta una solicitud contra el tenant equivocado después de un error. Un token amplio da a cada uno de esos fallos más autoridad de la que justifica la tarea original. No confundas un token con una acción. Un token responde a «¿A qué rutas de la API puede llegar este llamador?». Una acción responde a «¿Qué cambio exacto puede solicitar esta ejecución, contra qué objeto y con qué entradas?». Esa diferencia determina si tu plano de control puede rechazar una solicitud insegura antes de que el proveedor de SaaS la vea. La recomendación popular de emitir una cuenta de servicio con un rol de administrador resulta atractiva porque las guías de configuración de los proveedores la hacen fácil y la automatización interna necesita una primera victoria. Sigue siendo incorrecta para los agentes. Las cuentas de servicio se diseñaron para programas deterministas cuyo código fuente, entradas y rutas de llamada los administradores esperaban controlar. La siguiente solicitud de un agente se genera a partir de un contexto cambiante. Dale un radio de impacto menor. ## Empieza con un inventario de verbos administrativos reales Un inventario de acceso debe enumerar acciones, no productos ni cargos. «El agente administra nuestra suite de colaboración» no dice nada útil. «El agente suspende a los usuarios indicados en registros de baja aprobados» te da algo que un ingeniero puede implementar y un administrador puede revisar. Recopila tickets recientes, procedimientos operativos y entradas de auditoría. Después reduce cada tarea recurrente a un verbo, un objeto y una consecuencia. Evita agruparlas según las etiquetas del menú del proveedor. Las consolas de SaaS suelen colocar poderes no relacionados detrás del mismo rol de administrador porque eso sirve a un operador humano, no a un llamador automatizado. Un inventario inicial práctico podría incluir: - Leer el perfil de un usuario mediante su ID de usuario inmutable. - Suspender a un usuario cuando exista un registro de aprobación identificado. - Añadir a un usuario a un grupo aprobado concreto. - Exportar facturas de un periodo contable especificado. - Leer una lista fija de configuraciones permitidas del espacio de trabajo. Anota también la acción que las personas dan por supuesta para más adelante. «Actualizar cualquier configuración del espacio de trabajo» no es una acción. Divídela en configuraciones como duración de la sesión, dominios permitidos, uso compartido externo o retención. Cada una tiene distintos modos de fallo y distintas personas que deberían aprobarla. Usa IDs inmutables en el contrato de acción siempre que el proveedor los ofrezca. Las direcciones de correo cambian. Los nombres visibles pueden coincidir. Una solicitud que acepta «Alex Kim» y selecciona la primera coincidencia es un incidente esperando a que se reorganice la nómina. El agente puede buscar y presentar candidatos si resulta útil, pero exige un ID único antes de cambiar nada. Este inventario revela un hecho incómodo: parte de la automatización solicitada todavía no está lista para delegarse. Si nadie puede decir quién puede ser eliminado, qué grupos pueden cambiar o dónde está la fuente de verdad, el problema es de gobernanza. Un agente de IA no lo reparará. Hará visible la decisión que falta a velocidad de máquina. ## Un contrato de acción debe limitar el objetivo y la carga útil Un catálogo de acciones debe definir más que un nombre sencillo y un endpoint de API. Tiene que limitar el objetivo, los campos aceptados, la fuente de autoridad y la respuesta que vuelve al agente. De lo contrario, un wrapper aparentemente limitado se limita a reenviar JSON arbitrario a una API de administrador potente. Este ejemplo describe una acción de suspensión. Es intencionadamente pequeño. Una implementación de producción puede usar un validador de esquemas, pero las restricciones deben existir en algún lugar que el agente no pueda reescribir durante su propia ejecución. ```json { "name": "suspend_user", "tenant": "acme-workspace", "method": "POST", "path_template": "/v1/users/{user_id}/suspend", "inputs": { "user_id": {"type": "string", "pattern": "^usr_[A-Za-z0-9]+$"}, "approval_ref": {"type": "string", "pattern": "^OFF-[0-9]+$"}, "reason": {"type": "string", "max_length": 240} }, "forbidden_inputs": ["role", "owner", "tenant_id", "credential"], "requires_approval": true } ``` La línea `forbidden_inputs` evita un fallo habitual de los wrappers. Alguien crea un endpoint seguro y después añade un objeto genérico `options` para cubrir necesidades futuras. Ese objeto se convierte en un túnel para campos como `is_admin`, `transfer_ownership` o un tenant de destino. Rechaza los campos desconocidos. Las necesidades futuras merecen una acción nueva y una revisión. Vincula el tenant en la definición de la acción en lugar de aceptarlo del agente. Si gestionas varios espacios de trabajo, crea entradas de acción separadas y haz que un aprobador seleccione el destino. Una carga útil que incluye `tenant_id` resulta cómoda hasta que un agente copia una referencia de un entorno de cliente en otro. La respuesta también importa. Devuelve el ID de usuario, el estado anterior, el estado nuevo, la marca de tiempo y el identificador de la solicitud al proveedor si la API ofrece uno. No devuelvas un objeto de cuenta sin restricciones que contenga datos de recuperación, campos personales o tokens solo porque el endpoint del proveedor los devuelve. Controlar la salida limita el material que puede alimentar el razonamiento posterior del agente. La idempotencia merece un campo explícito cuando el proveedor la admite. Un reintento después de un fallo de red debe producir un resultado conocido, no una segunda invitación, un cargo duplicado o una modificación repetida de un grupo. Guarda el ID de la solicitud de acción y asocia los reintentos con él. No pidas a un modelo de lenguaje que deduzca si la llamada anterior tuvo éxito a partir de un mensaje de error impreciso. ## Los scopes de OAuth son necesarios, pero a menudo demasiado amplios Los scopes de OAuth restringen una credencial y debes usar los scopes más limitados que ofrezca el proveedor. No expresan automáticamente tu regla operativa. Un scope como `users.write` puede permitir suspender, eliminar, editar perfiles y cambiar roles de cualquier usuario de un tenant. Tu agente puede necesitar solo una de esas operaciones. RFC 6749 define los scopes como cadenas que limitan una solicitud de acceso y deja su significado en manos del servidor de autorización. Esa flexibilidad explica por qué los nombres de scopes varían tanto entre proveedores y por qué los administradores no pueden inferir un comportamiento seguro a partir de una etiqueta. Lee la referencia de API del proveedor para cada método de escritura incluido en un scope aprobado. Los nombres de los scopes no sustituyen una revisión de seguridad. RFC 8707 añade indicadores de recursos a las solicitudes de OAuth, de modo que un cliente puede pedir un token dirigido a un recurso protegido concreto. Usa restricciones de recurso cuando el proveedor de SaaS las admita, especialmente cuando una misma identidad pueda acceder a varios tenants o API. Un indicador de recurso puede limitar la audiencia prevista del token. Aun así, no indica al proveedor que tu agente puede suspender usuarios, pero no eliminarlos. Separa las credenciales por familia de acciones siempre que sea posible. Una credencial de directorio de solo lectura nunca debería compartir autoridad con una credencial que cambia la facturación solo porque ambas se usan en un informe mensual. Esta separación hace que la rotación sea menos disruptiva y limita los daños cuando se filtra un token del proveedor o falla una configuración. Presta atención a un patrón especialmente peligroso: un cliente solicita un conjunto pequeño de scopes, pero lo intercambia a través de un servicio de administrador que acepta rutas posteriores arbitrarias. El registro de inventario muestra un acceso limitado, mientras que la cuenta de servicio que hay detrás tiene autoridad sin restricciones. Inspecciona toda la ruta de llamada. El permiso efectivo es el que se aplica en el punto donde el proveedor procesa la solicitud. Evita guardar tokens bearer en la configuración del agente, archivos de prompts, historial del shell o salida de herramientas. Ocultarlos después de exponerlos no devuelve el token a tu control. El agente debe solicitar una acción identificada con parámetros normales. Un componente separado debe inyectar la credencial solo para esa llamada saliente y devolver el resultado limitado. ## Los cambios de usuarios y grupos necesitan rutas de escalada separadas La automatización del ciclo de vida de usuarios es más segura cuando sigue una fuente de identidad declarada y no una instrucción de chat. SCIM, especificado en RFC 7644, define un protocolo para aprovisionar y gestionar recursos de identidad. Ofrece a las organizaciones una estructura estándar para operaciones de creación, sustitución, actualización parcial, consulta y desaprovisionamiento. No decide si es legítima una solicitud para convertir a alguien en administrador. Usa SCIM o la API de ciclo de vida compatible con el proveedor para el trabajo habitual de incorporaciones, cambios y bajas cuando tengas un directorio autoritativo. Da al agente permiso para preparar un cambio propuesto a partir de esa fuente y vincula la solicitud al registro de identidad que lo justifica. Si una persona dice «elimina a Sam», el agente debe localizar el registro y presentar la identidad coincidente. No debe adivinar entre nombres similares. La pertenencia a grupos requiere más atención de la que muchos equipos le dedican. Un grupo llamado `Engineering` puede ser inofensivo en un producto y conceder acceso al código fuente, privilegios de despliegue o informes financieros en otro. Clasifica los grupos según los permisos que conceden, no por sus nombres amigables. Mantén los grupos privilegiados en una familia de acciones separada, con un aprobador identificado y una duración de sesión más corta. La asignación de roles no es mantenimiento ordinario de perfiles. Cambia quién puede realizar cambios posteriores, posiblemente fuera de la ruta de auditoría del agente. Coloca la elevación de roles, la transferencia de propiedad, los cambios de métodos de recuperación y la configuración de federación detrás de acciones que exijan una decisión humana por llamada. En muchas organizaciones, el agente debería preparar la solicitud y reunir pruebas, mientras una persona ejecuta la operación final en la consola del proveedor. Un flujo de baja fallido suele parecer algo cotidiano. El agente recibe un ticket para `jordan.lee@company.example`, busca por nombre visible, encuentra a un empleado activo con un nombre parecido y lo elimina de un grupo de alto acceso. Después reintenta con el registro correcto del contratista cuando el operador corrige el ticket. Las dos acciones tienen éxito según la API. El fallo está en el diseño de la acción: se permitió buscar por nombre y realizar una mutación privilegiada en un único paso sin revisión. Corrige ese flujo separando el descubrimiento de la mutación. Permite que el agente devuelva identidades candidatas con sus IDs inmutables y las pertenencias actuales a grupos. Exige que el registro de aprobación contenga el ID seleccionado. La acción de suspensión o eliminación del grupo debe aceptar únicamente ese ID. Ese paso adicional no es burocracia. Evita que una consulta ambigua se convierta en un cambio de permisos. ## Los permisos de facturación deben detenerse antes de mover dinero Los datos de facturación suelen necesitar automatización, pero la autoridad de facturación tiene un límite claro: leer una factura no es lo mismo que cambiar quién paga. No coloques informes, actualizaciones de pagos, cambios de suscripción, reembolsos y configuración fiscal detrás de una sola credencial solo porque el proveedor los llame funciones de administrador de facturación. Una acción de exportación de solo lectura puede aceptar un intervalo de fechas con un máximo razonable, devolver identificadores y totales de facturas y registrar la solicitud. No debería exponer al contexto del agente instrumentos de pago completos, documentos fiscales ni perfiles de facturación arbitrarios de clientes, salvo que una tarea real necesite esos campos. Minimiza tanto el acceso como los datos de respuesta. Trata las siguientes operaciones como acciones de alto impacto aunque la API del proveedor las haga parecer rutinarias: - Cambiar un método de pago o contacto de facturación. - Aumentar el número de puestos, el nivel de suscripción o los límites de consumo. - Cancelar una suscripción o emitir un crédito. - Modificar datos fiscales, de entidad legal o de orden de compra. - Crear un usuario que pueda administrar la facturación. Exige una aprobación por llamada que muestre el tenant exacto del proveedor, el ID de la cuenta o suscripción, el valor anterior, el valor propuesto y el efecto económico cuando la API pueda ofrecerlos. «Aprobar actualización de facturación» es un aviso diseñado para pulsar sin leer. La persona que aprueba debe ver qué cambiará. Las protecciones presupuestarias también deben estar fuera del modelo. Si una acción de suscripción puede aumentar un límite, establece un tope fijo en la definición de la acción o rechaza el cambio hasta que una persona seleccione un valor aprobado. No pidas al agente que decida si un aumento del gasto es razonable basándose en un documento de políticas dentro de su ventana de contexto. Algunos equipos intentan resolver el riesgo de facturación con un resumen diario de acciones. Un resumen es útil para revisar, pero no puede revertir un cargo antes de que ocurra. Úsalo para operaciones de lectura y conciliaciones de bajo impacto. Coloca el consentimiento delante de cualquier llamada financiera irreversible. ## La configuración del espacio de trabajo necesita una ventana de cambio, no libertad permanente La configuración del espacio de trabajo se subestima con facilidad porque aparece como interruptores en una consola de administración. Una configuración de uso compartido externo, verificación de dominios, duración de sesión o retención de datos puede afectar a todos los usuarios a la vez. Por eso una pequeña solicitud de API puede tener más consecuencias que cientos de ediciones normales de cuentas. Define una acción de configuración para cada ajuste o para cada familia estrechamente relacionada. Cada definición debe incluir los valores permitidos, la lectura del estado actual de la que depende y un valor de reversión. No permitas que un agente envíe un bloque de configuración arbitrario a un endpoint general de configuración. Los endpoints generales envejecen mal: los proveedores añaden campos y tu automatización, antes limitada, hereda poderes que nunca revisaste. Exige que la acción lea el valor actual inmediatamente antes de proponer una escritura. La aprobación debe mostrar ambos valores y el alcance del impacto. Así evitas que un operador apruebe un plan obsoleto después de que otro administrador ya haya cambiado la configuración. Usa una ventana de cambio para configuraciones que puedan interrumpir el inicio de sesión, el uso compartido, el aprovisionamiento o la retención de datos. El agente puede recopilar la configuración actual, preparar una solicitud de cambio y realizar la acción solo durante la ventana definida. Para una corrección urgente, usa una acción de emergencia separada, con un campo de motivo explícito y una ruta de notificación inmediata. No disfraces el acceso de emergencia como una excepción normal de automatización. Prueba la reversión en un tenant que no sea de producción si el proveedor ofrece uno. Si no lo ofrece, selecciona una configuración reversible y documenta el comportamiento del proveedor antes de automatizarla. Un plan de reversión que depende de que «el agente lo vuelva a dejar como estaba» no es un plan cuando la solicitud original agotó el tiempo de espera o el proveedor normalizó el valor al escribirlo. ## La aprobación humana funciona cuando se vincula a una ejecución concreta La aprobación solo sirve cuando la persona ve quién solicita la acción, qué hará y cuánto tiempo durará el permiso. Una aprobación genérica para «el asistente de IA» se convierte en autoridad permanente con una redacción más amable. Vincula la aprobación de sesión a un único proceso de agente y revócala cuando el proceso termine o cambie su propósito. Usa aprobación por llamada para cambios cuyo riesgo dependa del objetivo y la carga útil: pertenencia a grupos privilegiados, elevación de roles, cambios de facturación, eliminación, transferencias de propiedad y configuraciones que afecten a todo el espacio de trabajo. Usa una aprobación de sesión para una secuencia limitada de llamadas de bajo impacto, como leer usuarios y preparar candidatos para una baja. No pidas un clic para cada consulta de directorio. La gente dejará de leerlas. Sallyport aplica esta separación mediante una barrera absoluta de la bóveda, autorización por sesión y aprobación opcional por clave en cada uso. Su ruta MCP orientada a agentes puede ejecutar acciones HTTP o SSH sin exponer la credencial almacenada al agente. El registro de aprobación debe incluir la identidad del proceso llamador cuando tu sistema operativo pueda establecerla. El nombre del proceso por sí solo es una prueba débil porque cualquier proceso puede elegir un nombre conocido. La autoridad de firma de código, la duración del proceso y la solicitud de acción proporcionan al aprobador contexto suficiente para rechazar una solicitud procedente de una herramienta inesperada. La aprobación no compensa un catálogo de acciones que permite demasiado. Si un prompt dice «cambia la configuración del espacio de trabajo» y la tarjeta de aprobación repite esa frase, la persona debe reconstruir la propuesta en otro lugar. Haz que la carga útil de aprobación sea concreta. El diseño debe forzar una decisión sobre un tenant identificado, un objeto, el valor anterior, el valor propuesto y el motivo. ## Las pruebas deben sobrevivir a la sesión del agente El registro de auditoría del proveedor de SaaS es necesario, pero quizá no indique por qué un agente hizo una solicitud, qué proceso local la inició o si una persona la aprobó. Conserva un registro de acciones separado que vincule la ejecución del agente, el evento de aprobación, el contrato de acción, la solicitud saliente, la respuesta del proveedor y el evento de revocación. Registra cuidadosamente los campos de la solicitud. Necesitas suficiente detalle para reconstruir una acción, pero no debes convertir el sistema de auditoría en otro montón de secretos. Guarda identificadores, transiciones de estado, hashes de solicitudes cuando corresponda, IDs de solicitudes del proveedor y una representación protegida de los valores sensibles. Decide de antemano quién puede leer registros detallados durante un incidente. La evidencia contra manipulaciones importa porque un proceso local comprometido puede intentar borrar el rastro después de una llamada insegura. Un registro encadenado mediante hashes te permite verificar que las entradas no se han alterado ni eliminado sin reescribir los registros posteriores. No demuestra que cada acción fuera acertada. Demuestra si el registro conserva su continuidad, que es una afirmación distinta y útil. Por ejemplo, Sallyport proyecta diarios de sesiones y actividad desde un registro de auditoría cifrado y encadenado mediante hashes, y `sp audit verify` comprueba esa cadena sin conexión, sin necesitar un secreto de la bóveda. Esa verificación debe formar parte del procedimiento de respuesta a incidentes, no ser un comando que alguien descubre cuando ya lo necesita. Organiza un simulacro de revocación basado en la ruta de autoridad real. Termina la ejecución del agente, rechaza futuras solicitudes de acción, revoca o rota la credencial de SaaS afectada si es posible que haya quedado expuesta, verifica el registro de auditoría y compara los cambios del proveedor con el registro de acciones. Un equipo que solo puede revocar una sesión de chat no ha revocado el acceso administrativo. ## Sustituye el acceso por partes y rechaza los atajos tentadores La migración funciona cuando sustituyes una ruta de permisos amplia por una ruta de acciones limitadas, la pruebas en situaciones de fallo y después eliminas la autoridad antigua. Intentar rediseñar todas las integraciones de SaaS a la vez garantiza que el antiguo token de administrador se quede «hasta que termine el proyecto». Después se volverá permanente. Elige una tarea con una fuente de verdad estable y un resultado reversible. Preparar la suspensión de una cuenta suele ser mejor que eliminarla. Exportar facturas es mejor que cambiar pagos. Captura la secuencia de llamadas existente y determina después cada endpoint y campo que la tarea usa realmente. La mayoría de los equipos descubre que su credencial de administrador supuestamente necesaria existe por un endpoint extraño que nadie ha revisado de nuevo. Ejecuta la nueva ruta de acciones con entradas incorrectas deliberadas antes de confiar en su funcionamiento normal. Envía un campo desconocido. Envía un ID de usuario de otro tenant. Reintenta después de un tiempo de espera simulado. Envía una solicitud con una referencia de aprobación caducada. El resultado correcto es un rechazo con una entrada de auditoría, no una suposición aproximada. Después elimina el token antiguo de la configuración del agente, los registros de compilación, los almacenes de secretos accesibles al agente y los scripts de copia de seguridad. Rotarlo no basta si el mismo rol amplio sigue disponible para la siguiente automatización. Confirma que el agente no puede llamar directamente al proveedor con una credencial que pueda leer. Mantén un registro de excepciones para las tareas que todavía necesitan a una persona en la consola. Incluye la acción requerida del proveedor, el motivo por el que no existe una ruta de API limitada, los operadores aprobados y una fecha de revisión. Las excepciones visibles se vuelven a revisar. Las excepciones ocultas en un procedimiento se convierten en la siguiente justificación para usar un token amplio. La prueba para cada privilegio de agente propuesto es sencilla: ¿puedes describir el objetivo exacto, el cambio permitido, la condición de aprobación y las pruebas que quedarán? Si no puedes, el agente todavía no tiene una tarea. Tiene un token de administrador esperando a que ocurra un accidente.