Acesse um servidor MongoDB pelo Localtonet
Nesta página 9 seções
- Como funciona
- Antes de começar
- Crie o túnel
- Abra a página TCP - UDP
- Preencha o formulário
- Inicie o túnel e copie o endereço
- Conecte-se de fora
- Configurações do MongoDB que importam por trás de um túnel
- Ative o controle de acesso
- O bindIp pode continuar local
- Conjuntos de réplicas exigem uma conexão direta
- Mantenha o mesmo endereço
- Proteja o acesso
- Problemas comuns
- Páginas relacionadas
Conecte-se a um servidor MongoDB na sua máquina, a partir de outra rede, com o mongosh, o MongoDB Compass ou um driver: um túnel TCP dá à porta 27017 um nome de host e uma porta públicos.
Como funciona #
O cliente do Localtonet é executado na máquina que hospeda o MongoDB, ou em outro dispositivo da mesma rede. Um túnel TCP aponta para a porta do MongoDB, 27017. O Localtonet dá ao túnel um endereço público composto por um nome de host e uma porta. Um cliente do MongoDB que se conecta a esse endereço alcança seu servidor. Os detalhes dos túneis TCP estão na página TCP.
Ative primeiro a autenticação. Um servidor MongoDB autogerenciado aceita todas as conexões sem nome de usuário nem senha até você ativar o controle de acesso. Um túnel iniciado é alcançável por qualquer pessoa que tenha o endereço dele, então um túnel para um servidor assim dá a estranhos acesso total aos seus dados.
Antes de começar #
- Uma conta do Localtonet e o cliente do Localtonet conectado com seu AuthToken. Veja o Início rápido.
- O MongoDB em execução no dispositivo com o controle de acesso ativado. Veja Configurações do MongoDB abaixo.
- Um usuário do MongoDB para uso remoto, com uma senha forte e somente as funções de que precisa.
Crie o túnel #
-
Abra a página TCP - UDP #
Abra Meus túneis › TCP - UDP e expanda Criar túnel TCP - UDP.
-
Preencha o formulário #
Campo O que informar Protocolo TCP Token do dispositivo O token que o cliente Localtonet no dispositivo usa. Região do servidor Escolha uma região próxima do seu dispositivo para ter menor latência. Endereço IP local 127.0.0.1quando o MongoDB é executado no mesmo dispositivo do cliente. Para um servidor em outra máquina da rede, informe o endereço dessa máquina.Porta local 27017, ou o valor denet.portemmongod.conf.Tipo de URL Subdomínio aleatório. Subdomínio personalizado permite escolher o nome e exige saldo. Selecione Criar túnel.
-
Inicie o túnel e copie o endereço #
O túnel aparece em Seus túneis. Selecione Iniciar. A coluna URL mostra o endereço público como
host:port, e a coluna Porta do servidor mostra só a porta.
Conecte-se de fora #
Os clientes do MongoDB usam uma string de conexão. Use o formato mongodb:// com o host e a porta do túnel. authSource indica o banco de dados em que o usuário foi criado, geralmente admin.
mongodb://<DB_USER>:<DB_PASSWORD>@<TUNNEL_HOST>:<TUNNEL_PORT>/<DB_NAME>?authSource=adminCom o mongosh, deixe a senha fora do comando para que ela não fique no histórico do seu shell. O mongosh a pede:
mongosh "mongodb://<TUNNEL_HOST>:<TUNNEL_PORT>/<DB_NAME>" --username <DB_USER> --authenticationDatabase adminNo MongoDB Compass, cole a string de conexão no campo URI de uma nova conexão.
Não use o formato mongodb+srv:// com o endereço de um túnel. Esse formato consulta registros DNS que o nome de host de um túnel não tem.
Configurações do MongoDB que importam por trás de um túnel #
Ative o controle de acesso #
Crie primeiro um administrador, depois ative a autorização em mongod.conf e reinicie o MongoDB:
security:
authorization: enabledApós a reinicialização, uma conexão sem credenciais não consegue mais ler nem alterar dados. O manual do MongoDB descreve o procedimento completo em "Enable Access Control".
O bindIp pode continuar local #
O cliente do Localtonet se conecta ao MongoDB a partir do seu próprio dispositivo. O MongoDB não precisa escutar em uma interface pública: o padrão net.bindIp: 127.0.0.1 basta quando o cliente é executado na mesma máquina. Deixe assim, para que o túnel seja o único caminho vindo de fora.
Conjuntos de réplicas exigem uma conexão direta #
Quando um driver se conecta a um conjunto de réplicas, o servidor responde com os nomes de host dos seus membros, e o driver então tenta alcançar esses nomes. Eles são os endereços dentro da sua rede, então a conexão trava ou falha a partir de fora. Adicione directConnection=true à string de conexão para continuar no endereço do túnel:
mongodb://<DB_USER>:<DB_PASSWORD>@<TUNNEL_HOST>:<TUNNEL_PORT>/<DB_NAME>?authSource=admin&directConnection=trueMantenha o mesmo endereço #
O nome de host permanece com o túnel. A porta é atribuída pelo servidor quando o túnel inicia. Com Porta reservada? ativado nas Configurações do túnel, a porta continua a mesma quando o túnel ou o cliente do Localtonet reinicia, que é o que uma string de conexão em um aplicativo precisa. Com a opção desativada, a porta muda a cada reinício. Os túneis que você cria enquanto sua conta tem saldo começam com Porta reservada? ativado. Ativá-lo exige saldo e um túnel iniciado.
Com saldo, você também pode escolher a porta em Porta do servidor › Alterar, por exemplo 27017, se nenhum outro túnel desse servidor a usar. Veja Portas.
Plano Grátis. Um túnel TCP para após 30 minutos no plano Grátis e pode ser iniciado de novo. A porta pode ser diferente a cada início. Veja Planos e saldo.
Proteja o acesso #
- Controle de acesso no MongoDB, como descrito acima. Este é o único passo que você não pode pular.
- Restrição de IP. Nas Configurações do túnel, selecione Restrição de IP › Gerenciar, escolha Permitir só estes e adicione os endereços dos aplicativos e das pessoas que se conectam. Usar meu IP preenche o seu endereço atual. As alterações valem imediatamente. A Restrição de IP exige saldo. Veja Controle de acesso.
- Um usuário dedicado com funções no único banco de dados de que precisa, por exemplo
readWrite, em vez de um administrador. - TLS no MongoDB. Os túneis não são criptografados de ponta a ponta por padrão. Configure
net.tlsno servidor e adicionetls=trueà string de conexão para que as credenciais e os dados sejam criptografados por todo o caminho. - Limites. Data de expiração, Limite de banda e Limites de velocidade nas Configurações do túnel restringem por quanto tempo e em que volume o túnel pode ser usado. Veja Limites e expiração.
- Log de requisições › Mostrar lista as conexões feitas ao túnel com o endereço IP do visitante. O próprio MongoDB registra o cliente do Localtonet como origem de todas as conexões.
Problemas comuns #
MongoServerSelectionError ou MongoNetworkError: connection timed out
Verifique se o túnel está iniciado e a coluna Conexão mostra LIG, se você usa a porta atual de Porta do servidor e se o MongoDB responde no dispositivo no Endereço IP local e na Porta local do túnel. Se o servidor é um conjunto de réplicas, adicione directConnection=true. Se você usa a Restrição de IP, verifique se o seu endereço atual está na lista.
MongoServerError: Authentication failed
O túnel funciona e o MongoDB respondeu. Verifique a senha e o authSource: ele deve ser o banco de dados em que o usuário foi criado. Caracteres especiais no nome de usuário ou na senha devem ser codificados em porcentagem em uma string de conexão.
Consigo ler dados sem entrar
O controle de acesso está desativado. Pare o túnel, ative security.authorization, reinicie o MongoDB e inicie o túnel de novo.
O aplicativo perdeu a conexão após uma reinicialização
A porta não está reservada, então ela mudou quando o túnel ou o cliente reiniciou. Ative Porta reservada? ou atualize a porta na string de conexão.
O túnel parou sozinho depois de meia hora
No plano Grátis, um túnel TCP para após 30 minutos. Selecione Iniciar para começar outra sessão ou adicione saldo para remover o limite de sessão.
"Você precisa comprar saldo para usar este recurso."
Porta reservada?, Porta do servidor, Restrição de IP e Subdomínio personalizado exigem saldo. Adicione-o em Saldo.