1. Todennustehtävä tulee määrittää Service Management -alustalla ennen Secure Access -komponentin määrittämistä. Jos et halua määrittää todennustehtävää ensin, voit tehdä koko määrityksen suoraan Secure Accessissa.

• Miten uusi provisiointitehtävä määritetään todennusta varten?

2. Kirjaudu Secure Accessin hallintakonsoliin
Valitse oikea realm, johon määrität tätä federointia

3. Tarkista, että määritys on tallentunut oikein Secure Access -komponenttiin

• Tarkistus voidaan tehdä osoitteessa: https://{TENANT_NAME.com}/auth/ käyttäen tunnusta main.admin (ja vuokralaisen määrityksestä luettua sopivaa salasanaa).
  
   

4. Valitsemalla User Federation, pitäisi näkyä lista Authentication tasks -tehtävistä (jos lista on tyhjä, odota minuutti, jotta tieto siirtyy Service Managementista Secure Accessiin; jos lista on edelleen tyhjä.

5. Valitsemalla Edit tietyltä tehtävältä näet LDAPS-yhteyden tiedot. Kannattaa tarkistaa, että kaikki asetukset ovat kunnossa, erityisesti:

• Import Users: ON
• Edit Mode: READ_ONLY

6. Kun yhteys on tallennettu, oikeaan yläkulmaan ilmestyy Action-valikko, josta pääkäyttäjä voi synkronoida kaikki käyttäjät LDAP:sta Secure Accessiin

7. Tarkista, onko AD_GroupMapper kunnossa. Valitse Mappers User Federationin yläpalkista. Oletusmapperien joukossa tulisi näkyä yksi (tai useampi) group-ldap-mapper-tyyppinen mapperi.

• Jos AD_GroupMapperia ei ole luotu automaattisesti, käyttäjä voi luoda oman napsauttamalla sinistä Add mapper -painiketta.

Esimerkki AD-ryhmämapperista

8. Kun määritys on tarkistettu, pääkäyttäjä voi kokeilla Synchronize all users -toimintoa (mainittu eräässä aiemmista näytöistä). Tämän pitäisi tuoda esiin viesti, joka muistuttaa tätä

9. Synkronoidut käyttäjät voi tarkistaa Users-osiosta



10. Määritys pitäisi nyt olla valmis, ja todennusta on mahdollista testata

11. Seuraava vaihe on määrittää käyttäjätasot ja roolit: https://docs.efecte.com/configure-authentication/configure-esa-to-use-esm-roles 

Secure Access -lokit voidaan ladata Pro/IGA-ratkaisuista Connectors -välilehdeltä, Logs -sivuvalikosta. Lataa sen jälkeen kohdasta esa -lokit, keycloak.log -tiedosto.

1. Jos Secure Accessin lokeissa näkyy SSL-yhteyteen liittyviä ongelmia, kuten esimerkiksi: 

2. Jos SSL:ää käytetään ESA:n yhdistämiseen Active Directoryyn, ESA:n tulee tunnistaa sertifikaatti, jonka AD esittää. Tämä on manuaalinen vaihe, ja se edellyttää:

• Muodosta SSH-yhteys palvelimeen (jos sinulla ei ole pääsyä palvelimeen, ota yhteyttä Matrix42:een)
• Muodosta SSH-yhteys Secure Access (ESA) -konttiin
• Siirry hakemistoon /opt/esa (varmista, että siellä on truststore.jks-tiedosto) 
• Testiympäristöissä voit suorittaa seuraavan komennon (jos sinulla ei ole sertifikaattitiedostoa):
  
  
  • echo -n | openssl s_client -connect IP_OF_AD_SERVER:636 | sed -ne '/-BEGIN CERTIFICATE-/,/-END CERTIFICATE-/p' > NAME_OF_THE_FILE_FOR_EXAMPLE_IP_OF_AD_SERVER.crt
  • Tuotantoympäristöissä on kuitenkin suositeltavaa hankkia juuri- tai välisertifikaatti asiakkaalta, sillä ne ovat yleensä voimassa pidempään kuin palvelintason sertifikaatit.
• Esimerkki voisi olla:
• echo -n | openssl s_client -connect 10.0.2.110:636 | sed -ne '/-BEGIN CERTIFICATE-/,/-END CERTIFICATE-/p' > 10.0.2.110.crt
   

3. Kun sinulla on sertifikaattitiedosto, se tulee tuoda truststore.jks-tiedostoon

• keytool -importcert -file NAME_OF_CERT_FILE.crt -keystore truststore.jks -alias “ALIAS_OF_THE_CERTIFICATE”
• Esimerkiksi: keytool -importcert -file AD_certificate.crt -keystore truststore.jks -alias AD_certificate

4. Käynnistä Secure Access uudelleen ottaaksesi sertifikaatin käyttöön

• Poistu esa-dockerista palvelimelle komennolla: exit
• Tämän jälkeen ESA-kontti tulee käynnistää uudelleen uusien sertifikaattien käyttöön ottamiseksi suorittamalla nämä komennot palvelimella (korvaa [TENANT] vuokralaisesi nimellä):
  docker stop [TENANT]-esa && run-image -e TENANT=[TENANT] esa