Supabase

Supabase si collega via OAuth: fai clic su Connect with Supabase, autorizza l'accesso in lettura su Supabase scegliendo l'organizzazione da collegare e vieni reindirizzato con la sincronizzazione già avviata. I token vengono cifrati prima di essere archiviati e l'agente non li vede mai.

Alternativa con personal access token

Se preferisci una credenziale a lunga durata, collega invece con un personal access token:

1. Apri Supabase e vai su Account → Access Tokens.
2. Fai clic su Generate new token e copia il token (inizia con sbp_).
3. Incolla il token in Polylane. Se il tuo account può accedere a più di un'organizzazione, indica anche lo slug dell'organizzazione da collegare.
4. Polylane convalida il token e avvia la sincronizzazione.

Ogni collegamento copre una singola organizzazione Supabase. Polylane scopre i suoi progetti con le edge function, i branch dei database e i bucket di storage, inclusi stato, regione e dimensione di calcolo.

Risoluzione dei problemi

Errore "Invalid access token"

• Verifica che il token non sia stato revocato nelle impostazioni del tuo account Supabase.
• I personal access token agiscono con i permessi del tuo account; assicurati che il tuo account possa accedere all'organizzazione.

Errore "Multiple Supabase organizations are reachable"

• Le credenziali possono raggiungere più di un'organizzazione, quindi indica quella da collegare.
• Se colleghi via OAuth nella console, scegli l'organizzazione quando ti viene chiesto dopo l'autorizzazione.
• Se colleghi via API, imposta il campo organization sullo slug dell'organizzazione.

Risorse mancanti

• Supabase può impiegare qualche minuto per sincronizzare tutto.
• I progetti in pausa (inattivi) vengono elencati, ma le loro edge function, i branch e i bucket vengono sincronizzati solo mentre il progetto è attivo.
• Avvia una Sync manuale dall'intestazione dell'account per aggiornare.

Scollegamento

Scollega l'account in Polylane, poi revoca l'access token dalle impostazioni del tuo account Supabase.

Collegare Supabase non richiede un browser: lo stesso endpoint che chiama la console sta in un job CI. Una sola POST autenticata crea il collegamento e avvia la prima sincronizzazione.

Prerequisiti

• Una chiave API Polylane con gli scope cloud_accounts:write e cloud_accounts:read. Vedi Chiavi API e OAuth.
• L'ID del tuo workspace, che inizia con ws_. Leggilo da GET /v1/workspaces con la stessa chiave.
• Un personal access token Supabase (inizia con sbp_) da Account → Access Tokens. Il flusso OAuth della console richiede un browser; gli access token no.

Crea il collegamento

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 chiamata collega una organizzazione Supabase.

• organization può essere omesso solo quando il token raggiunge esattamente una organizzazione; altrimenti la chiamata fallisce con un 400 che elenca gli slug delle organizzazioni raggiungibili.

La risposta elenca ciò che è stato collegato, con la prima sincronizzazione già in corso. Ridotta ai due campi che il resto del flusso legge:

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

Un account già collegato finisce in failures invece che in accounts, quindi ripetere la chiamata non duplica mai un collegamento.

Attendi la prima sincronizzazione

Interroga ogni account restituito tramite il suo id finché status non raggiunge ready (new alla registrazione, syncing mentre le risorse arrivano):

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

Dai al ciclo una scadenza, così un collegamento fallito fa fallire il job invece di bloccarlo. Una volta che l'account è ready, le sue risorse sono nella topologia e Polylane ha avviato il suo primo controllo.

Scollega dall'API

Eliminare il collegamento interrompe ogni sincronizzazione e ogni controllo ed elimina le credenziali che Polylane conservava. La chiamata richiede lo 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"

Poi revoca la credenziale Supabase sul lato del provider, come descritto sotto Scollega qui sotto.