Azure — Descubrimiento
Conecte su inquilino de Azure para que SecureAI inventaríe sus recursos de IA en Azure y todas las identidades no humanas (NHI) de Microsoft Entra ID, con los roles y permisos que tiene cada una.Esta conexión solo lee y nunca envía un prompt. Si lo que busca es ejecutar el tráfico de LLM de SecureAI en su propio recurso de Foundry, consulte Azure AI Foundry — Inferencia en tu cuenta. Son dos conexiones independientes, con principales de servicio y permisos distintos, y puede usar las dos sobre la misma suscripción.
Qué importa SecureAI
En cada suscripción que el principal de servicio puede leer:- Recursos de IA: todas las cuentas de Azure AI Services, Azure OpenAI y demás Cognitive Services (Content Safety, Speech, Language, Document Intelligence…), con su región y estado.
- Despliegues de modelos de Azure OpenAI y Foundry, con su capacidad y el uso de los últimos 30 días (solicitudes y tokens de entrada y de salida, tomados de Azure Monitor).
- Proyectos y agentes de Foundry: los agentes de Foundry Agent Service y los asistentes clásicos de cada proyecto, con el modelo que usa cada uno. También los hubs y proyectos basados en hub (Azure Machine Learning), con sus endpoints en línea y sin servidor.
- Azure AI Search y Azure Bot Service.
- Costo del mes en curso por servicio (Cost Management).
- Actividad: los eventos de administración de Cognitive Services y Machine Learning de los últimos 30 días (Registro de actividad).
- NHI, visibles en el Inventario de NHI:
- Principales de servicio de las aplicaciones empresariales.
- Identidades de agente de Microsoft Entra, las que Foundry crea para cada agente (se clasifican como agente).
- Identidades administradas, asignadas por el sistema y por el usuario.
- Secretos de cliente y certificados de los registros de aplicaciones, con su vencimiento.
- Credenciales federadas (federación de identidades de carga de trabajo). Por ejemplo, la confianza OIDC de un repositorio de GitHub Actions le permite a ese repositorio obtener tokens como la aplicación, sin ningún secreto.
- El último inicio de sesión de cada aplicación, cuando su inquilino expone ese informe.
- Permisos de cada identidad: sus roles de Azure RBAC en cualquier alcance de la suscripción (suscripción, grupo de recursos o recurso), sus permisos de aplicación de Microsoft Graph y sus roles de directorio de Entra.
- Asignaciones de roles RBAC: cada rol con su nombre y los usuarios, grupos y aplicaciones que lo tienen.
- uno de los roles Owner, Contributor, User Access Administrator o Role Based Access Control Administrator;
- un permiso de Graph de escritura, por ejemplo
Application.ReadWrite.All,Directory.ReadWrite.All,Mail.SendoFiles.ReadWrite.All; - un rol de administrador del directorio, por ejemplo Global Administrator o Application Administrator.
Requisitos previos
Un registro de aplicación de Microsoft Entra ID (principal de servicio) con un secreto de cliente y estos permisos:
Los permisos de Graph necesitan consentimiento de administrador. Para leer todas sus suscripciones, asigne Reader en cada una o en un grupo de administración que las contenga.
Los agentes de Foundry viven en el plano de datos del proyecto, no en Azure Resource Manager: Reader no alcanza para verlos. Sin Cognitive Services Data Reader (o Foundry User) sobre el recurso de Foundry, la sincronización funciona igual, pero la lista de agentes queda vacía y SecureAI lo muestra como una brecha. Cognitive Services Data Reader es el rol más acotado que lo permite: solo da lectura del plano de datos.
Paso 1. Cree el principal de servicio
Con la CLI de Azure
Desde Azure Cloud Shell o con la CLIaz. Reemplace SUB_ID por su suscripción y, si usa Foundry, MY_RESOURCE y MY_RG por su recurso y su grupo de recursos:
1bfefb4e-e0b5-418b-a88f-73c46d2cc8e9=Role (Application.ReadWrite.All) en el paso 3 y vuelva a dar el consentimiento.
Con el portal de Azure
- En el portal de Azure, vaya a Microsoft Entra ID → Registros de aplicaciones → Nuevo registro, póngale un nombre (por ejemplo
SecureAI Discovery) y regístrela. - En Información general, copie el Id. de directorio (inquilino) y el Id. de aplicación (cliente).
- En Certificados y secretos → Secretos de cliente → Nuevo secreto de cliente, créelo y copie su Valor (se muestra una sola vez).
- En Permisos de API → Agregar un permiso → Microsoft Graph → Permisos de aplicación, agregue
Application.Read.All,Directory.Read.AllyAuditLog.Read.All(yApplication.ReadWrite.Allsi quiere revocar desde SecureAI). Luego haga clic en Conceder consentimiento de administrador. - En Suscripciones → su suscripción → Control de acceso (IAM) → Agregar asignación de roles, asigne Reader y Cost Management Reader a la aplicación.
- En su recurso de Foundry → Control de acceso (IAM), asigne Cognitive Services Data Reader a la aplicación.
Los roles de Azure pueden tardar hasta 5 minutos en aplicarse, y el consentimiento de Graph unos minutos más. Si la primera sincronización muestra brechas por permisos recién asignados, espere y sincronice de nuevo.
Paso 2. Conecte Azure en SecureAI
- Vaya a Administrador → Integraciones, filtre por Nube y, en la tarjeta Azure — Descubrimiento, haga clic en Conectar Integración.
-
Complete los campos:
- Haga clic en Conectar. Antes de guardar, SecureAI prueba las credenciales con una lectura real: si el secreto es incorrecto o el principal no puede leer la suscripción, no se guarda nada y el mensaje dice qué falta. Si se conecta pero falta un permiso de Graph, el aviso nombra el permiso.
- Sincronice con el botón de actualizar de la tarjeta. Una sincronización de Azure puede tardar varios minutos (recorre Azure Resource Manager, Microsoft Graph, Azure Monitor y Cost Management). Después, SecureAI sincroniza solo cada 6 horas.
Paso 3. Verifique
- En Sensores de nube se ven los despliegues, agentes y servicios descubiertos. Haga clic en la tarjeta de Azure para abrir sus Insights:
- Uso y costos: uso y costo;
- Modelos y despliegues: despliegues y agentes;
- Identidad y acceso: identidades con sus roles y la marca Privilegiada; secretos, certificados y credenciales federadas; roles RBAC con sus miembros;
- Auditoría y logs: la actividad.
- El Inventario de NHI muestra los principales de servicio, identidades de agente, identidades administradas, secretos, certificados y credenciales federadas, con sus permisos y si son privilegiados.
Brechas de cobertura
Lo que SecureAI no pudo leer no se omite en silencio: al conectar o sincronizar, el aviso nombra el permiso que falta.
Una lectura parcial (un permiso que falta, una página que Azure no devolvió o una limitación de solicitudes) nunca retira agentes ni elimina identidades del inventario: SecureAI solo da algo por borrado cuando el listado que lo mostraría respondió completo. Sin las asignaciones de roles, los permisos de una identidad quedan como desconocidos, no como “ninguno”.
Revocación
Desde el Inventario de NHI (candado), conApplication.ReadWrite.All:
Protecciones:
- SecureAI no ofrece revocar el principal de servicio con el que se conecta ni sus secretos, porque cortaría el descubrimiento. Rótelos en Entra ID.
- Las identidades administradas asignadas por el sistema no se revocan desde SecureAI: su ciclo de vida es el del recurso de Azure.
- Las credenciales federadas que Foundry mantiene en el blueprint de identidad de un agente tampoco se revocan desde SecureAI: si se cortan, el agente deja de funcionar.
- Las políticas automáticas de NHI (revocación por antigüedad o por falta de uso) todavía no se aplican a Azure: la revocación es manual.

