La guía de Azure de este sitio explica en cinco pasos cómo crear el service principal desde el portal y pegarlo en Control Cloud. Search Console muestra búsquedas que llegan sin una página que las responda: "azure service principal", "service principal azure", "control de acceso en azure". Esta nota las responde con la CLI: qué es un service principal y en qué se diferencia de un app registration y de una managed identity, cómo crearlo con el rol Reader en un solo comando, qué rol suma la lectura de costos, cuándo vence el secret y cómo comprobar que de verdad no puede escribir. Los comandos y los nombres de roles salen de Microsoft Learn; la lista de fuentes está al final.
App registration, service principal y managed identity
- App registration (el application object): la definición global de la aplicación, que vive en el tenant donde se registró. Ahí están el client ID y las credenciales.
- Service principal: según Microsoft Learn, la representación local de ese application object en un tenant. Es la identidad a la que Azure RBAC le asigna roles. Al registrar una aplicación, el service principal se crea solo; por eso en el portal parecen la misma cosa.
- Managed identity: un service principal que administra Azure para código que corre dentro de Azure (una VM, una Function). No hay secreto que guardar ni rotar. Si la herramienta que lee tu cuenta corre afuera de Azure, no sirve: necesitás un service principal con secret o certificado.
Crearlo con el rol Reader en un solo comando
az ad sp create-for-rbac registra la aplicación, crea el service principal y le asigna el rol en un paso. Microsoft Learn recomienda pasar siempre --role y --scopes: sin ellos el service principal existe, pero no tiene acceso a ningún recurso. Para crearlo necesitás User Access Administrator o Role Based Access Control Administrator (o más) en la suscripción.
# la suscripción activa de tu sesión de az
SUB=$(az account show --query id --output tsv)
az ad sp create-for-rbac --name "inventario-solo-lectura" \
--role Reader \
--scopes "/subscriptions/$SUB"
La salida es un JSON con cuatro campos:
{
"appId": "00000000-0000-0000-0000-000000000000",
"displayName": "inventario-solo-lectura",
"password": "...",
"tenant": "00000000-0000-0000-0000-000000000000"
}
appId es el client ID, password es el client secret y tenant es el tenant ID. El secret no se puede volver a leer: si se pierde, se genera otro con az ad sp credential reset. Dos avisos de la documentación: si otro objeto del directorio tiene el mismo display name, el comando puede modificarlo, así que usá un nombre único; y si tu directorio tiene "Users can register applications" en No, el comando falla con "Insufficient privileges to complete the operation" hasta que un admin de Entra te dé un rol como Application Developer.
Reader es el rol built-in que Microsoft describe como "View all resources, but does not allow you to make any changes". Su única acción es */read sobre el control plane y no tiene DataActions: ve que existe una storage account, pero no lee los blobs que guarda.
Menos alcance: resource groups en vez de la suscripción
--scopes acepta varios scopes separados por espacios. Si la herramienta sólo tiene que ver dos resource groups, dáselos a ellos y no a la suscripción entera:
az ad sp create-for-rbac --name "inventario-dos-rg" \
--role Reader \
--scopes "/subscriptions/$SUB/resourceGroups/prod-web" \
"/subscriptions/$SUB/resourceGroups/prod-db"
El costo de achicar el scope es que el inventario también se achica: lo que esté fuera de esos resource groups no aparece. Para un inventario completo, el scope correcto es la suscripción; para un equipo que sólo opera su parte, el resource group.
Costos: Reader no alcanza
Para ver costos a nivel de suscripción o de resource group, Microsoft Learn pide al menos Cost Management Reader (o Contributor). Con acuerdos Enterprise también tiene que estar activado "AO view charges", y con Microsoft Customer Agreement la opción "Azure charges" del perfil de facturación. En el código de Control Cloud la consulta a la API de Cost Management con un service principal que sólo tiene Reader vuelve con 403. El rol se suma al mismo service principal:
az role assignment create --assignee "$APP_ID" \
--role "Cost Management Reader" \
--scope "/subscriptions/$SUB"
Asignarlo requiere Owner o User Access Administrator sobre ese scope. Cost Management Reader lee costos y no modifica recursos, así que la credencial sigue sin poder escribir.
El secret vence: cuánto dura y cómo rotarlo
create-for-rbac crea el secret con un año de validez si no pasás --years. Desde el portal, en Certificates & secrets, el máximo es 24 meses y Microsoft recomienda menos de 12. La misma página recomienda certificados o credenciales federadas en lugar de secrets para producción. Si usás secret, la rotación sin corte es agregar uno nuevo antes de borrar el anterior:
# cuándo vence cada credencial (el valor no se puede recuperar)
az ad app credential list --id "$APP_ID"
# uno nuevo, SIN borrar el actual
az ad app credential reset --id "$APP_ID" --append --years 1
# cuando el consumidor ya usa el nuevo, el viejo se borra por su keyId
az ad app credential delete --id "$APP_ID" --key-id "$KEY_ID_VIEJO"
Sin --append, reset reemplaza las credenciales existentes y el consumidor que usaba la anterior deja de autenticar en ese momento. Anotá el vencimiento: el día que vence, la integración deja de leer sin más aviso que un error de login.
Comprobar que sólo lee
Antes de pegarlo en ningún lado, iniciá sesión con el service principal y probá las dos cosas. read -sp evita que el secret quede en el historial de la shell:
read -sp "client secret: " AZ_PASS && echo
az login --service-principal -u "$APP_ID" -p "$AZ_PASS" --tenant "$TENANT"
# leer: tiene que andar
az group list --output table
# escribir: tiene que fallar con AuthorizationFailed
az group create --name prueba-escritura --location eastus
# qué roles tiene y sobre qué scope
az role assignment list --assignee "$APP_ID" --all --output table
La creación del resource group tiene que fallar con AuthorizationFailed y un mensaje que dice que el cliente "does not have authorization to perform action" sobre ese scope. Si se crea, el service principal tiene un rol de escritura heredado de otro lado: la última línea muestra cuál y sobre qué scope. Borrá el resource group de prueba con tu usuario y sacale ese rol.
Usarlo en Control Cloud
El formulario de Azure en Control Cloud pide tenant ID, client ID y client secret; el subscription ID es opcional. Vacío, Control Cloud descubre todas las suscripciones a las que ese service principal tiene acceso, así que el scope que le diste arriba decide qué aparece en el mapa; con un ID, lee sólo esa suscripción. Las credenciales quedan cifradas. Con Reader se dibujan resource groups, VMs y redes; el panel de costos necesita además Cost Management Reader y, si falta, muestra estos mismos pasos. Prender o apagar VMs desde Control Cloud requiere un rol con permisos de escritura sobre las VMs, como indica la guía de Azure. Si querés probarlo con tu suscripción, pedí acceso.
Fuentes
- Microsoft Learn, "Create Azure service principals using the Azure CLI" y "Reset service principal credentials using the Azure CLI".
- Microsoft Learn, "Application and service principal objects in Microsoft Entra ID" y "What are managed identities for Azure resources?".
- Microsoft Learn, "Add and manage app credentials in Microsoft Entra ID" (vencimiento de los client secrets).
- Microsoft Learn, "Azure built-in roles for General" (rol Reader) y "Assign access to Cost Management data".
- Referencia de la CLI: az ad sp, az ad app credential y az role assignment.
- En este repositorio: el formulario de conexión de Azure (ConnectionsPage.tsx), el descubrimiento de suscripciones (orgcreds/livefetch.go) y la consulta de costos (azuremap/cost.go).
Top comments (0)