Deze handleiding voor het instellen van SSO vereist dat er acties worden uitgevoerd in het Mercell Tendering and Bidding-platform en in uw Identity Provider (IdP). Voor elke fase hebben we beschreven waar de actie vereist is: in het Mercell-platform of in uw IdP.
Opmerking: Deze handleiding is gebaseerd op Entra ID. Als u een andere Identity Provider (IdP) gebruikt, zullen de stappen grotendeels vergelijkbaar zijn, maar kunnen ze enigszins afwijken.
Fase 1: Informatie verstrekt door Mercell
Om te beginnen met de configuratie in uw Identity Provider (IdP), heeft u de volgende twee belangrijke eindpunten nodig, die Mercell genereert in de SSO-configuratiewizard:
Entity ID: Hiermee wordt de Mercell-applicatie uniek geïdentificeerd voor uw IdP.
Redirect URL: Dit is de bestemming waar uw IdP het beveiligde SAML-token naartoe stuurt nadat een gebruiker succesvol is geauthenticeerd.
Vereiste actie in het Mercell-platform:
Ga naar Instellingen > Organisatiebeheer > Bewerken > SSO > SSO configureren om de Entity ID en Redirect URL te verkrijgen.
Beide komen beschikbaar om te kopiëren in de configuratiewizard.
Vereiste actie in uw IdP:
Maak een nieuwe aangepaste SAML-applicatie aan in uw Identity Provider en voer de waarden voor de Entity ID en Redirect URL in bij de sectie voor basis SAML-configuratie.
Fase 2: Attribute- en Claim Mapping
Om gebruikersaccounts bij het inloggen correct te kunnen identificeren en in te richten (provisioning), moet uw IdP specifieke gebruikersgegevens (claims) meesturen in het SAML-antwoord.
Vereiste actie in uw IdP: Configureer uw SAML-applicatie om de volgende attributen vrij te geven aan Mercell:
E-mail: Het primaire e-mailadres van de gebruiker.
Belangrijke opmerking voor Entra ID-gebruikers: Zorg ervoor dat de claim die het e-mailadres bevat, nauwkeurig is toegewezen (mapped). Als uw omgeving afhankelijk is van de User Principal Name (UPN) voor e-mail, zorg er dan voor dat de bijbehorende claim-URL aan ons wordt doorgegeven.
Voornaam / Given Name: De voornaam van de gebruiker.
Achternaam / Surname: De achternaam van de gebruiker.
Let op: Noteer exact welke claimnamen of Namespace URI's uw IdP verzendt voor deze attributen, aangezien u deze in fase 3 aan Mercell moet doorgeven.
Fase 3: Informatie vereist van de IdP
Mercell heeft uw Identity Provider-gegevens nodig om de configuratie aan onze kant af te ronden.
Vereiste actie in het Mercell-platform: Gebruik de SSO-configuratiewizard om de volgende informatie met Mercell te delen:
Ga eerst terug naar Instellingen > Organisaties > Bewerken > SSO > SSO configureren en klik op Volgende (Next) totdat u bij het scherm Identity Provider-gegevens invoeren (Enter identity provider details) komt.
Vul de naam van uw IdP in het veld Providernaam (Provider name) in.
Kies tussen het uploaden van uw Metadata XML-bestand of het invoeren van de document-URL, en upload of plak vervolgens de link naar de URL in de wizard.
De App Federation Metadata URL is een openbaar toegankelijke URL die wordt gegenereerd door uw IdP (vaak eindigend op .xml). Deze bevat uw openbare ondertekeningscertificaten, Entity ID en login-eindpunten.
Maak een keuze uit de optionele instellingen:
SAML-ondertekening en -versleuteling (SAML signing and encryption - SAML-verzoek aan deze provider ondertekenen, zie fase 4 voor meer informatie).
Versleutelde SAML-bevestigingen van deze provider vereisen (Require encrypted SAML assertions from this provider).
Klik op Doorgaan (Continue) totdat u het scherm Gebruikersattributen toewijzen (Map user attributes) bereikt:
Geef de exacte string of URI-naam op die wordt verzonden voor het E-mail attribuut (bijv. email, mail, of http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress).
Geef de claimnamen op die worden verzonden voor Voornaam en Achternaam.
Klik op SSO inschakelen (Enable SSO).
Fase 4: Gebruikersdomeinen toevoegen aan de SSO-configuratie
Voeg e-maildomein(en) toe voor Just-in-Time (JIT) Provisioning zodat Mercell-gebruikersaccounts automatisch worden aangemaakt bij hun eerste succesvolle SSO-login.
Om deze fase te voltooien, moet u de geautoriseerde e-maildomein(en) die door uw organisatie worden gebruikt (bijv. @uwbedrijf.nl) doorgeven aan uw contactpersoon bij Mercell.
Het technische team van Mercell zal de configuratie afhandelen om deze provisioning-functie voor uw domeinen in te schakelen.
Fase 5 (indien van toepassing): Encryptie van SAML-bevestigingen
Voor extra beveiliging kan uw organisatie vereisen dat de SAML-bevestigingen (assertions) die naar Mercell worden gestuurd, worden versleuteld. Dit zorgt ervoor dat de gebruikersgegevens tijdens de overdracht worden versleuteld en alleen door Mercell kunnen worden ontsleuteld.
Om dit in te schakelen, zal Mercell u voorzien van ons openbare encryptiecertificaat:
Mercell Public Key Certificaat (.crt bestand): [Mercell zal dit bestand op verzoek verstrekken]
Vereiste actie in uw IdP:
Download het openbare certificaat dat door Mercell is verstrekt.
Navigeer in de SAML-configuratie van uw Identity Provider naar Tokenversleuteling (Token Encryption).
Upload het openbare certificaat van Mercell en activeer het om uitgaande SAML-tokens te versleutelen.
Fase 6: Afronding en testen
Vereiste actie in uw IdP:
Wijs een testgebruiker toe aan de applicatie in uw Identity Provider.
Voer een test-login uit (in het Mercell-platform) om te bevestigen dat de routering correct is, het SAML-token correct is ondertekend en versleuteld, de gebruiker automatisch wordt ingericht (auto-provisioned) en het e-mailattribuut succesvol wordt doorgegeven.
Fase 7: Gebruikersdomeinen toevoegen aan de SSO-configuratie
Vereiste actie in het Mercell-platform: Geef de geautoriseerde e-maildomein(en) op die door uw organisatie worden gebruikt (bijv. @uwbedrijf.nl).
Ga terug naar Instellingen > Organisaties > Bewerken > SSO > SSO configureren (Settings > Organisations > Edit > SSO > Config SSO).
Selecteer Domeinen toevoegen (Add domains).
Voer uw geautoriseerde e-maildomein(en) in en selecteer Opslaan (Save).
Article Reference: 150520260851