Localtonet経由でMongoDBサーバーに接続する
このページの内容 9セクション
別のネットワークから、お使いのマシン上のMongoDBサーバーに、mongosh、MongoDB Compass、ドライバーで接続できます。TCPトンネルによって、ポート27017に公開のホスト名とポートが割り当てられます。
仕組み #
Localtonetクライアントは、MongoDBをホストしているマシン、または同じネットワーク内の別のデバイスで実行します。TCPトンネルはMongoDBのポート27017を指します。Localtonetは、トンネルにホスト名とポートからなる公開アドレスを割り当てます。そのアドレスに接続したMongoDBクライアントは、お使いのサーバーに到達します。TCPトンネルの詳細はTCPのページをご覧ください。
先に認証を有効にしてください。自己管理のMongoDBサーバーは、アクセス制御を有効にするまで、ユーザー名もパスワードもなしですべての接続を受け付けます。開始したトンネルは、アドレスを知っている人なら誰でも到達できるため、そのようなサーバーへのトンネルは、第三者にデータへの完全なアクセスを与えてしまいます。
始める前に #
- Localtonetアカウントと、AuthTokenで接続されたLocaltonetクライアント。クイックスタートをご覧ください。
- アクセス制御を有効にした状態で、デバイス上で動作しているMongoDB。下のMongoDBの設定をご覧ください。
- リモート用のMongoDBユーザー。強力なパスワードを設定し、必要なロールだけを付けます。
トンネルを作成する #
-
TCP - UDPページを開く #
マイトンネル › TCP - UDPを開き、TCP - UDPトンネルを作成を展開します。
-
フォームに入力する #
フィールド 入力する内容 プロトコル TCP デバイストークン デバイス上のLocaltonetクライアントが使うトークン。 サーバーリージョン レイテンシを下げるため、デバイスに近いリージョンを選びます。 ローカルIPアドレス MongoDBがクライアントと同じデバイスで動作している場合は 127.0.0.1。ネットワーク内の別のマシン上のサーバーの場合は、そのマシンのアドレスを入力します。ローカルポート 27017、またはmongod.confのnet.portの値。URLの種類 ランダムサブドメイン。カスタムサブドメインでは名前を自分で選べますが、残高が必要です。 トンネルを作成を選びます。
-
トンネルを開始してアドレスをコピーする #
トンネルはあなたのトンネルに表示されます。開始を選びます。URL列には公開アドレスが
host:portの形式で表示され、サーバーポート列にはポートだけが表示されます。
外部から接続する #
MongoDBクライアントは接続文字列を使います。トンネルのホストとポートを指定したmongodb://形式を使ってください。authSourceには、ユーザーを作成したデータベース(通常はadmin)を指定します。
mongodb://<DB_USER>:<DB_PASSWORD>@<TUNNEL_HOST>:<TUNNEL_PORT>/<DB_NAME>?authSource=adminmongoshでは、パスワードをコマンドに含めないでください。シェルの履歴に残らずに済みます。mongoshがパスワードを尋ねます。
mongosh "mongodb://<TUNNEL_HOST>:<TUNNEL_PORT>/<DB_NAME>" --username <DB_USER> --authenticationDatabase adminMongoDB Compassでは、新しい接続のURIフィールドに接続文字列を貼り付けます。
トンネルのアドレスには、mongodb+srv://形式を使わないでください。この形式はDNSレコードを検索しますが、トンネルのホスト名にはそのレコードがありません。
トンネル経由で使うときに重要なMongoDBの設定 #
アクセス制御を有効にする #
先に管理者を作成してから、mongod.confでauthorizationをオンにして、MongoDBを再起動します。
security:
authorization: enabled再起動後は、認証情報なしの接続では、データの読み取りも変更もできなくなります。手順の全体は、MongoDBのマニュアルの「Enable Access Control」に記載されています。
bindIpはローカルのままで構わない #
Localtonetクライアントは、お使いのデバイスからMongoDBに接続します。MongoDBが公開インターフェースで待ち受ける必要はありません。クライアントが同じマシンで動作している場合は、既定のnet.bindIp: 127.0.0.1で十分です。外部からの唯一の経路がトンネルになるよう、このままにしてください。
レプリカセットではダイレクト接続が必要 #
ドライバーがレプリカセットに接続すると、サーバーはメンバーのホスト名を返し、ドライバーはそれらの名前に接続しようとします。これらはネットワーク内部のアドレスであるため、外部からでは接続が止まったり、失敗したりします。トンネルのアドレスに留まるよう、接続文字列にdirectConnection=trueを追加します。
mongodb://<DB_USER>:<DB_PASSWORD>@<TUNNEL_HOST>:<TUNNEL_PORT>/<DB_NAME>?authSource=admin&directConnection=true同じアドレスを維持する #
ホスト名はトンネルに紐づきます。ポートは、トンネルの開始時にサーバーによって割り当てられます。トンネルの設定で予約ポートをオンにすると、トンネルやLocaltonetクライアントを再起動してもポートは変わりません。アプリケーションの接続文字列にはこれが必要です。オフの場合、再起動するとポートが変わります。アカウントに残高がある状態で作成したトンネルは、予約ポートがオンで始まります。オンにするには、残高と開始済みのトンネルが必要です。
残高があれば、サーバーポート › 変更でポートを選ぶこともできます。たとえば、同じサーバー上のほかのトンネルが使っていなければ27017にできます。ポートをご覧ください。
無料プラン。無料プランでは、TCPトンネルは30分後に停止し、再度開始できます。開始のたびにポートが変わることがあります。プランと残高をご覧ください。
セキュリティを確保する #
- MongoDBのアクセス制御。前述のとおりです。これは省略できない唯一の手順です。
- IP制限。トンネルの設定でIP制限 › 管理を選び、これらのみ許可を選んで、接続するアプリケーションや人のアドレスを追加します。自分のIPを使用を使うと、現在のアドレスが入力されます。変更はすぐに反映されます。IP制限には残高が必要です。アクセス制御をご覧ください。
- 専用のユーザー。管理者ではなく、必要な1つのデータベースに対するロール(たとえば
readWrite)だけを付けます。 - MongoDBのTLS。トンネルは、既定ではエンドツーエンドで暗号化されません。サーバーで
net.tlsを設定し、接続文字列にtls=trueを追加して、認証情報とデータが経路全体で暗号化されるようにします。 - 制限。トンネルの設定にある有効期限、帯域幅制限、速度制限で、トンネルを使える期間と量を制限できます。制限と有効期限をご覧ください。
- リクエストログ › 表示には、トンネルへの接続が、訪問者のIPアドレスとともに一覧表示されます。MongoDB自体のログでは、すべての接続の接続元がLocaltonetクライアントになります。
よくある問題 #
MongoServerSelectionErrorまたはMongoNetworkError:connection timed out
トンネルが開始されていて接続列がオンと表示されていること、サーバーポートの現在のポートを使っていること、トンネルのローカルIPアドレスとローカルポートのデバイス上でMongoDBが応答していることを確認してください。サーバーがレプリカセットの場合は、directConnection=trueを追加します。IP制限を使っている場合は、現在のアドレスが一覧に含まれているか確認してください。
MongoServerError:Authentication failed
トンネルは動作していて、MongoDBが応答しています。パスワードとauthSourceを確認してください。これは、ユーザーを作成したデータベースである必要があります。ユーザー名やパスワードに特殊文字が含まれる場合は、接続文字列ではパーセントエンコードする必要があります。
サインインしなくてもデータを読み取れる
アクセス制御がオフになっています。トンネルを停止し、security.authorizationを有効にして、MongoDBを再起動してから、もう一度トンネルを開始してください。
再起動後にアプリケーションの接続が切れた
ポートが予約されていないため、トンネルまたはクライアントの再起動時に変わりました。予約ポートをオンにするか、接続文字列のポートを更新してください。
トンネルが30分後に自動的に停止した
無料プランでは、TCPトンネルは30分後に停止します。開始を選んで新しいセッションを始めるか、残高を追加してセッション制限をなくしてください。
「この機能を利用するには残高の購入が必要です。」
予約ポート、サーバーポート、IP制限、カスタムサブドメインには残高が必要です。残高で追加してください。