Introductie
Zivver ondersteunt Single Sign-On (SSO) via Okta, zodat gebruikers kunnen inloggen bij Zivver met de inloggegevens van hun werkplek. In deze handleiding lees je hoe je als beheerder SSO instelt.
SSO werkt op basis van de standaard Security Assertion Markup Language (SAML) v2.0. Okta fungeert als Identity Provider (IdP) en Zivver als Service Provider (SP).
Om SSO in Zivver te activeren, heb je het volgende nodig:
- Je bent Zivver-beheerder.
- Je hebt toegang tot de beheerfunctionaliteit in Okta.
Voorbeeld-URL: https://[organisatie]-admin.okta.com/admin/dashboard
SSO instellen in Okta
De eerste stap is om Zivver toe te voegen als SAML SP-applicatie in Okta.
- Log in bij Okta.
- Ga naar de Admin dashboard.
- Vouw Applications uit.
- Klik op Applications.
- Klik op Add Application.
- Klik op Create App integration.
- Stel Sign on method in op SAML 2.0.
- Klik op Next.
- Voer
Zivver in als App name. - Upload eventueel een logo, zoals het Zivver-logo.
- Klik op Next.
- Schakel Use this for Recipient URL and Destination URL uit.
- Vul de volgende gegevens in:
| Instelling | Waarde |
|---|
| Single sign on URL | https://app.zivver.com/api/sso/saml/consumer/ |
| Recipient URL | https://app.zivver.com/SAML/Zivver |
| Destination URL | https://app.zivver.com/api/sso/saml/consumer/ |
| Audience URI (SP Entity ID) | https://app.zivver.com/SAML/Zivver |
| Default RelayState | N.v.t., laat leeg |
| Name ID format | E-mailadres |
| Application username | Email |
- Klik op Show Advanced Settings.
- Vul de volgende details in:
| Instelling | Waarde |
|---|
| Response | Signed |
| Assertion Signature | Signed |
| Signature Algorithm | RSA-SHA256 |
| Digest Algorithm | SHA256 |
| Assertion Encryption | Unencrypted |
| Authentication context class | PasswordProtectedTransport |
| Honor Force Authentication | Yes |
| SAML Issuer ID | http://www.okta.com/{org.externalKey} (vervang {org.externalKey} door je eigen organisatie-external key) |
- Ga naar de sectie Attribute Statements (optional).
- Vul de volgende gegevens in:
| Naam | Waarde |
|---|
https://zivver.com/SAML/Attributes/ZivverAccountKey | user.id |
urn:oid:2.5.4.42 | user.displayName |
urn:oid:2.5.4.20 | user.mobilePhone |
urn:oid:2.5.4.3 | user.firstName |
- Klik op Next.
- Vul eventueel de optionele velden in.
- Klik op Finish.
- Ga naar het tabblad Sign On van de zojuist gemaakte applicatie.
- Zoek in de sectie Sign on methods de Metadata URL.
- Klik op Copy.
Je hebt de Metadata URL nodig in de volgende stap. Lukt het niet? Bekijk de Okta-documentatie. - Ga naar het tabblad Assignments.
- Wijs de Zivver-applicatie toe aan gebruikers of groepen.
Okta is nu correct ingesteld voor Zivver.
