Provisioning SCIM

Dzięki SCIM 2.0 Państwa dostawca tożsamości, na przykład Microsoft Entra ID lub Okta, zarządza użytkownikami exoCortex w Państwa imieniu: gdy zatrudniana jest nowa osoba, użytkownik zostaje utworzony; gdy zmienia stanowisko, zostaje zaktualizowany; gdy odchodzi z firmy, zostaje dezaktywowany.

Połączenie dostawcy tożsamości

1. W exoCortex Core należy otworzyć Identity → SCIM i wygenerować token SCIM. Należy go od razu skopiować: jest wyświetlany tylko raz.
2. W dostawcy tożsamości należy dodać aplikację z provisioningiem SCIM 2.0 i podać:
   • Bazowy URL: https://exocortex-api.ai-exo-cortex.com/scim/v2
   • Uwierzytelnianie: token typu bearer, czyli token wygenerowany w kroku 1.
3. Należy uruchomić test połączenia w dostawcy tożsamości, a następnie przypisać do aplikacji użytkowników i grupy do synchronizacji.

Token należy do jednego tenanta: dostawca tożsamości widzi tylko użytkowników tego tenanta i tylko nimi zarządza.

Co obsługuje exoCortex

Funkcja	Obsługa
Użytkownicy: tworzenie, odczyt, zastępowanie, aktualizacja (PATCH), usuwanie	tak
Grupy: tworzenie, odczyt, aktualizacja (PATCH), usuwanie	tak
Filtry	tak, na przykład userName eq "[email protected]", także z and; do 200 wyników
Sortowanie	tak
Operacje zbiorcze (bulk)	nie
Zmiana hasła	nie: hasło wybiera użytkownik
ETag	nie

Atrybuty użytkownika

exoCortex używa standardowych atrybutów schematu użytkownika SCIM:

• userName: identyfikator użytkownika, zwykle firmowy adres e-mail;
• externalId: identyfikator użytkownika w Państwa dostawcy tożsamości;
• name.givenName i name.familyName, displayName;
• emails, z adresem głównym oznaczonym jako primary;
• active: jeśli ma wartość false, użytkownik jest dezaktywowany;
• title i userType, jeśli występują.

Dezaktywacja i usuwanie użytkownika

Gdy użytkownik odchodzi z firmy, dostawca tożsamości dezaktywuje go żądaniem PATCH, które ustawia active na false:

{
  "schemas": ["urn:ietf:params:scim:api:messages:2.0:PatchOp"],
  "Operations": [{ "op": "replace", "path": "active", "value": false }]
}

Żądanie DELETE dla użytkownika usuwa go z provisioningu (deprovisioning).

Błędy

Endpointy SCIM odpowiadają dokumentami błędów SCIM (RFC 7644). Kod 401 oznacza brakujący, nieprawidłowy, unieważniony lub wygasły token: należy wygenerować nowy token i zaktualizować go w dostawcy tożsamości.