Accéder à un serveur MongoDB 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 de MongoDB importants derrière un tunnel
- Activer le contrôle d'accès
- bindIp peut rester local
- Les jeux de réplicas nécessitent une connexion directe
- Conserver la même adresse
- Le sécuriser
- Problèmes courants
- Pages associées
Connectez-vous à un serveur MongoDB de votre machine depuis un autre réseau avec mongosh, MongoDB Compass ou un pilote : un tunnel TCP donne au port 27017 un nom d'hôte et un port publics.
Fonctionnement #
Le client Localtonet s'exécute sur la machine qui héberge MongoDB, ou sur un autre appareil du même réseau. Un tunnel TCP pointe vers le port de MongoDB, 27017. Localtonet attribue au tunnel une adresse publique composée d'un nom d'hôte et d'un port. Un client MongoDB qui se connecte à cette adresse atteint votre serveur. Les détails des tunnels TCP se trouvent sur la page TCP.
Activez d'abord l'authentification. Un serveur MongoDB autogéré accepte toutes les connexions sans nom d'utilisateur ni mot de passe tant que vous n'activez pas le contrôle d'accès. Un tunnel démarré est accessible à toute personne qui connaît son adresse ; un tunnel vers un tel serveur donne donc à des inconnus un accès complet à vos données.
Avant de commencer #
- Un compte Localtonet et le client Localtonet connecté avec votre AuthToken. Consultez Démarrage rapide.
- MongoDB en cours d'exécution sur l'appareil avec le contrôle d'accès activé. Consultez Paramètres de MongoDB ci-dessous.
- Un utilisateur MongoDB pour l'accès distant, avec un mot de passe fort et uniquement les rôles dont il a besoin.
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 MongoDB 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 27017, ou la valeurnet.portdemongod.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 #
Les clients MongoDB utilisent une chaîne de connexion. Utilisez la forme mongodb:// avec l'hôte et le port du tunnel. authSource désigne la base de données dans laquelle l'utilisateur a été créé, généralement admin.
mongodb://<DB_USER>:<DB_PASSWORD>@<TUNNEL_HOST>:<TUNNEL_PORT>/<DB_NAME>?authSource=adminAvec mongosh, laissez le mot de passe hors de la commande afin qu'il ne soit pas enregistré dans l'historique de votre shell. mongosh le demande :
mongosh "mongodb://<TUNNEL_HOST>:<TUNNEL_PORT>/<DB_NAME>" --username <DB_USER> --authenticationDatabase adminDans MongoDB Compass, collez la chaîne de connexion dans le champ URI d'une nouvelle connexion.
N'utilisez pas la forme mongodb+srv:// avec une adresse de tunnel. Cette forme recherche des enregistrements DNS qu'un nom d'hôte de tunnel n'a pas.
Paramètres de MongoDB importants derrière un tunnel #
Activer le contrôle d'accès #
Créez d'abord un administrateur, puis activez l'autorisation dans mongod.conf et redémarrez MongoDB :
security:
authorization: enabledAprès le redémarrage, une connexion sans identifiants ne peut plus lire ni modifier de données. Le manuel de MongoDB décrit la procédure complète sous « Enable Access Control ».
bindIp peut rester local #
Le client Localtonet se connecte à MongoDB depuis votre propre appareil. MongoDB n'a pas besoin d'écouter sur une interface publique : la valeur par défaut net.bindIp: 127.0.0.1 suffit lorsque le client s'exécute sur la même machine. Laissez-la ainsi, afin que le tunnel soit le seul chemin depuis l'extérieur.
Les jeux de réplicas nécessitent une connexion directe #
Lorsqu'un pilote se connecte à un jeu de réplicas, le serveur répond avec les noms d'hôte de ses membres, puis le pilote tente d'atteindre ces noms. Ce sont des adresses internes à votre réseau ; la connexion se bloque donc ou échoue depuis l'extérieur. Ajoutez directConnection=true à la chaîne de connexion pour rester sur l'adresse du tunnel :
mongodb://<DB_USER>:<DB_PASSWORD>@<TUNNEL_HOST>:<TUNNEL_PORT>/<DB_NAME>?authSource=admin&directConnection=trueConserver la même adresse #
Le nom d'hôte reste lié 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 le même lorsque le tunnel ou le client Localtonet redémarre, ce dont une chaîne de connexion dans une application a besoin. S'il est désactivé, le port change à chaque redémarrage. Les tunnels que vous créez tant que 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 27017 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 après chaque démarrage. Consultez Offres et solde.
Le sécuriser #
- Le contrôle d'accès dans MongoDB, comme décrit ci-dessus. C'est la seule étape que vous ne pouvez pas omettre.
- 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.
- Un utilisateur dédié avec des rôles sur l'unique base de données dont il a besoin, par exemple
readWrite, plutôt qu'un administrateur. - TLS dans MongoDB. Les tunnels ne sont pas chiffrés de bout en bout par défaut. Configurez
net.tlssur le serveur et ajouteztls=trueà la chaîne de connexion pour que les identifiants et les données soient chiffrés de bout en bout. - 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. MongoDB lui-même journalise le client Localtonet comme source de chaque connexion.
Problèmes courants #
MongoServerSelectionError ou MongoNetworkError : connection timed out
Vérifiez que le tunnel est démarré et que sa colonne Connexion affiche ON, que vous utilisez le port actuel de Port du serveur, et que MongoDB répond sur l'appareil à l'Adresse IP locale et au Port local du tunnel. Si le serveur est un jeu de réplicas, ajoutez directConnection=true. Si vous utilisez la restriction IP, vérifiez que votre adresse actuelle figure dans la liste.
MongoServerError : Authentication failed
Le tunnel fonctionne et MongoDB a répondu. Vérifiez le mot de passe et authSource : ce doit être la base de données dans laquelle l'utilisateur a été créé. Les caractères spéciaux du nom d'utilisateur ou du mot de passe doivent être encodés en pourcentage dans une chaîne de connexion.
Je peux lire des données sans me connecter
Le contrôle d'accès est désactivé. Arrêtez le tunnel, activez security.authorization, redémarrez MongoDB, 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 la chaîne de connexion.
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.