Identity Governance & Administration
sara.next
  1. sara.next
  2. Technologia
  3. 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.

  1. Kolejka

    Gdy wniosek o dostęp zakończy obieg akceptacji, trafia do kolejki autoimplementacji.

  2. Harmonogram

    Harmonogram uruchamia się co minutę i przetwarza wnioski z kolejki.

  3. 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.

  4. 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ć.

Najpierw połączenie
PołączenieGdzie w paneluPola
SQLAdministration → Configuration → SQL ConnectionsNazwa, nazwa systemowa, JDBC URL, nazwa użytkownika, hasło
RESTAdministration → Configuration → REST ConnectionsNazwa, 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

  1. Otwórz konfigurację aplikacji

    Przejdź do Administration → Applications i w kolumnie Actions kliknij przycisk „Auto-implement config” przy wybranej aplikacji.

  2. Włącz mechanizm

    Zaznacz pole Enabled.

  3. Wybierz typ

    W polu Type wybierz SQL albo REST.

  4. Wskaż połączenie

    Wybierz odpowiadające typowi połączenie: SQL Connection albo REST Connection.

  5. Uzupełnij skrypty

    Wypełnij pola skryptów: Create, Replace, Modify, Delete i Verification.

  6. Zapisz

    Kliknij Save.

Zmienne

Zmienne dostępne w skryptach

Wszystkie skrypty otrzymują poniższe zmienne.

Zmienne dostępne w skryptach
ZmiennaTypZawsze dostępnaOpis
userUserTakUżytkownik docelowy: nowy użytkownik dla Create i Modify, użytkownik objęty zamianą dla Replace. Właściwości: samAccountName, mail, givenName, surname.
oldUserUserNie *Poprzedni użytkownik — dostępny dla Delete i Replace. W skryptach Delete zawsze używaj oldUser, nie user.
roleRoleTakRola nadawana lub odbierana. Właściwości: id, name.
dimensionsMap<String, String>TakWartości wymiarów bieżącego wniosku, indeksowane nazwą systemową, np. dimensions["DB_NAME"].
requestAccessRequestTakWniosek o dostęp. Poprzednie wartości wymiarów w skryptach Delete i Modify odczytasz przez request.oldAtar?.dimensionValues.
applicationApplicationTakSkonfigurowana aplikacja.
loginStringNie *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

Pięć skryptów i ich zadania
SkryptKiedy się uruchamiaDostępne zmienneUwagi
CreateGdy nadawany jest nowy dostęp.user, role, dimensions, request, application—
ReplaceGdy istniejący dostęp jest zamieniany (inny użytkownik lub inne wymiary).user, oldUser, role, dimensions, request, applicationJeżeli skrypt jest pusty, system wykonuje kolejno Delete → Create.
ModifyGdy istniejący dostęp jest modyfikowany (ten sam użytkownik, zmienione wymiary).user, oldUser, role, dimensions, request, applicationPusty skrypt Modify również jest zastępowany sekwencją Delete → Create.
DeleteGdy dostęp jest odbierany.oldUser, role, dimensions, request, applicationLogin odbieranego dostępu pobieraj z oldUser, a poprzednie wartości wymiarów z request.oldAtar?.dimensionValues.
VerificationPo skrypcie implementacyjnym, aby potwierdzić wykonanie zmiany.jak wyżej oraz loginWynik 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.

Logika weryfikacji według typu wniosku
Typ wnioskuOczekiwany wynik weryfikacji
Createtrue — użytkownik istnieje w systemie docelowym
Modifytrue — nowy stan istnieje w systemie docelowym
Replacetrue dla nowego użytkownika i false dla poprzedniego
Deletefalse — 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.