> ## Documentation Index
> Fetch the complete documentation index at: https://docs.experio.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Connectors

> Authorize connections to cloud storage providers

## Overview

Connectors establish authenticated connections to your cloud storage providers. Once a connector is authorized, you can create data sources that scan specific folders within that provider.

Navigate to **Admin > Data Sources > Connectors**.

## Supported Providers

Experio supports three cloud storage providers:

<CardGroup cols={3}>
  <Card title="Box" icon="box">
    Enterprise content management with OAuth2 authentication.
  </Card>

  <Card title="Google Drive" icon="google-drive">
    Google Workspace file storage with OAuth2 authentication.
  </Card>

  <Card title="SharePoint" icon="microsoft">
    Microsoft 365 document management with OAuth2 authentication.
  </Card>
</CardGroup>

## Authentication Types

Depending on your connector configuration, the following authentication methods are available:

| Method                          | Description                                                                                         |
| ------------------------------- | --------------------------------------------------------------------------------------------------- |
| **OAuth2 (Authorization Code)** | Redirects to the provider's login page for user consent. Used by Box, Google Drive, and SharePoint. |
| **OAuth2 (Client Credentials)** | Server-to-server authentication using client ID and secret.                                         |
| **API Key**                     | Simple key-based authentication.                                                                    |
| **Bearer Token**                | Token-based authentication.                                                                         |
| **Basic Authentication**        | Username and password combination.                                                                  |

## Creating a Connector

1. Click **Create New Connection** on the Connectors page
2. Select the authentication type
3. Fill in the required credentials:
   * For OAuth2: Client ID, Client Secret, and authorization scopes
   * For API Key: The API key value
   * For Basic Auth: Username and password
4. Click **Save** to create the connector
5. For OAuth2 connectors, click **Authorize** to complete the OAuth flow

## OAuth Flow

For Box, Google Drive, and SharePoint:

1. Click **Authorize** on the connector
2. You'll be redirected to the provider's login page
3. Sign in with an account that has access to the content you want to index
4. Grant Experio the requested permissions
5. You'll be redirected back to Experio with the connection active

## Managing Connectors

### Connection Status

Each connector shows its status:

* **Active** — Connection is authorized and working
* **Pending** — OAuth authorization has not been completed
* **Error** — Connection has encountered an issue (re-authorize to fix)

### Actions

| Action     | Description                                                 |
| ---------- | ----------------------------------------------------------- |
| **Edit**   | Modify connector credentials or settings                    |
| **Test**   | Verify the connection is working                            |
| **Delete** | Remove the connector (also removes associated data sources) |

<Warning>
  Deleting a connector will affect all data sources that use it. Ensure no active data sources depend on the connector before deleting.
</Warning>

## Help & Documentation

The Connectors page includes a **Help & Documentation** tab with detailed setup guides for each provider, including required OAuth scopes and configuration steps.