# External Repositories

{% hint style="success" %}
For detailed integration walkthroughs, check out the [Integrations Guides](https://guides.mangoapps.com/integration-guide) section.
{% endhint %}

## Overview

MangoApps provides support for integrating external document repositories, allowing seamless access and management of files across various platforms. This guide outlines how to configure and manage these integrations to enhance productivity within your MangoApps domain.

<img src="/files/jrktJzBxcQoAkquVtSpp" alt="Admin Portal > Modules > Files > External Document Repositories" width="563">

***

### **Supported External Document Repositories**

MangoApps supports integration with the following external document repositories:

| Office 365   | Dropbox             |
| ------------ | ------------------- |
| Google Drive | Windows File Server |
| Box          | SharePoint          |
| OneDrive     |                     |

These integrations enable users to attach files stored in these repositories to updates, posts, comments, private messages, wikis, pages, and any other areas featuring an 'Attach' button in MangoApps.

{% hint style="info" %}
Users can fetch files from the configured external repositories, and can **manually publish** files to the repository for which they have the owner privileges.
{% endhint %}

***

### **Enabling and Configuring External Document Repositories**

Administrators can enable, disable, and configure external document repositories for all users within the Files module.

**Configuration Process:**

* **Toggle Switch:** Toggle the switch next to the preferred external document repository to connect it to your MangoApps domain.
* **Edit Configuration:** Click the **Edit** button corresponding to the repository to configure its settings.
* **Save Settings:** After configuring, click 'Save Settings' to apply the repository settings to the Files module.

***

### Brief Configuration Instructions for External Repositories

MangoApps supports various external repositories. Depending on the provider, configuration is either handled through a direct toggle or requires manual setup.

#### Manual Setup (Office 365, Windows File Server, OneDrive)

These repositories require specific server details and credentials.

* Office 365 & Windows File Server:
  1. Enable the integration checkbox.
  2. Click the Edit Setup button.
  3. Enter the Account Name, Server URL, and Credentials (Username/Password).
  4. Click Test Connection to verify.
  5. Save Settings to finalize.
* OneDrive:
  1. Enable the OneDrive checkbox and click Edit Setup.
  2. Select the Account Type and enter the Tenant URL.
  3. OneDrive does not require a "Test Connection" step in this menu.

***

#### Direct Toggle Setup (Google Drive, Dropbox, Box, SharePoint)

For these cloud providers, the setup is simplified. There is no manual credential form within this specific menu.

Configuration Steps:

1. Locate the desired repository (e.g., Google Drive, Dropbox, Box, or SharePoint).
2. Switch the toggle to Enabled.
3. The system will automatically trigger the integration function. No "Test Connection" or manual "Save" is required for these specific toggles.

***

#### Comparison of Configuration Requirements

| **Repository**      | **Setup Method**    | **Test Connection Required?** |
| ------------------- | ------------------- | ----------------------------- |
| Windows File Server | Manual (Edit Setup) | Yes                           |
| Office 365          | Manual (Edit Setup) | Yes                           |
| OneDrive            | Manual (Edit Setup) | No                            |
| Google Drive        | Direct Toggle       | N/A                           |
| Dropbox             | Direct Toggle       | N/A                           |
| Box                 | Direct Toggle       | N/A                           |
| SharePoint          | Direct Toggle       | N/A                           |

***

### Additional Notes

Ensure that proper credentials and URLs are entered accurately during configuration to establish successful connections.

Users with appropriate permissions can utilize these integrations to fetch files from external repositories and publish files where they have owner privileges.

***

By configuring these external document repositories in MangoApps, you empower your users to efficiently collaborate and manage files across different platforms directly within the MangoApps environment.&#x20;


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://guides.mangoapps.com/admin-guide/module-settings/files/external-document-repositories.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
