Eenmalige aanmelding (SSO)

SSO-handleidingen voor werkruimtebeheerders.

Aanmelden via je organisatie

Laat collega’s zich bij je Undertitle-werkruimte aanmelden met hun bestaande werkaccount. Een beheerder configureert de verbinding in de werkruimte en schakelt ze in. De aanmelding testen is optioneel en blijft beschikbaar voordat of nadat je SSO inschakelt. Configuratiebestanden aanpassen of opnieuw deployen is niet nodig.

Voor je begint

Je hebt een beheerdersaccount in de Undertitle-werkruimte nodig, plus toestemming om een toepassing bij je identiteitsprovider te registreren. Je IT-beheerder kan de stappen bij de provider uitvoeren.

Open je eigen werkruimte. Kies bij Tenantbeheer → Eenmalige aanmelding (SSO) voor Verbinding toevoegen. Kopieer de Omleidings-URI voor aanmelding die daar staat. Gebruik precies die URL bij je identiteitsprovider, inclusief de hostnaam en het pad /sso/callback.

De handleidingen en schermafbeeldingen gebruiken voorbeeldnamen en -identificaties. Vervang die door je eigen gegevens. De Undertitle-afbeeldingen tonen een afzonderlijke demowerkruimte. Providerafbeeldingen komen uit de gelinkte officiële documentatie en kunnen oudere menunamen tonen.

Wat gebeurt er bij het aanmelden?

Bij de eerste geslaagde SSO-aanmelding maakt Undertitle een werkruimtegebruiker aan. Je identiteitsprovider bepaalt wie toegang krijgt tot de Undertitle-toepassing. Beperk die toegang tot de mensen die je werkruimte mogen gebruiken. Elke werkruimtegebruiker kan de werkruimte beheren.

Een bestaande werkruimtegebruiker of een centrale super-admin kan ook een account aanmaken. Openbare zelfregistratie is niet beschikbaar.

Bestaat er al een account met dat e-mailadres, dan koppelt Undertitle het niet automatisch. De gebruiker meldt zich aan met het bestaande wachtwoord, opent Instellingen → Profiel en kiest koppelen naast de naam van de verbinding bij Eenmalige aanmelding (SSO). Daarna meldt de gebruiker zich aan bij de identiteitsprovider. Zonder wachtwoord kan de gebruiker Wachtwoord vergeten? gebruiken als het e-mailadres van het account bereikbaar is.

Na het aanmelden kan nog e-mailverificatie of aanvaarding van de juridische documenten nodig zijn. SSO geeft geen toegang tot het centrale super-adminbeheer.

Mogelijkheden en toegang

  • Per werkruimte kan één SSO-verbinding actief zijn. Een andere verbinding inschakelen vervangt de actieve verbinding.
  • Een ingestelde verbinding behoudt haar providertype. Wil je wisselen tussen Okta en Microsoft Entra ID, maak dan een nieuwe verbinding, test ze en schakel ze in. Bestaande gebruikers moeten hun account expliciet aan de nieuwe verbinding koppelen.
  • Aanmelden met een wachtwoord blijft mogelijk. Deze versie verplicht gebruikers niet om SSO te gebruiken.
  • Groepen, rollen en rechten worden niet gesynchroniseerd. Beheer Undertitle-rollen in de werkruimte.
  • Begin op de aanmeldpagina van je Undertitle-werkruimte. De handleidingen gebruiken de authorization-code-flow, geen ongevraagde callbacks van de identiteitsprovider.
  • Afmelden bij Undertitle beëindigt de Undertitle-sessie, maar meldt je niet af bij Microsoft of Okta.
  • Iemands providertoewijzing verwijderen voorkomt een nieuwe aanmelding bij de provider. Bestaande Undertitle-sessies en wachtwoordtoegang worden niet onmiddellijk ingetrokken. Volg ook het proces voor het verwijderen van gebruikers in je werkruimte.

API-referentie

SSO dient voor gebruikers die zich via de browser aanmelden. API-integraties gebruiken API-sleutels. Open API-documentatie in je werkruimte of ga naar /api/v1/docs op de hostnaam van die werkruimte voor de bestaande API-referentie.