Przejdź do treści

01AI i integracje · moduł

OAuth2 i OIDC dla dodatków

Bezpieczne logowanie dodatków do Draivix przez OAuth2 i OpenID Connect z PKCE

Podstawa gotowa, część w przygotowaniuUmów konsultację
  • Klient OAuth (dodatek)
  • Token dostępu (access token)
  • Token odświeżania (refresh token)
9
funkcjonalności
3
typy rekordów
1
automatyzacja
2
integracje i narzędzia AI

02Co potrafi moduł

Mniej rutyny. Więcej wartości.

Draivix pełni rolę serwera autoryzacji OAuth2 i OpenID Connect dla własnych dodatków, takich jak rozszerzenie przeglądarki do sejfu haseł czy dodatek do zgłaszania błędów. Dodatek loguje użytkownika bez dostępu do jego hasła i otrzymuje ograniczony czasowo token. Administratorzy kontrolują, które dodatki mogą uzyskać dostęp.

  • Dodatek nigdy nie widzi Twojego hasłaDraivix działa jako serwer autoryzacji OAuth2 i OpenID Connect, uwierzytelniając użytkowników na potrzeby dodatków. Dodatek otrzymuje token, a nigdy hasło użytkownika.
  • Logowanie chronione przez PKCEDodatek loguje się przy użyciu kodu autoryzacyjnego z obowiązkowym mechanizmem PKCE – ochroną kodu zaprojektowaną dla klientów publicznych, takich jak dodatki. Wiąże to kod autoryzacyjny bezpośrednio z dodatkiem, który o niego wystąpił.
  • Dostęp ograniczony czasowoToken dostępu jest ważny przez 60 minut, a token odświeżania przez 30 dni. Dodatki nigdy nie otrzymują bezterminowego dostępu; w tej wersji czasu ważności tokenów nie można zmienić.
  • Dodatek wie, kto jest zalogowanyDodatek pobiera dane użytkownika przez OpenID Connect w ramach zakresów openid, profile oraz email, co pozwala mu zidentyfikować użytkownika bez osobnych danych logowania.
  • Dwa gotowe do użycia dodatkiAdministrator może utworzyć klienta dla rozszerzenia przeglądarki obsługującego sejf haseł lub dla dodatku do zgłaszania błędów. Nowe dodatki są dodawane w ramach aktualizacji systemu, a nie w ustawieniach.
  • Dozwolone role dla każdego klientaDla każdego klienta określasz dozwolone role oraz zakresy uprawnień. Zakresy są obecnie egzekwowane wyłącznie przez sejf haseł; pozostałe dodatki działają z uprawnieniami użytkownika, który udzielił dostępu.
  • Kontrolowane adresy URI przekierowańAdresy URI przekierowania po zalogowaniu są zarządzane oddzielnie dla każdego dodatku, co daje administratorowi kontrolę nad tym, dokąd użytkownicy wracają po zalogowaniu.
  • Sejf haseł egzekwuje własne zakresy uprawnieńSejf haseł egzekwuje zakresy vault:read i vault:write, gwarantując, że rozszerzenie przeglądarki może wykonać wyłącznie to, na co pozwala mu nadany zakres.
  • Włączanie i unieważnianie klientów w dowolnym momencieAdministratorzy decydują o aktywności klienta i mogą go w każdej chwili unieważnić, zachowując pełną kontrolę nad tym, które dodatki mają dostęp do systemu.

Co jest obecnie w przygotowaniu

  • Zakresy uprawnień (scopes) są obecnie egzekwowane wyłącznie przez sejf haseł; tokeny dla pozostałych dodatków działają z uprawnieniami użytkownika, który udzielił dostępu.
  • Czasu ważności tokenów (60 minut i 30 dni) nie można zmienić w tej wersji.
  • Zarządzanie dodatkiem sejfu haseł jest dostępne wyłącznie na instancji platformowej.
  • Nowe dodatki są dodawane wraz z nową wersją systemu, a nie w ustawieniach.

