Met Signer SSO gebruiken interne ondertekenaars hun bestaande bedrijfsaccount als extra verificatie bij het ondertekenen van documenten. In deze handleiding leest u hoe u de Signer SSO-koppeling tussen ValidSign en Microsoft Entra ID (voorheen Azure AD) op basis van SAML inricht. Wilt u eerst weten hoe ondertekenen met Signer SSO werkt? Lees dan het artikel 'Hoe werkt ondertekenen met Signer SSO in ValidSign?'.
Voordat u begint
Signer SSO is een aanvullende module en moet door ons supportteam voor uw omgeving worden geactiveerd. Neem hiervoor contact op via support@validsign.eu.
Signer SSO werkt met een eigen app in uw identity provider. Gebruikt u al Single Sign-On om in te loggen op ValidSign? Dan maakt u voor Signer SSO een tweede, aparte app aan. De inrichting lijkt op die van de gewone SSO-app, maar de entiteits-id is anders.
Gebruikt u SURFconext? Dan hoeft u geen app aan te maken. Neem contact op met support@validsign.eu, dan richten wij de koppeling met u in.
De inrichting aan uw kant duurt ongeveer 15 minuten.
Stap 1: De app aanmaken in Microsoft Entra ID
Log in op uw Azure AD-tenant als globale beheerder;
Klik in het linkermenu op 'Microsoft Entra ID';
Klik vervolgens op 'Bedrijfstoepassingen';
Klik bovenin op de knop 'Nieuwe toepassing';
Klik nogmaals bovenin op de knop 'Uw eigen toepassing maken';
Vul de naam van de app in, bijvoorbeeld 'ValidSign Signer SSO'. Zo houdt u deze makkelijk uit elkaar met een eventuele bestaande ValidSign SSO-app;
Kies voor de optie 'Een willekeurige toepassing integreren die niet aanwezig is in de galerie (niet-galerie)' en klik op 'Maken'.
Stap 2: SAML instellen
U komt nu op de overzichtspagina van de app. Klik op 'Eenmalige aanmelding' en kies voor 'SAML';
Klik bij 'Standaard SAML-configuratie' op 'Bewerken' en vul de volgende gegevens in:
Id (entiteits-id)
urn:saml:signer-sso:production:ValidSign:eu
Let op: dit is een andere waarde dan bij de gewone SSO-koppeling (urn:saml:sso:production:ValidSign:eu). Gebruik voor Signer SSO altijd de waarde met 'signer-sso'.Antwoord-URL (URL voor Assertion Consumer Service)
Deze URL ontvangt u van ons nadat u de metadata heeft aangeleverd (zie stap 4). Vul hier tijdelijk https://my.validsign.eu in.Aanmeld-URL
Ook deze URL ontvangt u van ons nadat u de metadata heeft aangeleverd.
Klik bovenin op 'Opslaan'.
Stap 3: Claims instellen
Heeft u al een Signer SSO-app (of een gewone SSO-app) ingericht? Neem dan de claimconfiguratie aan de kant van Entra ID over van die app. Let wel op dat de claimnamen hieronder exact zo worden overgenomen.
Klik bij 'Gebruikerskenmerken en claims' op 'Bewerken';
Verwijder alle standaard toegevoegde 'Aanvullende claims' die beginnen met 'http://schemas.xmlsoap.org/' via de drie puntjes en 'Verwijderen';
Voeg via 'Nieuwe claim toevoegen' de volgende drie claims toe. Vul telkens de 'Naam' in, selecteer het 'Bronkenmerk' en klik op 'Opslaan':
Naam | Bronkenmerk |
|---|---|
user.mail | |
firstname | user.givenname |
lastname | user.surname |
Let op: de claims 'accountId' en 'roleId' uit de gewone SSO-handleiding zijn voor Signer SSO niet nodig.
Stap 4: Metadata delen met ValidSign
Ga in de app naar 'Eenmalige aanmelding' en scroll naar het onderdeel 'SAML-certificaten';
Kopieer de waarde van 'App-URL voor federatieve metagegevens' (of download het metadata-XML-bestand);
Stuur de Metadata URL of het XML-bestand naar uw ValidSign-consultant of naar support@validsign.eu. Vermeld daarbij dat het om Signer SSO gaat.
Stap 5: Configuratie afronden
Wij richten de koppeling aan onze kant in en sturen u daarna de Antwoord-URL (ACS) en de Aanmeld-URL;
Vul deze waarden in bij 'Standaard SAML-configuratie' (zie stap 9) en klik op 'Opslaan';
Wijs de medewerkers die via Signer SSO moeten kunnen ondertekenen toe aan de app. Dit doet u onder 'Gebruikers en groepen' van de app, via 'Gebruiker/groep toevoegen'.
Let op: deze groep kan afwijken van de groep die toegang heeft tot uw ValidSign-app voor gewone SSO. Voor ondertekenen met Signer SSO is namelijk geen ValidSign-account nodig. Wijs daarom alle medewerkers toe die als interne ondertekenaar documenten moeten kunnen ondertekenen, ook als zij zelf geen ValidSign-gebruiker zijn.
De koppeling is nu klaar. Interne ondertekenaars kunnen vanaf nu met Signer SSO ondertekenen.
Vragen?
Heeft u vragen over de configuratie? Neem dan contact op met uw consultant of met ons supportteam via support@validsign.eu.