> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zylon.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# SharePoint
Para integrar con SharePoint, necesitas **crear una aplicación de Microsof Entra** que actúa como un puente entre Zylon ↔ SharePoint y **configurar Zylon** para usar esta aplicación de Microsoft.
Esta guía te guía a través de la integración de SharePoint con Zylon usando el flujo OAuth 2.0 de Microsoft. Esto permite a Zylon acceder de forma segura a tus recursos de SharePoint usando permisos delegados.
## Crear una aplicación de Microsoft Entra
Primero necesitas una aplicación de Microsoft Entra. Recomendamos usar una cuenta no personal para crear esto desde el panel de Microsoft Entra. Esta cuenta no necesita tener acceso a ningún elemento en SharePoint pero tiene los permisos correctos para configurar la aplicación que servirá como un puente entre Zylon y SharePoint.
1. Ve a [https://entra.microsoft.com](https://entra.microsoft.com/).
En la barra lateral izquierda haz clic en `Applications` → `App Registrations` → `New Registration`
2. Proporciona un nombre significativo para la Aplicación.
3. En Tipos de cuenta admitidos elige `Accounts in this organizational directory only`
4. Bajo `Redirect URI` → Selecciona `Web` y agrega la siguiente URL de redirección
```
https://{your-zylon-instance}.com/api/app/integration/sharepoint/callback
```
1. Haz clic en `Register`
2. Haz clic en `Redirect URIs`
3. Haz clic en `Add a platform`
4. Haz clic en `Single-Page application`
5. Agrega la siguiente URL y haz clic en `Configure`:
```
https://{your-zylon-instance}.com
```
6. Ahora que la aplicación está creada, anota el `Application (client) Id` y `Directory (tenant) id` de la página `Overview`.
7. Creemos un secreto de aplicación
Navega a `Certificates & secrets` → Haz clic en `+ New client secret` → Agrega una descripción y fecha de expiración (si agregas una fecha que viene pronto, debes ser consciente de que tu integración dejará de funcionar cuando el secreto expire)
Copia el `value` del Client Secret. El valor del secreto no será accesible más tarde.
Ahora tenemos que configurar los permisos de API que tendrá nuestra aplicación cliente.
Navega a `API Permissions` → `+ Add a permission` → `Microsoft Graph` → `Delegated permissions` e incluye los permisos a continuación y luego haz clic en `Add permissions`
* `Files.Read.All`
* `OpenId permissions.offline_access`
* `SharePointTenantSettings.Read.All`
* `Sites.Read.All`
* `User.Read`
Navega a `API Permissions` → `+ Add a permission` → `SharePoint` → `Delegated permissions` e incluye los permisos a continuación y luego haz clic en `Add permissions`
* `AllSites.Read`
* `EnterpriseResource.Read`
* `MyFiles.Read`
* `Project.Read`
* `Sites.Search.All`
* `User.Read.All`
Después de agregar ambas listas de permisos, haz clic en `Grant admin consent for [Your Org]` y confirma haciendo clic en `Yes`
## Configurar Zylon con tu aplicación de Azure AD
Con los valores que hemos adquirido en los pasos anteriores, editaremos el archivo de configuración de Zylon ubicado en `/etc/zylon/zylon-conf.yaml`
Agrega el siguiente fragmento al final del archivo
```bash theme={null}
integration:
sharepoint:
enabled: true
clientId: "" //Del paso 10 - Application client Id
clientSecret: "" //Del paso 11 - Secret value
redirectUri: "" //Del paso 4
domain: "" //Tu dominio de sharepoint. ej: https://zylonai.sharepoint.com
tenantId: "" //Del paso 10 - Directory tenant Id
entrySite: "" //Opcional: URL del sitio de SharePoint por defecto
entryList: "" //Opcional: Nombre de la lista por defecto (ej: "Documents")
entryFolder: "" //Opcional: Nombre de la carpeta por defecto
```
Y completa las propiedades con los valores generados previamente:
* clientId → valor generado en el paso 10
* clientSecret → valor generado en el paso 11
* redirectUri → mismo valor que en el paso 4
* domain → Tu URL de SharePoint
* tenantId → mismo valor que en el paso 10
* entrySite → (Opcional) URL del sitio de SharePoint por defecto. Ver sección [Configurar Carpeta de Apertura por Defecto](#configurar-carpeta-de-apertura-por-defecto) más abajo
* entryList → (Opcional) Nombre de la lista por defecto, ej: "Documents". Ver sección [Configurar Carpeta de Apertura por Defecto](#configurar-carpeta-de-apertura-por-defecto) más abajo
* entryFolder → (Opcional) Nombre de la carpeta por defecto. Ver sección [Configurar Carpeta de Apertura por Defecto](#configurar-carpeta-de-apertura-por-defecto) más abajo
Guarda y cierra el archivo `/etc/zylon/zylon-conf.yaml`
Finalmente, ejecuta el siguiente comando para reiniciar Zylon y actualizar la configuración
```bash theme={null}
sudo zylon-cli sync
```
¡Todo está listo 🎉
## Configurar Carpeta de Apertura por Defecto
Puedes configurar una carpeta de apertura por defecto para la integración de SharePoint. Esto permite que la integración se abra directamente en una carpeta específica cuando los usuarios acceden a SharePoint a través de Zylon, mejorando la experiencia del usuario al omitir pasos de navegación.
Los tres campos opcionales controlan el punto de entrada para la integración:
* `entrySite`: La URL absoluta del sitio de SharePoint (funciona tanto para SharePoint como para OneDrive)
* `entryList`: El nombre de la lista dentro del sitio (ej: "Documents" es el predeterminado para SharePoint)
* `entryFolder`: El nombre de la carpeta dentro de la lista
**Importante:** Debes usar rutas absolutas de SharePoint para el campo `entrySite`, incluso para OneDrive. El formato de la ruta debe ser como:
```
https://example-my.sharepoint.com/personal/user_example_onmicrosoft_com
```
### Ejemplo de Configuración
Si deseas que la integración se abra por defecto en la carpeta "Defense and Security" en la lista Documents para el usuario `user_example_onmicrosoft_com`, configurarías:
```bash theme={null}
entrySite: "https://example-my.sharepoint.com/personal/user_example_onmicrosoft_com"
entryList: "Documents" //Predeterminado en SharePoint
entryFolder: "Defense and Security"
```
Esta configuración hará que la integración se abra directamente en la carpeta "Defense and Security" cuando los usuarios accedan a SharePoint a través de Zylon.
**Nota:** Los tres campos son opcionales. Si no se configuran o se dejan vacíos, serán ignorados y la integración usará el comportamiento predeterminado (abriendo en el nivel raíz).
## Solución de Problemas
### Intenté cargar archivos a la base de conocimiento pero el botón de SharePoint está deshabilitado
Limpia la caché del navegador e intenta de nuevo.
### Cuando hago clic en `Upload files -> From SharePoint` el inicio de sesión no funciona
* Verifica que el `clientId` `secretId` estén copiados y pegados correctamente en el archivo de configuración de Zylon
* Verifica que `redirectUri` sea el mismo que en el paso 4 y que tu dominio de sharepoint sea correcto
* Verifica que el `tenantId` que se está usando coincida con el de la página `Overview` de tu aplicación en Azure AD