Bienvenue dans HarborDB ! Ce guide vous accompagnera dans la création de votre première connexion PostgreSQL. Que vous vous connectiez à une base de données locale sur votre Mac ou à un serveur distant, HarborDB rend le processus simple et sécurisé.

Prérequis

Avant de commencer, assurez-vous d'avoir :

HarborDB installé (voir Guide d'installation)
Serveur PostgreSQL en cours d'exécution et accessible
Détails de connexion prêts :
- Nom d'hôte ou adresse IP
- Numéro de port (par défaut : 5432)
- Nom de la base de données
- Nom d'utilisateur et mot de passe
- Optionnel : certificat SSL si requis

Étape 1 : Lancez HarborDB et accédez aux connexions

Ouvrez HarborDB depuis votre dossier Applications ou Launchpad
Localisez la barre latérale Connexions sur le côté gauche de la fenêtre
Cliquez sur le bouton "+" ou allez dans Fichier → Ajouter une connexion

Étape 2 : Remplissez les détails de connexion

La boîte de dialogue de connexion a plusieurs champs à compléter :

Informations de base

Nom : Un nom convivial pour cette connexion (par exemple, "Développement local", "Serveur de production")
Hôte : L'adresse du serveur PostgreSQL
- Base de données locale : localhost ou 127.0.0.1
- Serveur distant : Adresse IP ou nom d'hôte (par exemple, db.example.com)
Port : Port PostgreSQL (par défaut : 5432)
Base de données : La base de données spécifique à laquelle se connecter
Nom d'utilisateur : Votre nom d'utilisateur PostgreSQL
Mot de passe : Votre mot de passe PostgreSQL

Options avancées (Optionnel)

Schéma : Schéma préféré (par défaut : public)
Mode SSL : Choisissez en fonction de la configuration de votre serveur :
- prefer : Utiliser SSL s'il est disponible
- require : Exiger une connexion SSL
- verify-full : Exiger SSL avec validation de certificat
Délai d'attente : Délai d'attente de connexion en secondes
Nom de l'application : Identifiant personnalisé pour cette connexion

Étape 3 : Testez votre connexion

Avant de sauvegarder, testez toujours votre connexion :

Cliquez sur "Tester la connexion" dans la boîte de dialogue
Attendez la confirmation - Vous devriez voir "Connexion réussie"
Vérifiez les avertissements concernant SSL ou autres paramètres

Résultats courants du test

✅ Succès : Vous êtes prêt à sauvegarder et à vous connecter
❌ Échec : Vérifiez le message d'erreur pour des indices :
- "Connexion refusée" : Serveur non en cours d'exécution ou pare-feu bloquant
- "Échec de l'authentification" : Nom d'utilisateur/mot de passe incorrect
- "La base de données n'existe pas" : Nom de base de données incorrect

Étape 4 : Sauvegardez et sécurisez votre connexion

Options de stockage des mots de passe

HarborDB offre un stockage sécurisé des mots de passe :

Sauvegarder dans le Trousseau (Recommandé) : Mot de passe crypté dans le Trousseau macOS
Sauvegarder dans la connexion : Mot de passe stocké avec les paramètres de connexion (moins sécurisé)
Demander à chaque fois : Demander le mot de passe à chaque connexion

Choisir la bonne option

| Méthode de stockage | Sécurité | Commodité | Meilleur pour | | -------------------- | ---------- | --------- | ------------------------------------ | | Trousseau macOS | 🔒 Élevée | ⚡ Élevée | Utilisation quotidienne, ordinateurs de confiance | | Fichier de connexion | 🔒 Moyenne | ⚡ Élevée | Configuration rapide, tests | | Demander à chaque fois | 🔒 Très élevée | ⚡ Faible | Ordinateurs partagés, haute sécurité |

Sauvegarder votre connexion

Choisissez la méthode de stockage des mots de passe
Cliquez sur "Enregistrer" pour stocker la connexion
Trouvez votre connexion dans la barre latérale Connexions
Double-cliquez pour vous connecter

Étape 5 : Connectez-vous et explorez

Une fois connecté, vous pouvez :

Naviguer dans votre base de données

Développez la connexion pour voir les bases de données
Parcourez les schémas et tables dans la barre latérale
Clic droit sur les tables pour des actions rapides :
- Voir la structure de la table
- Aperçu des 100 premières lignes
- Générer une requête SELECT

Actions de démarrage rapide

Ouvrez l'Éditeur de requêtes : Cliquez sur l'icône SQL ou appuyez sur ⌘ + N
Exécutez une requête de test :
```
SELECT version();
```
Explorez l'interface : Familiarisez-vous avec les onglets, panneaux et outils

Gestion des connexions

Organisation de plusieurs connexions

Au fur et à mesure que vous ajoutez des connexions, gardez-les organisées :

Favoris : Étoilez les connexions fréquemment utilisées pour un accès rapide
Groupes : Organisez par projet, environnement ou équipe
Codage couleur : Utilisez des étiquettes ou des conventions de nommage

Modification des connexions existantes

Clic droit sur la connexion dans la barre latérale
Sélectionnez "Modifier la connexion"
Mettez à jour tous les champs si nécessaire
Testez et sauvegardez les modifications

Duplication des connexions

Gagnez du temps en dupliquant des connexions similaires :

Clic droit sur la connexion source
Sélectionnez "Dupliquer"
Modifiez uniquement les champs modifiés
Sauvegardez en tant que nouvelle connexion

Bonnes pratiques de sécurité

Sécurité des mots de passe

Ne jamais partager les mots de passe du Trousseau
Utilisez des mots de passe forts pour les utilisateurs PostgreSQL
Changez les mots de passe périodiquement
Évitez de réutiliser les mots de passe entre différents serveurs

Sécurité des connexions

Utilisez SSL pour les connexions distantes
Limitez les permissions de la base de données aux opérations nécessaires
Utilisez des connexions en lecture seule pour les rapports
Auditez régulièrement les journaux de connexion

Sécurité réseau

Configuration du pare-feu : Autorisez uniquement les IP de confiance
Accès VPN pour les bases de données distantes
Tunneling SSH pour des couches de sécurité supplémentaires

Scénarios de connexion courants

PostgreSQL local (installé via Homebrew)

Nom : PostgreSQL local
Hôte : localhost
Port : 5432
Base de données : postgres
Nom d'utilisateur : votre_nom_utilisateur
Mot de passe : [Trousseau]

Conteneur Docker PostgreSQL

Nom : Docker Dev DB
Hôte : localhost
Port : 5432  # Ou port personnalisé si mappé différemment
Base de données : app_database
Nom d'utilisateur : postgres
Mot de passe : postgres_password

Amazon RDS PostgreSQL

Nom : AWS Production
Hôte : your-db-instance.region.rds.amazonaws.com
Port : 5432
Base de données : production_db
Nom d'utilisateur : app_user
Mode SSL : verify-full

Google Cloud SQL

Nom : GCP Cloud SQL
Hôte : /cloudsql/project:region:instance
Port : 5432
Base de données : cloud_db
Mode SSL : require

Dépannage des problèmes de connexion

"Impossible de se connecter au serveur"

Vérifiez que PostgreSQL est en cours d'exécution :

# Dans le Terminal
pg_isready -h localhost -p 5432

Vérifiez les paramètres du pare-feu :
- Pare-feu macOS (Préférences Système → Sécurité et confidentialité)
- Règles de pare-feu réseau

Testez la connectivité réseau :

# Dans le Terminal
ping votre-adresse-serveur
telnet votre-adresse-serveur 5432

"Échec de l'authentification par mot de passe"

Vérifiez la méthode d'authentification PostgreSQL :
- Consultez le fichier pg_hba.conf
- Assurez-vous de l'authentification md5 ou scram-sha-256

Réinitialisez le mot de passe si nécessaire :

ALTER USER nom_utilisateur WITH PASSWORD 'nouveau_mot_de_passe';

Vérifiez que l'utilisateur a accès à la base de données :

-- Connectez-vous en tant que superutilisateur
\du  -- Liste des utilisateurs
\l   -- Liste des bases de données

Erreurs de connexion SSL/TLS

Vérifiez les exigences SSL :
- Le serveur peut exiger un mode SSL spécifique
- Le certificat peut devoir être importé
Ajustez le mode SSL dans les paramètres de connexion
Importez le certificat si vous utilisez le mode verify-full

Conseils de performance

Mise en commun des connexions

Gardez les connexions ouvertes pour une utilisation fréquente
Fermez les connexions inutilisées pour libérer des ressources
Utilisez la mise en commun des connexions pour les applications

Optimisation réseau

Connexions locales : Utilisez localhost pour les meilleures performances
Connexions distantes : Assurez-vous d'une bande passante suffisante
Compression : Activez-la si vous traitez des ensembles de résultats volumineux

Prochaines étapes

Maintenant que vous êtes connecté :

Explorez les bases des requêtes - Apprenez à écrire et exécuter des requêtes SQL
Navigation dans la base de données - Explorez les schémas, tables et relations
Exportation de données - Sauvegardez les résultats en CSV ou JSON

Obtenir de l'aide

Si vous avez encore des difficultés :

Consultez notre Guide de support pour plus de dépannage
Visitez la FAQ pour les questions courantes
Contactez le support pour une assistance personnalisée

Création de votre première connexion