Connectors

Connectors provide integrations connecting Aegis to external enterprise data sources and document stores.

Connectors operate as microservices running within your infrastructure (e.g., Google Cloud Run containers). Aegis communicates with connectors via Base URLs to synchronize configuration files and fetch external data.

---

Supported Connector Types

Aegis currently supports the following enterprise connector type:

Connector Type	ID	Description
SharePoint	sharepoint	Synchronizes document libraries, sites, and file indices from Microsoft SharePoint.

---

Managing Connectors

Navigate to Agent Workspace > Connectors in the Aegis Console to inspect active connectors, connection health, and configuration details.

---

Adding a SharePoint Connector

1. Select your target Team scope in the top bar selector.
2. Click + Add Connector in the top right.
3. Configure the required parameters:
   • Name: Unique name identifier within your team (e.g., finance-sharepoint).
   • Display Name: Friendly title (e.g., Finance SharePoint Connector).
   • Type: Select SharePoint.
   • Base URL: Service URL where your connector container is hosted (e.g., https://sharepoint-connector-xxxx.run.app).
   • Auth Method: Choose authentication protocol:
     • None: No authentication header required.
     • Control Token (api-key): Secure token matching TAIMOE_CONTROL_TOKEN environment variable on the connector.
     • GCP Service Account (gcp-sa): OIDC token authentication for Google Cloud Run endpoints.
   • Config Bucket: Cloud Storage bucket containing configuration files.
   • Config Path: File path inside the bucket (default config/sites.json).
   • Health Path: Endpoint path for health probes (default /).
4. Click Add Connector.

---

Connector Health & Status Probes

Aegis background workers periodically ping the connector's Base URL and Health Path:

Status	Description
Healthy	Connector endpoint responded with HTTP 200 OK.
Unreachable	Connection timeout or HTTP 5xx error from connector container.