Conectar OneDrive
Registra una app gratuita en Azure y conecta tu OneDrive a KumoYami.
Microsoft solo deja leer un OneDrive a aplicaciones registradas. Registrar la tuya es gratis y se hace una vez: luego KumoYami renueva sola los permisos.
Antes de empezar: un directorio de Microsoft Entra
Para registrar aplicaciones hace falta un directorio de Microsoft Entra. Una cuenta personal (outlook.com, hotmail…) sola ya no puede crearlas, y Azure muestra el aviso «La capacidad de crear aplicaciones fuera de un directorio está en desuso».
La solución es crear una cuenta gratuita de Azure con ese mismo email en azure.microsoft.com/free. Pide una tarjeta para verificar tu identidad, pero no cobra, y crea el «Directorio predeterminado». Registrar aplicaciones en él es gratis siempre, también cuando acaba el periodo de prueba.
Registrar la app y conectar
Empieza en el panel
En el panel de KumoYami, Añadir almacenamiento → OneDrive. El formulario muestra la URI de redirección de tu
web con un botón para copiarla, por ejemplo https://nube.example.com/api/admin/onedrive/callback/. Deja el formulario
abierto.
Registra la aplicación en Azure
En portal.azure.com → Registros de aplicaciones → Nuevo registro:
- Tipos de cuenta compatibles: cuentas de cualquier directorio organizativo y cuentas personales de Microsoft.
- URI de redirección: plataforma Web, y pega la URI del paso anterior.
Pulsa Registrar.
Copia el identificador de la app
En Información general, copia el Id. de aplicación (cliente) al formulario de KumoYami.
Crea un secreto
En Certificados y secretos → Nuevo secreto de cliente. Copia la columna Valor (no el «Id. del secreto») al formulario. Solo se muestra una vez.
Da los permisos
En Permisos de API → Agregar un permiso → Microsoft Graph → Permisos delegados, marca
Files.Read.All y offline_access.
Conecta
En KumoYami, guarda el almacenamiento y pulsa Conectar en su tarjeta. Inicias sesión en Microsoft, aceptas los permisos y vuelves al panel con la cuenta conectada. Los tokens se renuevan solos.
Bueno saberlo
- El secreto caduca (24 meses como máximo). Cuando caduque, crea otro en Azure y pégalo editando el almacenamiento.
- Varias direcciones: si usas el panel desde más de una dirección (por ejemplo, la IP local y tu dominio), añade cada URI de redirección en Azure → tu app → Autenticación.
- Varias cuentas: puedes añadir varios OneDrive; cada almacenamiento tiene su app de Azure y su conexión.
- Descargas: con el modo redirigir, el navegador descarga directamente de Microsoft y no gasta ancho de banda de tu servidor.