1. Kirjaudu ESA Adminilla (main.admin) osoitteeseen domain.com/auth/admin
   
   
2. Valitse oikea realm valitsemalla ensin vasemmasta yläkulmasta Manage realms ja klikkaamalla sitten realmin nimen linkkiä. Realmin valinnan käyttöliittymä muuttui julkaisussa 2026.1.2 aiempiin verrattuna.
   
   
3. Avaa Authentication settings vasemmasta sivupaneelista ja valitse sitten listasta Efecte-login. Jos Efecte Login puuttuu, lisää se Create flow -toiminnolla. Nimi on yleensä Efecte Login.
   
   
   
   
   
4. Lisää Execution
   
   
   
   
   
5. Aseta uusi flow pakolliseksi (Required).
   
   
   
6. Sido uusi EFECTE Login -lomake browser flow'hun (Jos Bind flow -vaihtoehtoa ei tarjota Efecte login -lomakkeelle, se on jo käytössä)
   
   
   
   
   
7. Avaa Realm Settings ja välilehti Themes. Varmista, että Efecte-kirjautumisteema on valittuna
   
   
   
8. Muuta Realm User profile -attribuuttien asetuksia
   Valitse oikea Realm pudotusvalikosta
   Siirry kohtaan Realm settings, User profile -välilehti
   

Muokkaa email-, firstName- ja lastName-attribuutteja.

Aseta näille kolmelle attribuutille Required: Off.

Tallenna muutokset näihin attribuutteihin.

Konfiguraatio on nyt valmis.

Kuinka testata kirjautuminen ja uloskirjautuminen

1. Luo paikallinen käyttäjä ESM:ään, esimerkiksi:
   
   
   
2. Siirry ESA:n kirjautumissivulle ja valitse "Credentials Login" ja "Login with Matrix42 account"

3. Kirjaudu ulos.
4. Kirjaudu uudelleen sisään eri käyttäjällä ja varmista, että näet oikean käyttäjän kirjautuneena ratkaisuun.

Jos baseline on käytössä, voit lisätä paikallisen käyttäjän Entitlementteihin IGA Account -mallista ja attribuutista nimeltä Manually assigned group memberships. Paikallisilla käyttäjillä, joilla ei ole jäsenyyksiä hakemistosta, on oltava ryhmäjäsenyydet asetettuna tähän attribuuttiin. Vain hallinnolliseen käyttöön.

Jos baseline ei ole käytössä tai ei ole uusin versio, voit lisätä attribuutin Person-malliin ja muokata lauseketta Group info for ESS connector sisällyttääksesi manuaaliset jäsenyydet.

Jos ESA-kirjautuminen toimii mutta ESM-kirjautuminen ei, tarkista ESM-loki nimeltä itsm.log (Efecte ESM→ Maintenance→Logs→Download logs→itsm.log)

Jos ESA-kirjautuminen ei toimi, tarkista ESA:n server.log (opt/keycloak/standalone/log/server.log) ja ESA-kontin loki /opt/keycloak/logs/keycloak.log

ESA-kirjautuminen onnistuu, mutta itsm-kirjautumisnäyttö näytetään. Tarkista linkitetty artikkeli ja varmista esimerkiksi, ettei userlevel ole käytössä ESM:n paikallisille käyttäjille https://docs.efecte.com/iga-support-library/esm-login-process-with-esa

Huomaa myös, että ESA lähettää tiedot ESM:lle pienillä kirjaimilla. Tämä tarkoittaa, että myös userID:n ESM:ssä on oltava pienillä kirjaimilla.

Kirjautuminen onnistuu, mutta paikallinen käyttäjä ei näe mitään ESS:ssä. Tarkista tämä artikkeli https://docs.efecte.com/iga-configuration-library2/1355364-checklist-user-information-from-esm-to-ess

Jos ESA:n javascript-mappereihin tarvitaan muutos, tarkista tämä artikkeli https://docs.efecte.com/iga-support-library/1812412-esa-custom-javascript-mappers

Kirjautuminen ei toimi ja selaimessa näkyy http 403 -virhe. Tarkista, että Realmisi Shibboleth Client -kohteessa on nämä protokollamapperit muiden mapperien joukossa:
urn:mace:dir:attribute-def:principal ja com:efecte:ess:user