Saltar a contenido

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

  1. En el portal de Azure → Microsoft Entra ID (antes Azure Active Directory) → App registrations → New registration.
  2. Name: por ejemplo tai-storage-<proyecto>. Supported account types: Accounts in this organizational directory only. Redirect URI: vacío.
  3. Register. En la página Overview:
    • Application (client) ID → SHAREPOINT_CLIENT_ID
    • Directory (tenant) ID → SHAREPOINT_TENANT_ID

2. Crear el secreto

  1. En la aplicación: Certificates & secrets → New client secret.
  2. Elige una caducidad (por ejemplo 24 meses) y apúntala: cuando caduque, tai-storage dará AuthenticationError.
  3. Copia el Value, que solo se muestra una vez → SHAREPOINT_CLIENT_SECRET.

3. El permiso: Sites.Selected

  1. API permissions → Add a permission → Microsoft Graph → Application permissions.
  2. Añade Sites.Selected.
  3. 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.Selected con el consentimiento del administrador.
  • [ ] Acceso write (o read) 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.