Denne veiledningen for SSO-oppsett krever at du utfører handlinger i Mercell-plattformen og i din identitetsleverandør (IdP). For hver fase har vi beskrevet hvor handlingen kreves; i Mercell-plattformen eller i din IdP.
Merk: Denne veiledningen er basert på Entra ID. Hvis du bruker en annen identitetsleverandør (IdP), vil trinnene i det store og hele være de samme, men kan variere noe.
Fase 1: Informasjon gitt av Mercell
For å starte konfigurasjonen i din identitetsleverandør (IdP), trenger du følgende to kritiske endepunkter, som Mercell genererer i SSO-konfigurasjonsveiviseren:
Entity ID (Entitets-ID): Denne identifiserer Mercell-applikasjonen unikt for din IdP.
Redirect URL (Omdirigerings-URL): Dette er destinasjonen hvor din IdP vil sende det sikre SAML-tokenet etter at en bruker har autentisert seg.
Handling som kreves i Mercell-plattformen: For å hente Entity ID og Redirect URL, gå til Innstillinger > Organisasjon > Rediger > SSO > Konfigurer SSO. Begge blir tilgjengelige slik at du kan kopiere dem i konfigurasjonsveiviseren.
Handling som kreves i din IdP: Opprett en ny egendefinert SAML-applikasjon i din identitetsleverandør og skriv inn verdiene for Entity ID og Redirect URL i den grunnleggende delen for SAML-konfigurasjon.
Fase 2: Kartlegging av attributter og krav (Claims Mapping)
For at brukerkontoer skal kunne identifiseres og provisjoneres riktig ved innlogging, må din IdP sende spesifikke brukerdata (claims) i SAML-responsen.
Handling som kreves i din IdP: Konfigurer SAML-applikasjonen din til å frigi følgende attributter til Mercell:
E-post: Brukerens primære e-postadresse.
Viktig merknad for Entra ID-brukere: Sørg for at kravet (claim) som inneholder e-postadressen er nøyaktig kartlagt. Hvis miljøet ditt er avhengig av User Principal Name (UPN) for e-post, må du sørge for at tilsvarende krav-URL kommuniseres til oss.
Fornavn: Brukerens fornavn.
Etternavn: Brukerens etternavn.
Vennligst noter deg nøyaktig hvilke krav-navn (claim names) eller Namespace URI-er din IdP sender for disse attributtene, da du må oppgi dem til Mercell i fase 3.
Fase 3: Informasjon som kreves fra IdP
Mercell trenger opplysningene om din identitetsleverandør for å fullføre oppsettet på vår side.
Handling som kreves i Mercell-plattformen: Bruk SSO-konfigurasjonsveiviseren til å dele følgende informasjon med Mercell.
Først, gå tilbake til Innstillinger > Organisasjon > Rediger > SSO > Konfigurer SSO > Klikk på neste til du kommer til visningen for å angi detaljer for identitetsleverandør (Enter identity provider details).
Angi navnet på din IdP i feltet for leverandørnavn (Provider name).
Velg mellom å laste opp din Metadata XML-fil eller angi dokumentets URL, og last deretter opp eller lim inn lenken til URL-en i veiviseren.
App Federation Metadata URL er en offentlig tilgjengelig URL generert av din IdP (som oftest slutter på .xml). Den inneholder dine offentlige signeringssertifikater, Entity ID og innloggingsendepunkter.
Velg blant de valgfrie alternativene:
SAML-signering og kryptering (signer SAML-forespørsel til denne leverandøren, for mer informasjon se fase 4)
Krev krypterte SAML-påstander (assertions) fra denne leverandøren
Klikk på Fortsett (Continue) til du kommer til visningen for å kartlegge brukerattributter (Map user attributes):
Angi den nøyaktige strengen eller URI-navnet som sendes for e-postattributtet (f.eks.
email,mail, ellerhttp://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress).Angi krav-navnene (claim names) som sendes for Fornavn og Etternavn.
Klikk på Aktiver SSO (Enable SSO).
Fase 4: Legg til brukerdomener i SSO-oppsettet
Legg til e-postdomene(r) for Just-in-Time (JIT) provisjonering for at Mercell-brukerkontoer skal opprettes automatisk ved deres første vellykkede SSO-innlogging.
For å fullføre denne fasen må du oppgi de(t) autoriserte e-postdomenet/-domenene som brukes av din organisasjon (f.eks. @dittfirma.no) til din kontaktperson i Mercell.
Mercells tekniske team vil håndtere konfigurasjonen for å aktivere denne provisjoneringsfunksjonen for dine domener.
Fase 5 (hvis aktuelt): Kryptering av SAML-påstand (Assertion)
For økt sikkerhet kan organisasjonen din kreve at SAML-påstandene (assertions) som sendes til Mercell er kryptert. Dette sikrer at brukerdataene er kryptert under overføring og kun kan dekrypteres av Mercell.
For å aktivere dette, vil Mercell gi deg vårt offentlige krypteringssertifikat:
Mercells offentlige nøkkelsertifikat (.crt-fil): [Mercell vil utlevere denne filen på forespørsel]
Handling som kreves i din IdP:
Last ned det offentlige sertifikatet fra Mercell.
I din identitetsleverandørs SAML-konfigurasjon, naviger til Token-kryptering (Token Encryption).
Last opp Mercells offentlige sertifikat og aktiver det for å kryptere utgående SAML-tokens.
Fase 6: Ferdigstilling og testing
Handling som kreves i din IdP:
Tilordne en testbruker til applikasjonen i din identitetsleverandør.
Utfør en testinnlogging (i Mercell-plattformen) for å bekrefte at rutingen er riktig, at SAML-tokenet er signert og kryptert korrekt, at brukeren blir auto-provisjonert, og at e-postattributtet overføres uten feil.
Fase 7: Legg til brukerdomener i SSO-oppsettet
Handling som kreves i Mercell-plattformen:
Oppgi det eller de autoriserte e-postdomenene som brukes av organisasjonen din (f.eks.
@dittfirma.no).Gå tilbake til Innstillinger > Organisasjon > Rediger > SSO > Konfigurer SSO
Velg Legg til domener (Add domains)
Skriv inn dine autoriserte e-postdomener og velg Lagre (Save)
Article Reference: 150520260851