Identity Governance & Administration
sara.next
  1. sara.next
  2. Technologia
  3. Budowa adaptera

Technologia · Dla deweloperów

Budowa adaptera

Adapter IGA nie powinien tylko „wywoływać API”. Musi bezpiecznie przełożyć zatwierdzoną decyzję biznesową na weryfikowalną zmianę uprawnień.

  • REST
  • SQL
  • Groovy
  • idempotencja
  • weryfikacja

Kontekst

Kiedy adapter jest potrzebny

sara.next centralizuje proces zarządzania dostępami, ale zasoby docelowe różnią się formatem kont, rolami i metodami integracji. Dla jednej aplikacji wystarczy wywołanie REST, dla innej — zapis przez kontrolowany interfejs SQL, a dla starszego systemu — realizacja manualna przez implementatora. Adapter jest warstwą translacji pomiędzy modelem wniosku a specyfiką systemu docelowego.

UwagaDokumentacja sara.next opisuje bezpośrednią autoimplementację przez konfigurowane połączenia REST/SQL i skrypty Groovy. Nie obejmuje uniwersalnego, publicznego SDK ani jednego obowiązującego „kontraktu adaptera” udostępnianego wszystkim partnerom.

Jeżeli zespół tworzy osobny serwis-adapter, jego interfejs powinien zostać zaprojektowany i uzgodniony w projekcie.

Proces

Etapy budowy integracji

  1. Inwentaryzacja uprawnień

    Identyfikator konta, role, grupy, zakresy (wymiary), uprawnienia wynikowe i zależności.

  2. Mapowanie operacji

    create, modify, replace, delete, a także odczyt stanu do weryfikacji.

  3. Reguły decyzyjne

    Określ, kiedy dostęp można zmienić, a kiedy trzeba go zablokować lub odesłać do właściciela aplikacji.

  4. Połączenie

    Wybierz REST albo SQL zgodnie z udokumentowanym sposobem autoimplementacji; połączenie musi mieć minimalne uprawnienia.

  5. Walidacja i test

    Sprawdzaj słowniki, identyfikatory, dozwolone wartości i konfliktujące przypisania.

  6. Weryfikacja rezultatu

    Potwierdzaj rzeczywisty stan docelowy, a nie wyłącznie status HTTP lub sukces wykonania SQL.

  7. Obsługa awarii

    Zaplanuj rozróżnienie błędu trwałego od chwilowego i bezpieczny sposób wznowienia procesu.

Przykład projektowy

Kontrakt logiczny — przykład projektowy, nie publiczne API sara.next

{
  "requestId": "IGA-2026-00125",
  "operation": "grant",
  "subject": "user-1234",
  "targetSystem": "finance-app",
  "entitlement": "invoice-read",
  "scope": { "company": "PL01" },
  "approvedAt": "2026-11-15T10:00:00Z"
}

To przykładowy wewnętrzny kontrakt logiczny ułatwiający rozmowę z zespołem integracji; nie należy traktować go jako gotowego payloadu obsługiwanego przez produkt.

Rzeczywiste pola sara.next są dostępne przez zmienne skryptu, m.in. user, oldUser, role, dimensions, request, application.

Warianty

Wybór modelu implementacji

Wybór modelu implementacji
WariantKiedy stosowaćGłówna konsekwencja
Bezpośredni RESTSystem posiada kontrolowalne API do zarządzania uprawnieniamiUtrzymanie mapowania endpointów i autoryzacji
Bezpośredni SQLBrak API, ale producent dopuszcza kontrolowaną integrację DBDuże wymagania wobec zakresu uprawnień i zgodności z modelem DB
Dedykowany mikroserwis-adapterZłożone reguły, kilka endpointów, asynchroniczność lub osobna domena uprawnieńDodatkowy komponent do utrzymania, monitoring i kontrakt API
Manualny implementatorSystem odizolowany lub brak bezpiecznej ścieżki automatyzacjiDłuższy czas realizacji, konieczność niezależnej kontroli wykonania

Weryfikacja

Prawidłowy odczyt stanu docelowego

Adapter nie powinien uznawać operacji grant za skuteczną wyłącznie dlatego, że serwer zwrócił 200 lub 204. Niektóre API wykonują operacje asynchronicznie, a niektóre zwracają poprawną odpowiedź mimo braku oczekiwanego członkostwa w roli. Weryfikacja powinna odczytywać konkretne przypisanie roli w odpowiednim zakresie i obsługiwać opóźnioną spójność. Gdy weryfikacja wymaga dodatkowych reguł, należy je uzgodnić w kodzie skryptu lub adaptera.

sara.nextSkrypt / adapterSystem docelowy01 Zatwierdzona zmiana: grant02 Żądanie zmiany uprawnienia03 Odpowiedź 200 lub 20404 Odczyt przypisania roli w zakresie05 Rzeczywisty stan docelowy06 Wynik weryfikacji
Schemat poglądowy. Sama odpowiedź 2xx nie potwierdza, że uprawnienie istnieje.

Opinia eksperta wdrożeniowego

Udana integracja to spójność po powtórzeniu i timeoucie

Za udaną integrację uznaję nie tę, która umie nadać dostęp w demonstracji, lecz tę, która zachowuje spójność po powtórzeniu operacji, timeoutach i zmianie zakresu roli.

Najwięcej problemów produkcyjnych powoduje źle zdefiniowana semantyka replace i modify: usunięcie starego uprawnienia nie zawsze oznacza, że można bezpiecznie usunąć konto lub całą grupę uprawnień użytkownika.

Odbiór

Czego wymagamy w odbiorze adaptera

Obsługa błędów i wyjątków

Zakres testów odbiorczych

  • testy pozytywne wszystkich operacji
  • test odmowy dostępu
  • test błędnego identyfikatora
  • timeout
  • ponowienie identycznego żądania
  • brak uprawnień konta technicznego
  • rozbieżny stan przed i po operacji
  • korelacja logów
  • procedura ręcznego odzyskania zgodności

Omów model uprawnień systemu docelowego

Wybierzemy najbezpieczniejszy wariant integracji dla Twojej aplikacji.