03Jak to działa

Jak to działa krok po kroku.

  1. Do czego służy

    Dodatki współpracujące z Draivix poza główną aplikacją muszą bezpiecznie uwierzytelniać użytkowników. Draivix pełni dla nich funkcję serwera autoryzacji OAuth2 oraz OpenID Connect. Użytkownicy logują się w Draivix, a dodatek otrzymuje token zamiast hasła.

    Zobacz szczegóły

    W tej wersji gotowe są dwa dodatki: rozszerzenie przeglądarki dla sejfu haseł oraz dodatek do zgłaszania błędów.

  2. Rejestracja dodatków

    Administrator otwiera stronę administracyjną dodatków i tworzy dla wybranego dodatku klienta OAuth. Każdy rekord klienta przechowuje nazwę, opis, logo, dozwolone role, dozwolone zakresy uprawnień (scopes) oraz informację o tym, czy jest aktywny. Adresy URI przekierowania po zalogowaniu są zarządzane oddzielnie dla każdego dodatku. Klienta można również unieważnić.

  3. Logowanie i tokeny

    Dodatek korzysta z przepływu kodu autoryzacyjnego (authorization code flow) z PKCE, które jest obowiązkowe, ponieważ dodatki są klientami publicznymi. Token dostępu (access token) jest ważny przez 60 minut, a token odświeżania (refresh token) przez 30 dni. Domyślne zakresy to openid, profile oraz email, a dodatek otrzymuje dane użytkownika przez OpenID Connect.

    Zobacz szczegóły

    Sejf haseł egzekwuje własne zakresy vault:read oraz vault:write, dzięki czemu rozszerzenie przeglądarki może wykonywać wyłącznie operacje dozwolone przez swój zakres. Dodatek do zgłaszania błędów korzysta z zakresu bug-report:write.

04Co dzieje się automatycznie

Automatyzacje, które oszczędzają czas.

  1. Automatyczne wygasanie tokenów

    Tokeny dostępu wygasają automatycznie po 60 minutach, a tokeny odświeżania po 30 dniach, dzięki czemu żaden dodatek nie zachowuje dostępu bezterminowo.

Integracje zewnętrzne

  • Sejf haseł w przeglądarceRozszerzenie przeglądarki do sejfu haseł loguje się przez Draivix i otrzymuje token z zakresami vault:read oraz vault:write. Zarządzanie dodatkiem jest dostępne wyłącznie na instancji platformowej.
  • Zgłaszanie błędów przez dodatekDodatek do zgłaszania błędów loguje się przez Draivix i korzysta z zakresu bug-report:write. Token działa z uprawnieniami użytkownika, który udzielił dostępu.

05Często zadawane pytania

Czy Draivix obsługuje OAuth2 i OpenID Connect?

Tak, Draivix działa jako serwer autoryzacji OAuth2 i OpenID Connect dla własnych dodatków, takich jak rozszerzenie przeglądarki do sejfu haseł.

Jak długo ważny jest token dodatku?

Token dostępu jest ważny przez 60 minut, a token odświeżania przez 30 dni. W tej wersji nie można zmienić tych okresów ważności.

Czy logowanie przez dodatek jest bezpieczne?

Tak. Dodatek wykorzystuje przepływ kodu autoryzacyjnego z obowiązkowym mechanizmem PKCE i nigdy nie widzi hasła użytkownika.

Czy mogę podłączyć własną aplikację zewnętrzną przez OAuth?

W tej wersji można rejestrować wyłącznie własne dodatki Draivix, a nowe dodatki pojawiają się wraz z kolejnymi wydaniami systemu. W przypadku własnych integracji skorzystaj z REST API z kluczem API.

Zacznijmy razem

Opowiedz nam, jak działa Twoja firma.

Pokażemy Ci, jak może wyglądać system, który przejmie część tej pracy.

Umów konsultację