# Documentation — Connect-DB

> Guide d’utilisation de Connect-DB : connexions, agent et tunnel SSH, schéma, requêtes, assistant IA, comparaison, sauvegardes, duplication, équipe et rôles, utilisateurs en lecture seule par moteur.

Source : https://connect-db.com/documentation

[connect-db](https://connect-db.com/)

DOCUMENTATION

# Bien démarrer avec Connect-DB

Connecter une base, l’explorer, l’interroger et la sauvegarder : tout ce qu’il faut savoir pour utiliser Connect-DB au quotidien.

## Premiers pas

- [Créez votre compte](https://connect-db.com/auth/signup) : choisissez une formule, puis renseignez vos informations et le nom de votre workspace (votre organisation).

- Créez un **projet** : il regroupe les connexions d’une même application ou d’un même environnement.

- Ajoutez une **connexion** à votre base : Connect-DB la teste immédiatement.

- Invitez votre équipe depuis les paramètres de l’organisation.

## Ajouter une connexion

Dans un projet, cliquez sur **Ajouter une connexion**, choisissez le moteur puis complétez le formulaire. Les champs marqués d’un astérisque rouge sont obligatoires.

- **Hôte et port** : l’adresse de votre serveur, telle que la voit Connect-DB (accès direct), le serveur SSH ou l’agent (bases privées, voir ci-dessous).

- **Base de données** : la base exposée (nom de service pour Oracle, numéro de base pour Redis).

- **Utilisateur et mot de passe** : de préférence un utilisateur en lecture seule (voir ci-dessous).

- **SSL** : `disable` (non chiffré), `require` (chiffré) ou `verify-full` (chiffré, avec vérification du certificat et du nom d’hôte — recommandé en production).

Vous avez déjà une **URL de connexion** ? Ouvrez « Remplir depuis une URL de connexion » en haut du formulaire et collez-la : les champs se remplissent automatiquement, à vérifier avant d’enregistrer. L’URL elle-même n’est pas conservée.

```
postgresql://user:motdepasse@db.exemple.com:5432/ma_base?sslmode=require
mysql://user:motdepasse@db.exemple.com:3306/ma_base?ssl-mode=REQUIRED
mongodb://user:motdepasse@mongo.exemple.com:27017/app?authSource=admin&tls=true
sqlserver://user:motdepasse@sql.exemple.com:1433/ma_base?encrypt=true
oracle://user:motdepasse@ora.exemple.com:1521/ORCLPDB1
redis://user:motdepasse@redis.exemple.com:6379/0
```

Sont aussi acceptés : le format JDBC de SQL Server (`jdbc:sqlserver://hôte;databaseName=…;user=…`), le format Easy Connect d’Oracle (`user/motdepasse@hôte:1521/service`) et `rediss://` pour Redis en TLS. Les URL `mongodb+srv://` ne sont pas prises en charge. Un caractère spécial dans le mot de passe doit être encodé (`@` → `%40`).

À l’enregistrement, Connect-DB teste la connexion et affiche le résultat. Une connexion en échec est tout de même enregistrée : vous pouvez la modifier et relancer le test.

### Choisir l’accès réseau

En haut du formulaire, trois modes d’accès sont proposés :

- **Direct** : la base doit être joignable depuis Internet. Les adresses privées ou locales (`10.x`, `192.168.x`, `localhost`…) sont refusées.

- **Agent Connect-DB** (recommandé pour une base privée) : un agent installé chez vous joint la base de l’intérieur. Aucun port à ouvrir, voir la section suivante.

- **Tunnel SSH** : Connect-DB se connecte à un serveur SSH (votre bastion, ou le serveur qui héberge la base), qui relaie vers la base.

- **WireGuard** : Connect-DB rejoint votre réseau WireGuard comme un pair, et joint la base par son adresse dans le tunnel (PostgreSQL pour l’instant).

### Tunnel SSH

L’hôte de la base est alors celui vu depuis le serveur SSH : il peut être privé, par exemple `127.0.0.1`.

- Renseignez l’hôte, le port et l’utilisateur du serveur SSH.

- Copiez la ligne `authorized_keys` proposée et ajoutez-la sur le serveur : la clé de votre organisation ne permet que le relais vers la base, sans shell.

- Au premier test, vérifiez puis approuvez l’empreinte du serveur SSH.

Le serveur SSH doit rester joignable depuis Internet (port 22 ouvert). Pour n’ouvrir aucun port, utilisez l’agent Connect-DB.

### Tunnel WireGuard

Connect-DB génère sa propre clé WireGuard pour la connexion et se comporte comme un pair de votre serveur. L’hôte de la base est son **adresse IP dans le tunnel**, par exemple `10.8.0.1` : aucun nom n’y est résolu.

- Renseignez le serveur WireGuard (endpoint et port UDP, 51820 par défaut), sa clé publique, et une adresse libre du réseau pour Connect-DB, par exemple `10.8.0.2/32`.

- Enregistrez : Connect-DB affiche un bloc `[Peer]`. Ajoutez-le à la configuration du serveur, puis rechargez-la (`wg syncconf wg0 Tous les droits, y compris sur l’organisation et ses membres.

**Administrateur** Gère les membres, les projets, leurs connexions et les agents Connect-DB.

**Éditeur** Crée et modifie connexions, sauvegardes et comparaisons.

**Lecteur** Consulte les projets, explore les schémas et exécute des requêtes (en lecture seule).

Les actions sensibles (connexions, requêtes, invitations…) sont enregistrées dans le journal d’audit de l’organisation.

## Sécurité

- **Identifiants chiffrés** au repos ; les mots de passe ne sont jamais renvoyés à l’interface.

- **Lecture seule par défaut**, imposée par chaque connecteur, avec délai et nombre de lignes plafonnés ; les écritures ne sont possibles que sur les connexions où un administrateur les autorise.

- **Chiffrement en transit** : TLS vers votre base selon le mode SSL choisi.

- **Protection réseau** : en accès direct, les connecteurs refusent les adresses internes. Les bases privées passent par l’agent Connect-DB, qui ne joint que les destinations que vous autorisez, ou par votre serveur SSH, authentifié par son empreinte.

- **Aucun port entrant** avec l’agent : la connexion est établie de chez vous vers Connect-DB, et vous pouvez la couper à tout moment en révoquant l’agent.

Pour en savoir plus sur les données que nous traitons, consultez notre [politique de confidentialité](https://connect-db.com/confidentialite).

© 2026 Connect-DB[Cas pratiques](https://connect-db.com/cas-pratiques)[Documentation](https://connect-db.com/documentation)[Conditions d’utilisation](https://connect-db.com/conditions)[Confidentialité](https://connect-db.com/confidentialite)
