Integrations

Fairo provides a flexible plugin architecture for integrating with third-party sources. Connect your favorite tools and services to centralize your tracking and collaboration.

Available Integrations

OpenAI

Connect to OpenAI API for accessing large language models.

Features:

• Direct API access
• Model availability for deployments
• Usage tracking

Setup:

1. Go to Organization → Integrations
2. Click "Connect" on OpenAI
3. Enter OpenAI API key

Databricks

Connect to Databricks for model and datasets management.

Features:

• Workspace browsing
• Catalog and schema discovery
• Model registry integration
• Table metadata extraction

Setup:

1. Navigate to Organization → Integrations
2. Click "Connect" on Databricks
3. Enter Databricks workspace URL, OAuth ID and OAuth Secret
4. Run resource discovery to scan workspaces

AWS Bedrock

Connect to AWS Bedrock to access it's foundational models for AI deployments.

Features:

• Foundation model listing
• Model availability checking
• Provider settings management

Setup:

1. Navigate to Organization → Integrations
2. Click "Connect" on AWS Bedrock
3. Enter AWS Access Key and Secret Key
4. Select AWS region
5. Configure model preferences

Common Tasks

Connecting an Integration

1. Log in to AI-Gov system
2. Navigate to Organization → Integrations
3. Find the service you want to connect
4. Click Connect button
5. Follow the authentication flow:
   • OAuth: Authorize on the provider's website
   • Token: Enter API credentials in the form
6. Confirm connection status shows "Connected"

Running Resource Discovery

For Databricks:

1. Connect the integration
2. Click Run Discovery button
3. Wait for scan to complete
4. View discovered resources:
   • S3: Buckets and files
   • Databricks: Catalogs, schemas, tables
5. Resources appear in the data catalog

Disconnecting an Integration

1. Navigate to Organization → Integrations
2. Find the connected service
3. Click Disconnect or Remove
4. Confirm the action
5. All webhooks and resources are automatically cleaned up

Authentication Methods

Each integration may support different authentication methods.

OAuth 2.0

OAuth provides secure authorization without sharing your password. You’ll be redirected to the service’s website to approve access.

API Token

Token-based authentication requires API credentials from your service account:

• AWS: Access Key ID and Secret Access Key
• Databricks: OAuth ID and Secret
• OpenAI: API Key

Security

All credentials are encrypted before storage using AES encryption with unique salts per integration. Credentials are never exposed through API responses or logs.details

Best Practices

1. Use dedicated service accounts for integrations
2. Rotate API tokens regularly for security
3. Enable webhooks for real-time updates
4. Run resource discovery periodically to stay current
5. Monitor integration status in settings dashboard
6. Use least-privilege credentials for API access
7. Test integrations in development before production