Cómo crear una base de datos Redis y conectarla a tu aplicación

1. Requisitos previos

Para seguir este tutorial, necesitarás:

• Plan Standard o superior: La gestión de bases de datos Redis es un recurso disponible a partir del plan Standard.
• Acceso al Dashboard: Tus credenciales de acceso a la plataforma Square Cloud.

2. Creando la instancia de base de datos

1. Accede al Dashboard de Square Cloud.
2. Accede a la página de Bases de datos y selecciona la opción Crear bases de datos.
3. Dale un nombre a tu instancia.
4. Elige Redis en la lista de bases de datos disponibles.
5. Selecciona la RAM deseada y confirma la creación.
6. Tras la inicialización, tendrás acceso a las credenciales fundamentales en una URL: Host, Port, Password.

3. Entendiendo los certificados SSL

Square Cloud exige conexiones cifradas (TLS/SSL) para proteger los datos transmitidos. Para realizar esa conexión, necesitarás utilizar los certificados proporcionados por la plataforma.

En la pestaña de configuraciones de tu base de datos, encontrarás las siguientes opciones de descarga:

• certificate.pem: Es un archivo combinado que contiene la clave privada (key) y el certificado (cert). Para la mayoría de los drivers de conexión, este es el único archivo necesario.
• client-key.key y client-cert.crt: Disponibles por separado para sistemas o drivers legados que exigen archivos individuales.

4. Configuración técnica de la conexión

Para Redis, la conexión segura se identifica por el protocolo rediss:// (con dos "s"). Al configurar el driver, debes apuntar el archivo .pem para validar la identidad del cliente y del servidor.

Los parámetros técnicos generalmente siguen este mapeo al usar el archivo .pem:

• ssl_ca_certs: Ruta al certificate.pem
• ssl_certfile: Ruta al certificate.pem
• ssl_keyfile: Ruta al certificate.pem

Ejemplo 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

Ejemplos de conexiones vía código

Si tu conexión es por los datos separados, basta con seguir los ejemplos a continuación:

• Ejemplo 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)
)

• Ejemplo 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. Buenas prácticas y seguridad

• Archivo .gitignore: El certificate.pem es una credencial de seguridad. Añádelo de inmediato a tu .gitignore.
• Protocolo seguro: Asegúrate siempre de utilizar el prefijo rediss:// en vez de redis:// para garantizar que el driver intente realizar el handshake SSL.

Extra

Para una mejor visualización, mira nuestro vídeo tutorial: https://www.youtube.com/watch?v=WJsgRKsQrCI

Actualizado el: 13/06/2026