OAuth Authenticator Developer Guide

# Navigate to your app directory
cd /path/to/your-app

# Register the authenticator
fiber app oauth register-authenticator \
  --authenticator-config ./google-authenticator.json \
  --to-instance production

# Verify registration
fiber app oauth list-authenticators --to-instance production

# Register for specific app directory
fiber app oauth register-authenticator \
  --authenticator-config ./microsoft-authenticator.json \
  --app-dir ./my-email-app \
  --to-instance staging

# Delete an authenticator
fiber app oauth delete-authenticator google-auth-id \
  --to-instance production

# List all authenticators for an app
fiber app oauth list-authenticators \
  --app-dir ./my-app \
  --to-instance development

# Environment-specific configurations
fiber app oauth register-authenticator \
  --authenticator-config ./dev-google.json \
  --to-instance development

POST /api/v1/oauth/authenticators
Content-Type: application/json

{
  "name": "Google",
  "authenticator_type": "google",
  "client_id": "your-client-id",
  "client_secret": "your-client-secret",
  "scopes": ["profile", "email"],
  "authorize_url": "https://accounts.google.com/o/oauth2/v2/auth",
  "token_url": "https://oauth2.googleapis.com/token",
  "redirect_uri": "https://your-app.com/auth/callback/google",
  "app_id": "your-app-id"
}

GET /api/v1/oauth/authenticators?app_id=your-app-id

DELETE /api/v1/oauth/authenticators/{authenticator_id}

// Import FiberWise SDK
import FiberWise from 'fiberwise';

// Initialize SDK
const fiber = new FiberWise({
  baseUrl: 'https://api.fiberwise.ai/api/v1',
  appId: 'your-app-id'
});

// OAuth Integration using FiberWise SDK
class OAuthManager {
  constructor() {
    this.credentials = fiber.credentials;
  }

  // Connect to Gmail
  async connectGmail() {
    try {
      await this.credentials.connectAuthenticator('google', {
        returnTo: '/settings'
      });
    } catch (error) {
      console.error('Gmail connection failed:', error);
    }
  }

  // Check Gmail connection status
  async isGmailConnected() {
    try {
      return await this.credentials.isConnected('google');
    } catch (error) {
      console.error('Error checking Gmail connection:', error);
      return false;
    }
  }

  // Connect to other providers
  async connectSlack() {
    await this.credentials.connectAuthenticator('slack', {
      returnTo: '/dashboard'
    });
  }

  async connectGitHub() {
    await this.credentials.connectAuthenticator('github');
  }

  // List available authenticators
  async getAvailableProviders() {
    try {
      return await this.credentials.listAuthenticators({
        includeDisabled: false
      });
    } catch (error) {
      console.error('Error listing authenticators:', error);
      return [];
    }
  }

  // Disconnect from provider
  async disconnect(authenticatorId) {
    try {
      await this.credentials.revokeConnection(authenticatorId);
      console.log(`Disconnected from ${authenticatorId}`);
    } catch (error) {
      console.error(`Failed to disconnect:`, error);
    }
  }

  // Check if page is OAuth callback
  isOAuthCallback(authenticatorId) {
    return this.credentials.isConnectionCallback(authenticatorId);
  }
}

// Usage
const oauth = new OAuthManager();

// Event handlers
document.getElementById('connect-gmail').addEventListener('click', () => {
  oauth.connectGmail();
});

document.getElementById('connect-slack').addEventListener('click', () => {
  oauth.connectSlack();
});

// Check connections on page load
async function checkConnections() {
  const providers = ['google', 'slack', 'github'];
  for (const provider of providers) {
    const connected = await oauth.credentials.isConnected(provider);
    console.log(`${provider}: ${connected ? 'Connected' : 'Not connected'}`);
  }
}

# Python agent using OAuth credentials
from fiberwise import Agent

class EmailProcessorAgent(Agent):
    async def process_user_email(self, user_context):
        # OAuth credentials automatically injected
        gmail_service = await self.get_oauth_authenticator('gmail')
        
        # Fetch recent emails
        emails = await gmail_service.get_recent_emails(limit=10)
        
        # Process with LLM
        summary = await self.llm.generate(
            f"Summarize these emails: {emails}"
        )
        
        return {
            "email_count": len(emails),
            "summary": summary
        }

# Enable verbose output
fiber app oauth register-authenticator \
  --authenticator-config ./config.json \
  --to-instance development \
  --verbose

# Enable OAuth debugging
export OAUTH_DEBUG=true
fiber register-authenticator google --debug

# Check OAuth logs
tail -f .fiberwise-core/logs/oauth.log

// Import FiberWise SDK
import FiberWise from 'fiberwise';

// Initialize the SDK
const fiber = new FiberWise({
  baseUrl: 'https://api.fiberwise.ai/api/v1',
  appId: 'your-app-id'
});

// Simple OAuth integration
async function connectGmail() {
  try {
    // Use SDK to connect to Google OAuth
    await fiber.credentials.connectAuthenticator('google', {
      returnTo: '/settings'
    });
  } catch (error) {
    console.error('Gmail connection failed:', error);
  }
}

// Check connection status using SDK
async function checkGmailConnection() {
  try {
    return await fiber.credentials.isConnected('google');
  } catch (error) {
    console.error('Error checking Gmail connection:', error);
    return false;
  }
}

// List all available authenticators
async function getAvailableAuthenticators() {
  try {
    return await fiber.credentials.listAuthenticators({
      includeDisabled: false
    });
  } catch (error) {
    console.error('Error listing authenticators:', error);
    return [];
  }
}

// Disconnect from provider
async function disconnectProvider(authenticatorId) {
  try {
    await fiber.credentials.revokeConnection(authenticatorId);
    console.log(`Successfully disconnected from ${authenticatorId}`);
  } catch (error) {
    console.error(`Failed to disconnect from ${authenticatorId}:`, error);
  }
}

# Python agent using OAuth credentials
from fiberwise import Agent

class EmailProcessorAgent(Agent):
    async def process_user_email(self, user_context):
        # OAuth credentials automatically injected
        gmail_service = await self.get_oauth_service('gmail')
        
        # Fetch recent emails
        emails = await gmail_service.get_recent_emails(limit=10)
        
        # Process with LLM
        summary = await self.llm.generate(
            f"Summarize these emails: {emails}"
        )
        
        return {
            "email_count": len(emails),
            "summary": summary
        }

# Enable OAuth debugging
export OAUTH_DEBUG=true
fiber add-provider google --debug

# Check OAuth logs
tail -f .fiberwise-core/logs/oauth.log