Supabase

Supabase łączy się przez OAuth: kliknij Connect with Supabase, autoryzuj dostęp do odczytu w Supabase, wybierając organizację do połączenia, a wrócisz z już rozpoczętą synchronizacją. Tokeny są szyfrowane przed zapisaniem, a agent nigdy ich nie widzi.

Alternatywa: osobisty token dostępu

Jeśli wolisz długowieczne poświadczenie, połącz się zamiast tego osobistym tokenem dostępu:

1. Otwórz Supabase, przejdź do Account → Access Tokens.
2. Kliknij Generate new token i skopiuj token (zaczyna się od sbp_).
3. Wklej token do Polylane. Jeśli twoje konto ma dostęp do więcej niż jednej organizacji, podaj też slug organizacji do połączenia.
4. Polylane weryfikuje token i zaczyna synchronizację.

Każde połączenie obejmuje jedną organizację Supabase. Polylane odkrywa jej projekty z ich funkcjami edge, gałęziami baz danych i bucketami pamięci, łącznie ze statusem, regionem i rozmiarem obliczeniowym.

Rozwiązywanie problemów

Błąd "Invalid access token"

• Sprawdź, czy token nie został odwołany w ustawieniach konta Supabase.
• Osobiste tokeny dostępu działają z uprawnieniami twojego konta; upewnij się, że twoje konto ma dostęp do organizacji.

Błąd "Multiple Supabase organizations are reachable"

• Poświadczenia mają dostęp do więcej niż jednej organizacji, więc podaj nazwę tej do połączenia.
• Łącząc przez OAuth w konsoli, wybierz organizację, gdy zostaniesz o to poproszony po autoryzacji.
• Łącząc przez API, ustaw pole organization na slug organizacji.

Brakujące zasoby

• Supabase może potrzebować kilku minut, aby zsynchronizować wszystko.
• Wstrzymane (nieaktywne) projekty są wymieniane, ale ich funkcje edge, gałęzie i buckety są synchronizowane tylko wtedy, gdy projekt jest aktywny.
• Wywołaj ręczną Sync z nagłówka konta, aby odświeżyć.

Odłączanie

Odłącz konto w Polylane, a potem odwołaj token dostępu w ustawieniach konta Supabase.

Połączenie Supabase nie potrzebuje przeglądarki: ten sam punkt końcowy, który wywołuje konsola, mieści się w zadaniu CI. Jeden uwierzytelniony POST tworzy połączenie i uruchamia pierwszą synchronizację.

Wymagania wstępne

• Klucz API Polylane z zakresami cloud_accounts:write i cloud_accounts:read. Zobacz Klucze API i OAuth.
• Identyfikator twojego obszaru roboczego, zaczynający się od ws_. Odczytaj go z GET /v1/workspaces tym samym kluczem.
• Osobisty token dostępu Supabase (zaczyna się od sbp_) z Account → Access Tokens. Przepływ OAuth w konsoli wymaga przeglądarki; tokeny dostępu nie.

Utwórz połączenie

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"
  }'

Jedno wywołanie łączy jedną organizację Supabase.

• organization można pominąć tylko wtedy, gdy token ma dostęp do dokładnie jednej organizacji; w przeciwnym razie wywołanie kończy się błędem 400 wymieniającym slugi dostępnych organizacji.

Odpowiedź wymienia, co zostało połączone, z już działającą pierwszą synchronizacją. Przycięta do dwóch pól, które czyta reszta przepływu:

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

Konto, które jest już połączone, trafia do failures zamiast do accounts, więc powtórzenie wywołania nigdy nie duplikuje połączenia.

Poczekaj na pierwszą synchronizację

Odpytuj każde zwrócone konto po jego id, aż status osiągnie ready (new po rejestracji, syncing w trakcie napływu zasobów):

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

Daj pętli termin, aby nieudane połączenie kończyło zadanie błędem zamiast je zawieszać. Gdy konto jest ready, jego zasoby są w topologii, a Polylane uruchomiło pierwszą kontrolę.

Odłącz przez API

Usunięcie połączenia zatrzymuje każdą synchronizację i kontrolę oraz usuwa poświadczenia, które Polylane przechowywało. Wywołanie wymaga zakresu cloud_accounts:delete:

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

Potem odwołaj poświadczenie Supabase po stronie dostawcy, jak opisano poniżej w sekcji Disconnect.