Como criar um banco Redis e conectar na sua aplicação?

1. Pré-requisitos

Para seguir este tutorial, você precisará de:

• Plano Standard ou superior: O gerenciamento de bancos de dados Redis é um recurso disponível a partir do plano Standard.
• Acesso ao Dashboard: Suas credenciais de acesso à plataforma Square Cloud.

2. Criando a instância de Banco de Dados

1. Acesse o Dashboard da Square Cloud.
2. Acesse a página de Bancos de dados e selecione a opção Criar bancos de dados.
3. Dê um nome à sua instância.
4. Escolha o Redis na lista de bancos de dados disponíveis.
5. Selecione a RAM desejada e confirme a criação.
6. Após a inicialização, você terá acesso às credenciais fundamentais em um URL: Host, Port, Password.

3. Entendendo os certificados SSL

A Square Cloud exige conexões criptografadas (TLS/SSL) para proteger os dados trafegados em memória. Para realizar essa conexão, você precisará utilizar os certificados fornecidos pela plataforma.

Na aba de configurações do seu banco de dados, você encontrará as seguintes opções de download:

• certificate.pem: É um arquivo combinado que contém a chave privada (key) e o certificado (cert). Para a maioria dos drivers de conexão, este é o único arquivo necessário.
• client-key.key e client-cert.crt: Disponibilizados separadamente para sistemas ou drivers legados que exigem arquivos individuais.

4. Configuração técnica da conexão

Para o Redis, a conexão segura é identificada pelo protocolo rediss:// (com dois "s"). Ao configurar o driver, você deve apontar o arquivo .pem para validar a identidade do cliente e do servidor.

Os parâmetros técnicos geralmente seguem este mapeamento ao usar o arquivo .pem:

• ssl_ca_certs: Caminho para o certificate.pem
• ssl_certfile: Caminho para o certificate.pem
• ssl_keyfile: Caminho para o certificate.pem

Exemplo de connection string (URI)

rediss://default:{password}@square-cloud-db-{id}.squareweb.app:{port}?ssl_ca_certs=./certificate.pem&ssl_certfile=./certificate.pem&ssl_keyfile=./certificate.pem

Exemplos de conexões via código

Se sua conexão for pelos dados separados, basta seguir como nos exemplos à seguir:

• Exemplo Python:

import redis
import os
import ssl
from pathlib import Path

ca_cert_path = Path(__file__).with_name("ca-certificate.crt")
r = redis.from_url(
    "rediss://default:JTI6bNRaws1Z1jokWU8mRfoW@square-cloud-db-{id}.squareweb.app:{port}",
    decode_responses=True,
    ssl_cert_reqs=ssl.CERT_REQUIRED,
    ssl_ca_certs=str(ca_cert_path)
)

• Exemplo JavaScript:

import { createClient } from "redis";
import fs from "fs";

const client = createClient({
  url: "rediss://default:JTI6bNRaws1Z1jokWU8mRfoW@square-cloud-db-{id}.squareweb.app:{port}",
  socket: {
    tls: true,
    ca: fs.readFileSync("ca-certificate.crt")
  },
});

async function main() {
  await client.connect();
  console.log("Conectado ao Redis!");
}

main()

5. Boas práticas e segurança

• Arquivo .gitignore: O arquivo certificate.pem contém informações sensíveis. Nunca o envie para repositórios públicos; adicione-o imediatamente ao seu .gitignore.
• Protocolo Seguro: Certifique-se sempre de utilizar o prefixo rediss:// em vez de redis:// para garantir que o driver tente realizar o handshake SSL.

Extra

Para melhor visualização, veja nosso vídeo tutorial: https://www.youtube.com/watch?v=WJsgRKsQrCI

Atualizado em: 30/04/2026