Over login-, logout- en loginredirect-URL’s
De login-URL
De login-URL start het aanmeldproces op voor de gastwebsite tot die gastwebsite is aangemeld.
De login-URL zorgt voor de juiste redirect naar de identity provider. Die IDP is meestal ACM (authentication management) maar kan ook een tussenliggende component zijn.
Type | Naam | Waarde |
Header | loginUrl | https://tni.gastwebsite-acm.burgerprofiel.dev-vlaanderen.be/auth/openid-connect/authorize |
De logout-URL
De logout-URL zorgt ervoor dat het afmeldproces op de gastwebsite start en dat de huidige sessie in de gastwebsite wordt gestopt. Wanneer de gebruiker op ‘Afmelden’ klikt gebeurt er een redirect naar de logout-URL.
Type | Naam | Waarde |
Header | loginUrl | https://tni.gastwebsite-acm.burgerprofiel.dev-vlaanderen.be/auth/openid-connect/authorize |
De loginRedirect-URL
De loginRedirect-URL zorgt bij een geslaagde aanmelding voor een redirect van de browser naar deze URL. Wanneer de gebruiker is aangemeld, wordt er een dashboard getoond.
Type | Naam | Waarde |
Header | loginRedirectUrl | https://tni.gastwebsite-acm.burgerprofiel.dev-vlaanderen.be/profile |
Wat is het verschil tussen de login/logout van ACM en die van Mijn Burgerprofiel?
Beide login-/logout-processen worden gebruikt vanuit een andere context: ACM of Header. Wat wel identiek is voor de beide processen zijn de toegelaten domeinen voor de App-ID en de widgets.
Voorbeeld
De onderstaande URL's zijn ter beschikking van de gastwebsite met gekoppeld toegangsbeheer (single sign-on) of ACM.
Type | Naam | Voorbeeld waarde |
Header | loginUrl | https://tni.gastwebsite-acm.burgerprofiel.dev-vlaanderen.be/auth/openid-connect/authorize |
Deze URL start het login-proces voor de gastwebsite tot aangemelde gastwebsite. | ||
Header | loginRedirectUrl | https://tni.gastwebsite-acm.burgerprofiel.dev-vlaanderen.be/profile |
Deze URL toont een dashboard aan de aangemelde gebruiker . | ||
Header | logoutUrl | https://tni.gastwebsite-acm.burgerprofiel.dev-vlaanderen.be/auth/openid-connect/logout |
Deze URL start het afmeldproces voor de gastwebsite tot afgemelde gastwebsite. | ||
ACM | callbackUrl | https://tni.gastwebsite-acm.burgerprofiel.dev-vlaanderen.be/auth/openid-connect/callback |
Deze URL is een onderdeel van het aanmeldproces. ACM gebruikt deze URL om de status van de authenticatie te rapporteren aan de gastwebsite. Deze URL is dus alleen nuttig in de context van ACM en kan niet stand-alone gebruikt worden door de header. Stand-alonegebruik geeft een foutmelding op de gastwebsite. | ||
Voorbeeld implementatie/integratie: https://tni.gastwebsite-acm.burgerprofiel.dev-vlaanderen.be
Communicatie naar gebruikers van de header over:
Communicatie alleen naar afnemers van headers met gekoppeld toegangsbeheer
WDGTP-145 - Getting issue details... STATUS
Problemen bij het afmelden op Mijn Burgerprofiel
Impact
Alle gebruikers van een website met:
een global header/footer, met gekoppeld toegangsbeheer
met de default-instellingen in Safari en Firefox = blokkering van third-party cookies
Chrome blokkeert third-party cookies niet standaard. Gebruikers van deze browser ondervinden vandaag geen problemen bij het afmelden.
In het kort
Gebruikers van Safari en Firefox ondervinden problemen bij het afmelden in Mijn Burgerprofiel. Digitaal Vlaanderen voerde daarom enkele aanpassingen uit op de global header.
Het gaat hier alleen om websites en toepassingen die gebruik maken van een global header met gekoppeld toegangsbeheer - dus mét een ACM-integratie. De ACM-implementatie moet in deze gevallen worden nagekeken en mogelijks aangepast.
Wie websites en toepassingen gebruikt met eenvoudig toegangsbeheer - dus zonder een ACM-integratie - hoeft geen actie te ondernemen.
Aanleiding
Safari en Firefox blokkeren standaard third-party cookies om de privacy van hun gebruikers beter te beschermen. Ook Mijn Burgerprofiel gebruikt third-party cookies; niet om het gedrag van gebruikers bij te houden en te analyseren, maar wel om single sign-on (SSO) mogelijk te maken tussen verschillende websites met een global header/footer. Zo zijn gebruikers die aanmelden op Vlaanderen.be automatisch ook aangemeld op een andere website met de global header.
Wanneer gebruikers van Safari en Firefox afmelden in Mijn Burgerprofiel, blijft de header in “aangemelde status” omdat die browsers de third-party cookies blokkeren. Digitaal Vlaanderen maakte daarvoor een aantal aanpassingen aan de global header en footer. Omdat ook uw gebruikers mogelijks met Safari en Firefox werken, moet u mogelijks een aantal aanpassingen doorvoeren.
Mogelijke aanpassingen voor websites en toepassingen mét ACM-integratie
Laat in uw implementatie het
end_session_endpointaanspreken om een succesvolle logout bij ACM IDP uit te voeren.
Voor dat endpoint wordt de Discovery URL gebruikt. Die bezorgt de Client alle nodige informatie over de mogelijkheden van de ACM IDP OpenID Connect Provider:
op welke URL’s de verschillende endpoints beschikbaar zijn
welke functionaliteiten aangeboden worden
Om ook in de toepassing afgemeld te worden, is een lokale logout in de toepassing zelf nodig.
De Discovery URL die wordt gebruikt voor dat endpoint staat gedocumenteerd in: https://authenticatie.vlaanderen.be/docs/beveiligen-van-toepassingen/integratie-methoden/oidc/technische-info/discovery-url/ .
Voorzie bij voorkeur ook een
post_logout_redirect_uri.
Voor veiligheidsredenen moet de post-logout redirect URI al in het integratiedossier bij de OpenID Connect aangevraagd en geregistreerd worden.
Meer informatie over afmelden vindt u in de documentatie van het Vlaamse toegangsbeheer: https://authenticatie.vlaanderen.be/docs/beveiligen-van-toepassingen/integratie-methoden/oidc/technische-info/afmelden/
Bij een niet correcte implementatie van de ACM logout zal u een vreemd gedrag opmerken bij het afmelden: u komt in een loop van de volgende toasters terecht:
Technisch spreekuur
Mocht u problemen ondervinden of vragen hebben, dan bent u welkom op ons technisch spreekuur waar onze technische experts u persoonlijk begeleiden om praktische issues op te lossen. U kunt elke dinsdag inbellen om 13:00 uur via Teams.
U kan ook steeds een technische vraag stellen via onze servicedesk.
Graag een seintje via de servicedesk wanneer u de aanpassing hebt uitgevoerd
De servicedesk kan je bereiken via http://vlaanderen.be/digitaalvlaanderen/servicedesk/ik