Uruchomienie i konfiguracja - Google, GitHub i Facebook

Co robi ta integracja

Logowanie społecznościowe pozwala zalogować się do DockRay przez Google, GitHub albo Facebook zamiast hasła - bezpłatnie, dla każdego konta. Przycisk dostawcy pojawia się na ekranie logowania i rejestracji, ale wyłącznie wtedy, gdy ten dostawca ma w panelu komplet kluczy OAuth i jest włączony. Wyłączony albo nieskonfigurowany dostawca odpowiada 404, nie 403 - adres, którego nikt nie ogłosił, nie ma po co zdradzać, że zadziała po wpisaniu kluczy.

Kto konfiguruje dostawców

Klucze OAuth wpisuje wyłącznie superadmin Docka w ustawieniach platformy - to ustawienie globalne, wspólne dla wszystkich kont, tak samo jak klucze Stripe'a. Subskrybenci nie widzą tego ekranu i nie mogą podłączyć własnej aplikacji OAuth.

Co przygotować u dostawcy

Dla każdego dostawcy, którego chcesz włączyć, załóż aplikację OAuth w jego konsoli deweloperskiej (Google Cloud Console, ustawienia dewelopera GitHub, Meta for Developers) i wygeneruj parę Client ID / Client Secret. Panel DockRay wylicza i pokazuje gotowy do skopiowania adres powrotny dla każdego dostawcy - wklej go dokładnie w pole Redirect URI w konsoli dostawcy. Rozjazd między tym adresem a tym, co aplikacja naprawdę obsługuje, jest najczęstszą przyczyną, dla której logowanie danym dostawcą nie działa.

Włączenie w panelu

W Ustawieniach platformy wklej Client ID i Client Secret danego dostawcy i włącz przełącznik. Sekret jest szyfrowany i po zapisaniu nie wraca do formularza - puste pole przy kolejnej edycji znaczy „zostaw obecny sekret", nie „wyczyść go". Dostawca staje się widoczny na ekranie logowania dopiero, gdy ma jednocześnie włączony przełącznik i komplet obu kluczy - jedno bez drugiego nie wystarcza.

Adresy logowania i powrotu

Dla każdego dostawcy DockRay wystawia parę tras o przewidywalnym kształcie:

/auth/{provider}           przekierowanie do dostawcy
/auth/{provider}/callback  powrót i dokończenie logowania

To właśnie adres callback, policzony dla konkretnego środowiska (produkcja albo stage), panel pokazuje gotowy do wklejenia w konsoli dostawcy - nie trzeba go składać ręcznie ani zgadywać schematu.

Pierwszy test

Otwórz ekran logowania w oknie prywatnym i sprawdź, że przycisk włączonego dostawcy jest widoczny. Zaloguj się nim na koncie testowym - powinieneś wrócić do panelu zalogowany, a jeśli konto wymaga weryfikacji dwuskładnikowej, powinieneś zostać o nią poproszony tak samo, jak przy logowaniu hasłem.