Accéder à un serveur PostgreSQL via Localtonet
Sur cette page 9 sections
- Fonctionnement
- Avant de commencer
- Créer le tunnel
- Ouvrir la page TCP - UDP
- Remplir le formulaire
- Démarrer le tunnel et copier l'adresse
- Se connecter depuis l'extérieur
- Paramètres PostgreSQL importants derrière un tunnel
- listen_addresses peut rester local
- pg_hba.conf décide selon l'adresse du client, et c'est le client Localtonet
- Conserver la même adresse
- Le sécuriser
- Problèmes courants
- Pages associées
Connectez-vous à un serveur PostgreSQL de votre machine depuis un autre réseau avec psql, pgAdmin, DBeaver ou votre application : un tunnel TCP donne au port 5432 un nom d'hôte et un port publics.
Fonctionnement #
Le client Localtonet s'exécute sur la machine qui héberge PostgreSQL, ou sur un autre appareil du même réseau. Un tunnel TCP pointe vers le port de PostgreSQL, 5432. Localtonet donne au tunnel une adresse publique composée d'un nom d'hôte et d'un port. Un client PostgreSQL qui se connecte à cette adresse atteint votre serveur. Les détails des tunnels TCP se trouvent sur la page TCP.
Vérifiez pg_hba.conf avant de démarrer le tunnel. Les connexions passant par le tunnel atteignent PostgreSQL depuis le client Localtonet, qui est une adresse locale. Si pg_hba.conf contient une règle trust pour 127.0.0.1, toute personne qui atteint le tunnel est admise sans mot de passe. Consultez les paramètres ci-dessous.
Avant de commencer #
- Un compte Localtonet et le client Localtonet connecté avec votre AuthToken. Consultez le Démarrage rapide.
- PostgreSQL en cours d'exécution sur l'appareil. Vérifiez que
psql -h 127.0.0.1 -p 5432 -U <DB_USER> -d <DB_NAME>fonctionne sur l'appareil lui-même et demande un mot de passe. - Un rôle PostgreSQL pour l'accès à distance, avec un mot de passe robuste et seulement les privilèges nécessaires. N'utilisez pas le superutilisateur
postgres.
Créer le tunnel #
-
Ouvrir la page TCP - UDP #
Ouvrez Mes tunnels › TCP - UDP et développez Créer un tunnel TCP - UDP.
-
Remplir le formulaire #
Champ Ce qu'il faut saisir Protocole TCP Jeton d'appareil Le jeton qu'utilise le client Localtonet sur l'appareil. Région du serveur Choisissez une région proche de votre appareil pour une latence plus faible. Adresse IP locale 127.0.0.1lorsque PostgreSQL s'exécute sur le même appareil que le client. Pour un serveur situé sur une autre machine du réseau, saisissez l'adresse de cette machine.Port local 5432, ou la valeurportdepostgresql.conf.Type d'URL Sous-domaine aléatoire. Sous-domaine personnalisé vous permet de choisir le nom et nécessite du solde. Sélectionnez Créer le tunnel.
-
Démarrer le tunnel et copier l'adresse #
Le tunnel apparaît sous Vos tunnels. Sélectionnez Démarrer. La colonne URL affiche l'adresse publique sous la forme
host:port, et la colonne Port du serveur affiche le port seul.
Se connecter depuis l'extérieur #
Avec psql, l'hôte se place après -h et le port après un -p en minuscule. psql demande le mot de passe.
psql -h <TUNNEL_HOST> -p <TUNNEL_PORT> -U <DB_USER> -d <DB_NAME>Les applications prennent généralement une URI de connexion. sslmode=require fait refuser au client une session non chiffrée :
postgresql://<DB_USER>:<DB_PASSWORD>@<TUNNEL_HOST>:<TUNNEL_PORT>/<DB_NAME>?sslmode=requireDans pgAdmin ou DBeaver, saisissez le nom d'hôte du tunnel dans le champ hôte et le port du tunnel dans le champ port.
Paramètres PostgreSQL importants derrière un tunnel #
listen_addresses peut rester local #
Le client Localtonet se connecte à PostgreSQL depuis votre propre appareil. PostgreSQL n'a pas besoin d'écouter sur une interface publique : la valeur par défaut listen_addresses = 'localhost' suffit lorsque le client s'exécute sur la même machine. Laissez-la ainsi, pour que le tunnel soit le seul chemin depuis l'extérieur.
pg_hba.conf décide selon l'adresse du client, et c'est le client Localtonet #
PostgreSQL choisit la méthode d'authentification dans pg_hba.conf selon l'adresse d'où provient une connexion. Via le tunnel, cette adresse est celle du client Localtonet : 127.0.0.1 lorsque le client s'exécute sur la machine PostgreSQL. La règle correspondante doit exiger un mot de passe :
# TYPE DATABASE USER ADDRESS METHOD
host <DB_NAME> <DB_USER> 127.0.0.1/32 scram-sha-256Remplacez toute règle trust pour 127.0.0.1/32 ou ::1/128 et rechargez PostgreSQL. Si le client s'exécute sur un autre appareil, utilisez l'adresse de cet appareil dans la règle, et définissez listen_addresses pour que PostgreSQL écoute aussi sur sa propre adresse réseau.
Pour la même raison, les règles d'adresse de pg_hba.conf ne peuvent pas distinguer les visiteurs. Limitez plutôt les visiteurs sur le tunnel, avec Restriction IP.
Conserver la même adresse #
Le nom d'hôte reste attaché au tunnel. Le port est attribué par le serveur au démarrage du tunnel. Avec Réservé ? activé dans les Paramètres du tunnel, le port reste identique lorsque le tunnel ou le client Localtonet redémarre, ce dont a besoin une URI de connexion dans une application. Désactivé, le port change à chaque redémarrage. Les tunnels que vous créez lorsque votre compte a du solde démarrent avec Réservé ? activé. L'activer nécessite du solde et un tunnel démarré.
Avec du solde, vous pouvez aussi choisir le port sous Port du serveur › Modifier, par exemple 5432 si aucun autre tunnel de ce serveur ne l'utilise. Consultez Ports.
Offre gratuite. Un tunnel TCP s'arrête au bout de 30 minutes avec l'offre gratuite et peut être redémarré. Le port peut être différent à chaque démarrage. Consultez Offres et solde.
Le sécuriser #
- Restriction IP. Dans les Paramètres du tunnel, sélectionnez Restriction IP › Gérer, choisissez Autoriser uniquement ceux-ci et ajoutez les adresses des applications et des personnes qui se connectent. Utiliser mon IP renseigne votre adresse actuelle. Les modifications s'appliquent immédiatement. La restriction IP nécessite du solde. Consultez Contrôle d'accès.
- Authentification par mot de passe pour les adresses locales, comme décrit ci-dessus, et un rôle dédié sans droits de superutilisateur.
- TLS dans PostgreSQL. Les tunnels ne sont pas chiffrés de bout en bout par défaut : laissez donc PostgreSQL chiffrer la session. Définissez
ssl = onavec un certificat sur le serveur et connectez-vous avecsslmode=require. - Limites. Date d'expiration, Limite de bande passante et Limites de vitesse dans les Paramètres du tunnel plafonnent la durée et le volume d'utilisation du tunnel. Consultez Limites et expiration.
- Journal des requêtes › Afficher liste les connexions établies vers le tunnel avec l'adresse IP du visiteur.
Problèmes courants #
psql : connection refused, ou la connexion expire
Vérifiez que le tunnel est démarré et que sa colonne Connexion indique ON, que vous utilisez le port actuel de Port du serveur, et que PostgreSQL répond sur l'appareil à l'Adresse IP locale et au Port local du tunnel. Si vous utilisez la restriction IP, vérifiez que votre adresse actuelle figure dans la liste.
FATAL: no pg_hba.conf entry for host "127.0.0.1"
Le tunnel fonctionne et PostgreSQL a répondu. Aucune règle de pg_hba.conf ne correspond à l'adresse du client Localtonet avec votre utilisateur et votre base de données. Ajoutez la règle indiquée ci-dessus et rechargez PostgreSQL.
FATAL: password authentication failed for user "…"
Le tunnel fonctionne. Vérifiez le mot de passe du rôle, et que le rôle en a bien un : un rôle créé sans mot de passe ne peut pas se connecter avec scram-sha-256.
J'ai été admis sans mot de passe
Une règle trust correspond à l'adresse du client Localtonet. Arrêtez le tunnel, remplacez la règle par scram-sha-256, rechargez PostgreSQL, puis redémarrez le tunnel.
L'application a perdu sa connexion après un redémarrage
Le port n'est pas réservé : il a donc changé lorsque le tunnel ou le client a redémarré. Activez Réservé ?, ou mettez à jour le port dans l'application.
Le tunnel s'est arrêté tout seul au bout d'une demi-heure
Avec l'offre gratuite, un tunnel TCP s'arrête au bout de 30 minutes. Sélectionnez Démarrer pour commencer une autre session, ou ajoutez du solde pour supprimer la limite de session.
« Vous devez acheter du solde pour utiliser cette fonctionnalité. »
Réservé ?, Port du serveur, Restriction IP et Sous-domaine personnalisé nécessitent du solde. Ajoutez-en sous Solde.