MongoDB Compass: Como se conectar

Conectar o MongoDB Compass ao seu banco de dados na Square Cloud exige uma camada extra de segurança via TLS/SSL. Diferente de uma conexão local, os bancos na nuvem exigem certificados para validar que a comunicação entre o seu computador e o servidor está criptografada e segura.

1. O que você vai precisar?

Antes de abrir o Compass, certifique-se de ter em mãos:

• A URL de conexão: Disponível no seu dashboard da Square Cloud.
• O arquivo de certificado (.pem): Este arquivo é fornecido pela Square Cloud na aba do seu banco de dados.

2. Preparando os Certificados

Na Square Cloud, você recebe um arquivo .pem. Para o MongoDB Compass, este arquivo cumpre dois papéis fundamentais na aba de segurança:

1. Certificate Authority (CA): Valida o servidor da Square.
2. Client Certificate/Key: Valida a sua conexão como autorizada.

Você usará o mesmo arquivo .pem para ambos os campos na configuração avançada.

3. Passo a Passo da Conexão

Passo 1: Inserir a String de Conexão

Abra o Compass e, no campo "New Connection", cole a sua URL. Ela deve seguir este formato:

mongodb://default:{password}@square-cloud-db-{id}.squareweb.app:{port}

Passo 2: Configurações Avançadas de TLS

Não clique em "Connect" ainda! Clique em "Advanced Connection Options" e navegue até a aba "TLS/SSL".

1. Em TLS/SSL, selecione a opção On.
2. No campo Certificate Authority (.pem), clique em "Select file" e selecione o seu arquivo .pem.
3. No campo Client Certificate and Key (.pem), clique em "Select file" e selecione o mesmo arquivo .pem novamente.

Passo 3: Finalizar

Agora sim, clique em Connect. O Compass irá validar os certificados e abrir a interface de gerenciamento das suas coleções.

4. Dicas de Diagnóstico

• Caminho do Arquivo: Evite mover o arquivo .pem de pasta após configurar a conexão, ou o Compass não conseguirá encontrá-lo no próximo acesso.

Atualizado em: 13/05/2026