Supabase

Supabase se conecta mediante OAuth: haz clic en Connect with Supabase, autoriza el acceso de lectura en Supabase eligiendo la organización que quieres conectar y vuelves redirigido con la sincronización ya en marcha. Los tokens se cifran antes de almacenarse, y el agente nunca los ve.

Alternativa con token de acceso personal

Si prefieres una credencial de larga duración, conecta con un token de acceso personal:

1. Abre Supabase y ve a Account → Access Tokens.
2. Haz clic en Generate new token y copia el token (empieza por sbp_).
3. Pega el token en Polylane. Si tu cuenta puede acceder a más de una organización, indica también el slug de la organización que quieres conectar.
4. Polylane valida el token y empieza a sincronizar.

Cada conexión cubre una única organización de Supabase. Polylane descubre sus proyectos con sus edge functions, ramas de base de datos y buckets de almacenamiento, incluidos estado, región y tamaño de cómputo.

Solución de problemas

Error "Invalid access token"

• Comprueba que el token no se haya revocado en la configuración de tu cuenta de Supabase.
• Los tokens de acceso personal actúan con los permisos de tu cuenta; asegúrate de que tu cuenta puede acceder a la organización.

Error "Multiple Supabase organizations are reachable"

• Las credenciales pueden alcanzar más de una organización, así que indica cuál quieres conectar.
• Al conectar mediante OAuth en la consola, elige la organización cuando se te pida tras autorizar.
• Al conectar mediante la API, establece el campo organization con el slug de la organización.

Faltan recursos

• Supabase puede tardar unos minutos en sincronizar todo.
• Los proyectos pausados (inactivos) se listan, pero sus edge functions, ramas y buckets solo se sincronizan mientras el proyecto está activo.
• Lanza un Sync manual desde la cabecera de la cuenta para actualizar.

Desconexión

Desconecta la cuenta en Polylane y luego revoca el token de acceso desde la configuración de tu cuenta de Supabase.

Conectar Supabase no necesita navegador: el mismo endpoint al que llama la consola cabe en un trabajo de CI. Un único POST autenticado crea la conexión e inicia la primera sincronización.

Requisitos previos

• Una clave de API de Polylane con los scopes cloud_accounts:write y cloud_accounts:read. Consulta Claves de API y OAuth.
• El ID de tu espacio de trabajo, que empieza por ws_. Léelo desde GET /v1/workspaces con la misma clave.
• Un token de acceso personal de Supabase (empieza por sbp_) de Account → Access Tokens. El flujo OAuth de la consola necesita un navegador; los tokens de acceso no.

Crear la conexión

curl -X POST https://api.polylane.com/v1/cloud_accounts \
  -H "x-api-key: $POLYLANE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "supabase",
    "workspaceId": "ws_0abc123",
    "token": "sbp_...",
    "organization": "my-org-slug"
  }'

Una sola llamada conecta una organización de Supabase.

• organization solo puede omitirse cuando el token alcanza exactamente una organización; de lo contrario la llamada falla con un 400 que lista los slugs de las organizaciones alcanzables.

La respuesta lista lo que se conectó, con la primera sincronización ya en marcha. Recortada a los dos campos que lee el resto del flujo:

{
  "success": true,
  "result": {
    "provider": "supabase",
    "accounts": [{ "id": "acc_34gky74ibc92h8t2efn8csrh", "status": "syncing" }],
    "failures": []
  }
}

Una cuenta que ya está conectada acaba en failures en lugar de en accounts, así que repetir la llamada nunca duplica una conexión.

Esperar a la primera sincronización

Consulta cada cuenta devuelta por su id hasta que status llegue a ready (new al registrarse, syncing mientras los recursos van llegando):

until [ "$(curl -s "https://api.polylane.com/v1/cloud_accounts/$WORKSPACE_ID/$ACCOUNT_ID" \
  -H "x-api-key: $POLYLANE_API_KEY" | jq -r '.result.status')" = "ready" ]; do
  sleep 15
done

Dale al bucle un plazo límite para que una conexión fallida haga fallar el trabajo en lugar de dejarlo colgado. Cuando la cuenta está ready, sus recursos están en la topología y Polylane ha iniciado su primera comprobación.

Desconectar desde la API

Eliminar la conexión detiene todas las sincronizaciones y comprobaciones y elimina las credenciales que Polylane guardaba. La llamada necesita el scope cloud_accounts:delete:

curl -X DELETE "https://api.polylane.com/v1/cloud_accounts/$WORKSPACE_ID/$ACCOUNT_ID" \
  -H "x-api-key: $POLYLANE_API_KEY"

Después revoca la credencial de Supabase del lado del proveedor, como se describe más abajo en Desconectar.