La aplicación de Azure AD¶
tai-storage entra en SharePoint como una aplicación, sin usuario: con un tenant, un client id y un secreto. Esta página explica cómo darla de alta y cómo darle acceso solo al sitio que necesita.
Hace falta un administrador del tenant para dos pasos: el consentimiento del permiso (paso 3) y el acceso al sitio (paso 4).
1. Registrar la aplicación¶
- En el portal de Azure → Microsoft Entra ID (antes Azure Active Directory) → App registrations → New registration.
- Name: por ejemplo
tai-storage-<proyecto>. Supported account types: Accounts in this organizational directory only. Redirect URI: vacío. - Register. En la página Overview:
- Application (client) ID →
SHAREPOINT_CLIENT_ID - Directory (tenant) ID →
SHAREPOINT_TENANT_ID
- Application (client) ID →
2. Crear el secreto¶
- En la aplicación: Certificates & secrets → New client secret.
- Elige una caducidad (por ejemplo 24 meses) y apúntala: cuando caduque, tai-storage dará
AuthenticationError. - Copia el Value, que solo se muestra una vez →
SHAREPOINT_CLIENT_SECRET.
3. El permiso: Sites.Selected¶
- API permissions → Add a permission → Microsoft Graph → Application permissions.
- Añade
Sites.Selected. - Grant admin consent for … (un administrador).
Por qué Sites.Selected y no Sites.ReadWrite.All
Sites.ReadWrite.All da acceso a todos los sitios del tenant. Con Sites.Selected la
aplicación no ve ninguno hasta que se le concede uno concreto (paso 4): el secreto de un ETL
filtrado no expone el resto de la organización, y retirar el acceso a un sitio no obliga a
borrar la aplicación.
4. Darle acceso al sitio¶
Con Sites.Selected el acceso se concede sitio a sitio, con la API de Graph. Desde PowerShell,
con una cuenta de administrador:
Install-Module Microsoft.Graph -Scope CurrentUser # una vez
Connect-MgGraph -Scopes "Sites.FullControl.All" -NoWelcome
$hostName = "contoso.sharepoint.com"
$sitePath = "/sites/Ventas" # /teams/<nombre> en un sitio de Teams
$appId = "<SHAREPOINT_CLIENT_ID>"
$appName = "tai-storage-ventas"
$site = Invoke-MgGraphRequest -Method GET -Uri "https://graph.microsoft.com/v1.0/sites/$($hostName):$($sitePath)"
$body = @{
roles = @("write") # read si solo va a leer
grantedToIdentities = @(@{ application = @{ id = $appId; displayName = $appName } })
} | ConvertTo-Json -Depth 5
Invoke-MgGraphRequest -Method POST -Uri "https://graph.microsoft.com/v1.0/sites/$($site.id)/permissions" `
-Body $body -ContentType "application/json"
Para varios sitios, se repite la última petición con cada uno.
5. Configurar el proyecto¶
export SHAREPOINT_TENANT_ID="12345678-1234-1234-1234-123456789abc"
export SHAREPOINT_CLIENT_ID="87654321-4321-4321-4321-cba987654321"
export SHAREPOINT_CLIENT_SECRET="…"
export SHAREPOINT_HOSTNAME="contoso.sharepoint.com"
export SHAREPOINT_SITE_NAME="Ventas"
from tai_storage import StorageFactory
origin = StorageFactory.create_sharepoint() # pide el token y resuelve el sitio: si algo falla, falla aquí
print(origin.get_folder("").list_folders())
Comprobación¶
- [ ] Aplicación registrada; client id y tenant id copiados.
- [ ] Secreto creado; su caducidad, apuntada.
- [ ] Permiso
Sites.Selectedcon el consentimiento del administrador. - [ ] Acceso
write(oread) concedido al sitio del paso 4. - [ ] Hostname y nombre del sitio sacados de su URL.
- [ ]
pip install "tai-storage[sharepoint]".
| Lo que ves | Qué falta |
|---|---|
AuthenticationError |
Tenant, client id o secreto incorrectos, o el secreto ha caducado |
PermissionDeniedError |
El consentimiento del paso 3, o el acceso al sitio del paso 4 |
ConfigurationError: No existe el sitio … |
Hostname, nombre o site_path (sites o teams) |
Referencias de Microsoft: el permiso Sites.Selected
y cómo conceder acceso a un sitio.