Aller au contenu principal

Premiere connexion

Une connexion = un endpoint DB qu'Auralith peut introspecter et operer.

Quand l'utiliser​

Apres avoir cree un projet, ajouter au moins une connexion. Typiquement, vous en avez 3 : dev, staging, prod. Tagger les environment_tags pour declencher des regles d'approbation differentes.

Workflow rapide​

  1. Projets -> [projet] -> Connexions -> Nouvelle connexion.
  2. Choisir le moteur (PostgreSQL, MySQL, MariaDB, SQL Server, SQLite) ou un preset hoste (Supabase, Neon, PlanetScale, Aurora PG, Aurora MySQL, CockroachDB).
  3. Mode "DB engine" : remplir host, port, user, password, database.
  4. Mode "Hosted" : coller la connection string complete, Auralith parse les champs (connection_string_parser) et applique les defaults (SSL pour Supabase, hint "no transactions" pour PlanetScale).
  5. Cliquer Tester la connexion. Auralith ouvre un handshake et remonte un message detaille (succes ou erreur).
  6. Sauver. Auralith lance un job introspection qui scanne tables, colonnes, FK, index. Suivre la progression dans la barre de jobs.

Concepts cles​

  • db_type : postgres, mysql, mariadb, sqlserver, sqlite. Determine le dialecte SQL et l'adaptateur charge.
  • db_preset : optionnel, marque un hote specifique pour appliquer des defaults (SSL, port, options).
  • environment_tag : dev, staging, prod, ou custom. Influence les approval policies et les warnings UI.
  • Capability : ce qu'Auralith peut faire sur la connexion (read, write, schema introspect). Calcule par capability_service.

Pieges courants​

  • SQL Server sans driver ODBC : il faut pyodbc + Microsoft ODBC Driver 17/18 sur le host. Le container Auralith preprod l'inclut deja.
  • SSL Supabase : le preset force sslmode=require ; si vous editez en manuel, verifiez que SSL n'est pas desactive.
  • Connexion via VPN / bastion : Auralith ne tunnel pas ; ouvrez la route reseau cote infra ou installez Auralith dans le meme VPC.
  • Credentials en clair : par defaut chiffres avec la SECRET_KEY. Pour utiliser un secret manager externe, voir Secret providers.

API​

curl -X POST https://app.auralith.io/api/v1/connections \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "project_id": "...",
    "name": "prod-pg",
    "db_type": "postgres",
    "host": "db.example.com",
    "port": 5432,
    "user": "auralith_ro",
    "password": "***",
    "database_name": "app",
    "environment_tag": "prod"
  }'

Voir aussi​