Kertakirjautumisen käyttöönotto edellyttää toimenpiteitä sekä Mercell-alustalla että organisaationne identiteetintarjoajan (IdP) järjestelmässä.
Alla oleva ohje on jaettu selkeisiin vaiheisiin, ja kunkin kohdan kohdalla on ilmoitettu, vaatiiko se toimenpiteitä Mercellissä vai IdP:ssä.
Huom. Ohje perustuu Entra ID -järjestelmään. Mikäli käytät toista identiteetinhallintapalvelua, vaiheet ovat pääpiirteittäin samankaltaiset, mutta niissä voi olla pieniä eroja.
Vaihe 1: Mercellin tomittamat tiedot
Aloittaaksesi määritykset identiteetintarjoajasi (IdP) järjestelmässä, tarvitset seuraavat kaksi kriittistä päätepistettä, jotka Mercell luo SSO-määritystyökalussa:
Tunniste: Tunnistaa Mercell-sovelluksen yksilöllisesti identiteetintarjoajallesi.
Uudelleenohjauksen URL-osoite: Kohdeosoite, johon IdP lähettää suojatun SAML-tokenin onnistuneen tunnistautumisen jälkeen.
Toimenpiteet Mercell-alustalla:
Hakeaksesi tunnisteen ja uudelleenohjauksen URL-osoitteen, siirry Mercell-alustalla kohtaan: Asetukset > Organisaation hallinta > Muokkaa > Kertakirjautuminen > Määritä kertakirjautuminen.
Molemmat arvot ovat kopioitavissa SSO-määrityksen ohjatussa toiminnossa.
Toimenpiteet IdP-järjestelmässä:
Luo uusi mukautettu SAML-sovellus identiteetintarjoajasi järjestelmään ja liitä tunniste ja uudelleenohjauksen URL-arvot tunnistetietojen toimittajan SAML-määritysosioon.
Vaihe 2: Käyttäjätietojen ja attribuuttien määritys
Jotta käyttäjätilit voidaan tunnistaa ja luoda oikein sisäänkirjautumisen yhteydessä, identiteetintarjoajasi on lähetettävä tietyt käyttäjätiedot SAML-vastauksessa.
Toimenpiteet IdP-järjestelmässä:
Konfiguroi SAML-sovelluksesi lähettämään seuraavat määreet Mercellille:
Sähköposti: Käyttäjän ensisijainen sähköpostiosoite.
Tärkeää tietoa Entra ID -käyttäjille: Varmista, että sähköpostiosoitteen sisältävä kenttä on kartoitettu oikein. Jos ympäristönne käyttää User Principal Name (UPN) -muotoa sähköpostina, varmista, että sen lähde-URL ilmoitetaan meille.
Etunimi: Käyttäjän etunimi.
Sukunimi: Käyttäjän sukunimi.
Kirjaa ylös tarkat nimet tai nimiavaruudet (Namespace URIs), jotka IdP-järjestelmäsi lähettää näille määreille, sillä tarvitset niitä Mercellin puolella vaiheessa 3.
Vaihe 3: IdP-järjestelmältä vaadittavat tiedot
Mercell tarvitsee tiedot identiteetintarjoajastasi voidakseen viimeistellä määritykset omalta osaltaan.
Toimenpiteet Mercell-alustalla:
Käytä SSO-määritystyökalua jakaaksesi seuraavat tiedot Mercellille.
Palaa kohtaan Asetukset > Organisaation hallinta > Muokkaa > Kertakirjautuminen > Määritä kertakirjautuminen ja klikkaa Jatka, kunnes pääset näkymään Anna tunnistetietojen toimittajan tiedot.
Syötä IdP-järjestelmäsi nimi kenttään Toimittajan nimi.
Valitse, haluatko ladata Metadata XML -tiedoston vai syöttää asiakirjan URL-osoitteen, ja lataa sitten tiedosto tai liitä linkki kenttään.
URL-osoitteella viitataan tässä IdP-järjestelmäsi luomaan julkiseen URL-osoitteeseen (päättyy usein .xml). Se sisältää julkiset allekirjoitusvarmenteet, Entity ID:n ja sisäänkirjautumisen päätepisteet.
Valitse haluamasi valinnaiset asetukset:
Allekirjoita SAML-pyyntö tälle toimittajalle (katso lisätietoja vaiheesta 4).
Edellytä tältä toimittajalta salattuja SAML-vahvistuksia.
5. Klikkaa Jatka, kunnes pääset näkymään Kartoita käyttäjän attribuutit.
Syötä se tarkka merkkijono tai URI-osoite, joka lähetetään sähköpostiattribuuttina (esim.
email,mailtaihttp://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress).Ilmoita etunimi- ja sukunimiattribuutit.
6. Klikkaa Ota kertakirjautuminen käyttöön.
Vaihe 4: Käyttäjätunnusten lisääminen SSO-määrityksiin
Lisää sähköpostien verkkotunnukset (domainit) Just-in-Time (JIT) -provisiointia varten, jotta Mercell-käyttäjätilit voidaan luoda automaattisesti käyttäjän ensimmäisen onnistuneen SSO-sisäänkirjautumisen yhteydessä.
Tämän vaiheen suorittamiseksi sinun on toimitettava organisaationne käyttämät hyväksytyt verkkotunnukset (esim. @yrityksenne.com) Mercellin yhteyshenkilöllesi.
Mercellin tekninen tiimi huolehtii konfiguroinnista, jotta provisiointitoiminto saadaan käyttöön tunnuksellenne.
Vaihe 5 (tarvittaessa): SAML-varmenteiden salaus
Turvallisuuden parantamiseksi organisaatiosi saattaa vaatia, että Mercellille lähetettävät SAML-varmennukset salataan. Tämä varmistaa, että käyttäjätiedot on salattu siirron aikana ja vain Mercell voi purkaa salauksen.
Tätä varten Mercell toimittaa sinulle julkisen salausvarmenteemme:
Mercell Public Key Certificate (.crt-tiedosto): Mercell toimittaa tämän tiedoston pyynnöstä.
Toimenpiteet IdP-järjestelmässä:
Lataa Mercellin toimittama julkinen varmenne.
Siirry identiteetintarjoajasi SAML-määrityksissä kohtaan Token Encryption (Tokenin salaus).
Lataa Mercellin julkinen varmenne järjestelmään ja aktivoi se lähtevien SAML-tokenien salaamiseen.
Vaihe 6: Viimeistely ja testaus
Toimenpiteet IdP-järjestelmässä:
Luo testikäyttäjä sovellukseen IdP-järjestelmässäsi.
Suorita testikirjautuminen varmistaaksesi, että reititys toimii oikein, SAML-token on allekirjoitettu ja salattu oikein, käyttäjätili luodaan automaattisesti ja sähköpostiattribuutti välittyy ongelmitta.
Vaihe 7: Verkkotunnusten lisääminen SSO-määrityksiin
Lisää verkkotunnukset Just-in-Time (JIT) -provisiointia varten, jotta Mercell-käyttäjätilit voidaan luoda automaattisesti ensimmäisen onnistuneen SSO-sisäänkirjautumisen yhteydessä.
Toimenpiteet Mercell-alustalla:
Määritä organisaationne käyttämät hyväksytyt verkkotunnukset (esim. @yrityksenne.com).
Palaa kohtaan Asetukset > Organisaation hallinta > Muokkaa > Kertakirjautuminen > Määritä kertakirjautuminen.
Valitse Lisää verkkotunnuksia.
Syötä hyväksytyt tunnukset ja klikkaa Tallenna.
Mercellin tekninen tiimi huolehtii tämän jälkeen taustajärjestelmän konfiguroinnista, jotta toiminto saadaan aktivoitua verkkotunnuksillenne.
Article Reference: 150520260851