Systeme Connectors

Derniere MAJ: 26/01/2026

Architecture

Projets

connectors-api: Backend Bun/Elysia - https://connectors.33800.nowhere84.com
connectors-front: Frontend Qwik - https://connectors-front.33800.nowhere84.com

Base de donnees

Supabase PostgreSQL (supabase-db-prod)
Tables: connectors, endpoints, user_connections, connector_instances, api_keys, audit_logs

API - Endpoints principaux

Connecteurs

GET    /api/connectors              # Liste tous les connecteurs
GET    /api/connectors/:id          # Details d'un connecteur
POST   /api/connectors              # Creer un connecteur
DELETE /api/connectors/:id          # Supprimer un connecteur
POST   /api/connectors/:id/rediscover  # Relancer discovery

Creation de connecteur

POST /api/connectors
{
  "name": "mon-api",           // slug unique
  "display_name": "Mon API",   // nom affiche
  "base_url": "https://api.example.com",
  "auth_type": "bearer|api_key|basic|oauth2|custom|none",
  "auth_config": {},           // config specifique auth
  "swagger_url": "...",        // optionnel, auto-detecte sinon
  "description": "...",
  "auto_discover": true        // default true
}

Types d'authentification

Type	Description	Utilisation
bearer	Token dans Authorization header	GitHub, Canvas
api_key	Cle API dans header X-API-Key	Jellyfin, Supabase
basic	Username:Password base64	Mailjet, Nextcloud
oauth2	OAuth2 avec redirect	LinkedIn, Canva
custom	Configuration personnalisee	Proxmox, O2switch
ssh	Connexion SSH	Serveurs distants
none	Pas d'auth	Services publics internes

SSH Connector (nouveau 26/01/2026)

Voir section "Complement SSH Connector" dans ~/.claude/memory/services-actifs.md

Endpoints:

POST /api/ssh/execute - Executer une commande
POST /api/ssh/test - Tester une connexion
POST /api/ssh/upload - Upload fichier
POST /api/ssh/download - Download fichier
POST /api/ssh/setup-key - Configurer cle auto

Instances

GET    /api/instances              # Mes instances
POST   /api/instances              # Creer instance
GET    /api/instances/:id          # Details instance
PUT    /api/instances/:id          # Modifier instance
DELETE /api/instances/:id          # Supprimer instance

Fetch (proxy API)

POST /api/fetch
{
  "connector": "jellyfin",
  "instance": "mon-serveur",  // optionnel si defaut
  "method": "GET",
  "path": "/System/Info",
  "body": {},
  "headers": {}
}

Front-end

Pages principales

/ - Dashboard, liste des connecteurs et instances
/connectors/new - Wizard creation connecteur (3 etapes)
/connectors/[id] - Details connecteur
/connectors/instance/[id] - Details instance
/settings - Parametres compte, cles API
/activity - Logs d'activite

Composants partages

ActivityLogs - Affichage logs avec filtres (src/components/ActivityLogs.tsx)

Connecteurs existants (26/01/2026)

Nom	Auth	Description
linkedin	oauth2	LinkedIn API
scraper	none	Playwright scraper
web-search	none	SearXNG
ai-orchestrator	none	AI tools, GPU
github	bearer	GitHub API
jellyfin	api_key	Media server
mailjet	basic	Email API
nextcloud	basic	Files, calendar
o2switch	custom	cPanel API
proxmox	custom	VMs, LXC
supabase	api_key	PostgreSQL REST
yolo	none	Object detection

Auto-Discovery

Quand un connecteur est cree avec auto_discover: true:

Si swagger_url fourni → importe le swagger
Sinon → cherche swagger aux URLs communes (/swagger.json, /openapi.json, etc.)
Sinon → explore endpoints courants

Cles API (API Keys)

Format: ck_live_<random> Stockees en hash SHA256 Scopes: fetch, connectors:read/write, instances:read/write, audit:read, *

Utilisation:

curl -H "X-API-Key: ck_live_xxx" https://connectors.33800.nowhere84.com/api/fetch
# ou
curl -H "Authorization: Bearer ck_live_xxx" ...

Audit Logs

Toutes les actions sont loguees dans audit_logs:

auth.login/logout
fetch.execute
apikey.create/revoke
connector.auth/revoke

Details incluent: auth_method (jwt/api_key), api_key_name, status, etc.