- sara.next
- Technologia
- Konfiguracja autoimplementacji
Technologia · Dokumentacja
Konfiguracja autoimplementacji
Autoimplementacja pozwala sara.next automatycznie wykonać zmianę dostępu — utworzenie, modyfikację lub usunięcie — w systemie docelowym po zatwierdzeniu wniosku, bez ręcznej interwencji.
- przewodnik
- Groovy
- SQL
- REST
Mechanizm
Jak to działa
Harmonogram sprawdza kolejkę co minutę. To częstotliwość działania mechanizmu, a nie gwarancja czasu realizacji zmiany.
Kolejka
Gdy wniosek o dostęp zakończy obieg akceptacji, trafia do kolejki autoimplementacji.
Harmonogram
Harmonogram uruchamia się co minutę i przetwarza wnioski z kolejki.
Skrypt
Dla każdego wniosku wybierany jest właściwy skrypt Groovy, wykonywany na skonfigurowanym połączeniu SQL lub REST. Opcjonalny skrypt weryfikujący potwierdza, że zmiana została zastosowana.
Wynik
Workflow otrzymuje informację „Implemented” albo „Not implemented” — w drugim przypadku z komunikatem błędu.
Wymagania wstępne
Najpierw połączenie
Zanim skonfigurujesz skrypty, zdefiniuj połączenie, z którego będą korzystać.
| Połączenie | Gdzie w panelu | Pola |
|---|---|---|
| SQL | Administration → Configuration → SQL Connections | Nazwa, nazwa systemowa, JDBC URL, nazwa użytkownika, hasło |
| REST | Administration → Configuration → REST Connections | Nazwa, nazwa systemowa, base URL, typ uwierzytelnienia (None / Basic / Bearer / API Key), poświadczenia |
Nazwy pozycji menu, pól i przycisków podano w brzmieniu angielskiej wersji interfejsu.
Konfiguracja
Konfiguracja krok po kroku
Otwórz konfigurację aplikacji
Przejdź do Administration → Applications i w kolumnie Actions kliknij przycisk „Auto-implement config” przy wybranej aplikacji.
Włącz mechanizm
Zaznacz pole Enabled.
Wybierz typ
W polu Type wybierz SQL albo REST.
Wskaż połączenie
Wybierz odpowiadające typowi połączenie: SQL Connection albo REST Connection.
Uzupełnij skrypty
Wypełnij pola skryptów: Create, Replace, Modify, Delete i Verification.
Zapisz
Kliknij Save.
Zmienne
Zmienne dostępne w skryptach
Wszystkie skrypty otrzymują poniższe zmienne.
| Zmienna | Typ | Zawsze dostępna | Opis |
|---|---|---|---|
user | User | Tak | Użytkownik docelowy: nowy użytkownik dla Create i Modify, użytkownik objęty zamianą dla Replace. Właściwości: samAccountName, mail, givenName, surname. |
oldUser | User | Nie * | Poprzedni użytkownik — dostępny dla Delete i Replace. W skryptach Delete zawsze używaj oldUser, nie user. |
role | Role | Tak | Rola nadawana lub odbierana. Właściwości: id, name. |
dimensions | Map<String, String> | Tak | Wartości wymiarów bieżącego wniosku, indeksowane nazwą systemową, np. dimensions["DB_NAME"]. |
request | AccessRequest | Tak | Wniosek o dostęp. Poprzednie wartości wymiarów w skryptach Delete i Modify odczytasz przez request.oldAtar?.dimensionValues. |
application | Application | Tak | Skonfigurowana aplikacja. |
login | String | Nie * | Ustawiana tylko w skrypcie weryfikującym. Zawiera login do sprawdzenia: nowego użytkownika dla Create, Modify i Replace, poprzedniego dla Delete. |
* oldUser i login nie występują we wszystkich typach skryptów — szczegóły w tabeli typów skryptów.
Typy skryptów
Pięć skryptów i ich zadania
| Skrypt | Kiedy się uruchamia | Dostępne zmienne | Uwagi |
|---|---|---|---|
| Create | Gdy nadawany jest nowy dostęp. | user, role, dimensions, request, application | — |
| Replace | Gdy istniejący dostęp jest zamieniany (inny użytkownik lub inne wymiary). | user, oldUser, role, dimensions, request, application | Jeżeli skrypt jest pusty, system wykonuje kolejno Delete → Create. |
| Modify | Gdy istniejący dostęp jest modyfikowany (ten sam użytkownik, zmienione wymiary). | user, oldUser, role, dimensions, request, application | Pusty skrypt Modify również jest zastępowany sekwencją Delete → Create. |
| Delete | Gdy dostęp jest odbierany. | oldUser, role, dimensions, request, application | Login odbieranego dostępu pobieraj z oldUser, a poprzednie wartości wymiarów z request.oldAtar?.dimensionValues. |
| Verification | Po skrypcie implementacyjnym, aby potwierdzić wykonanie zmiany. | jak wyżej oraz login | Wynik interpretowany zależnie od typu wniosku. |
Zastępcze wykonanie Delete → Create może oznaczać krótkotrwałe odebranie dostępu. Dla systemów krytycznych warto przygotować dedykowane skrypty Modify i Replace.
Weryfikacja
Logika weryfikacji według typu wniosku
Skrypt weryfikujący uruchamia się po skrypcie implementacyjnym i potwierdza, że zmiana została zastosowana. Ma dostęp do zmiennej login: dla Create, Modify i Replace jest to nowy użytkownik, dla Delete — poprzedni.
| Typ wniosku | Oczekiwany wynik weryfikacji |
|---|---|
Create | true — użytkownik istnieje w systemie docelowym |
Modify | true — nowy stan istnieje w systemie docelowym |
Replace | true dla nowego użytkownika i false dla poprzedniego |
Delete | false — użytkownika już nie ma (logika odwrócona) |
Odwrócenie dla Delete: harmonogram sam odwraca wynik. Skrypt pisze się tak, jakby sprawdzał obecność — weryfikacja przechodzi, gdy użytkownik nie zostanie znaleziony.
Skonfiguruj autoimplementację z naszym zespołem
Przejdziemy przez połączenie, skrypty i weryfikację na przykładzie Twojej aplikacji.