- sara.next
- Technologia
- 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
Inwentaryzacja uprawnień
Identyfikator konta, role, grupy, zakresy (wymiary), uprawnienia wynikowe i zależności.
Mapowanie operacji
create,modify,replace,delete, a także odczyt stanu do weryfikacji.Reguły decyzyjne
Określ, kiedy dostęp można zmienić, a kiedy trzeba go zablokować lub odesłać do właściciela aplikacji.
Połączenie
Wybierz REST albo SQL zgodnie z udokumentowanym sposobem autoimplementacji; połączenie musi mieć minimalne uprawnienia.
Walidacja i test
Sprawdzaj słowniki, identyfikatory, dozwolone wartości i konfliktujące przypisania.
Weryfikacja rezultatu
Potwierdzaj rzeczywisty stan docelowy, a nie wyłącznie status HTTP lub sukces wykonania SQL.
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
| Wariant | Kiedy stosować | Główna konsekwencja |
|---|---|---|
| Bezpośredni REST | System posiada kontrolowalne API do zarządzania uprawnieniami | Utrzymanie mapowania endpointów i autoryzacji |
| Bezpośredni SQL | Brak API, ale producent dopuszcza kontrolowaną integrację DB | Duże wymagania wobec zakresu uprawnień i zgodności z modelem DB |
| Dedykowany mikroserwis-adapter | Złożone reguły, kilka endpointów, asynchroniczność lub osobna domena uprawnień | Dodatkowy komponent do utrzymania, monitoring i kontrakt API |
| Manualny implementator | System odizolowany lub brak bezpiecznej ścieżki automatyzacji | Dł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.
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.
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.