Service Provider (SP) o.b.v. SAML2.0 aansluiten

Via een SAML2-koppeling kan de Service Provider diensten aanbieden aan meerdere op govconext aangesloten Identity Providers. Dit proces is beschreven in Service Provider (SP) aansluitproces. Voor elke aan te sluiten (web)app(licatie) dient een individueel formulier ingediend te worden (geldt ook voor aansluiten van een Test- of Acceptatie-applicatie). 

Testen op Acceptatie, dan naar Productie 

Van elke (web)app(licatie) wordt eerst een Acceptatie-versie op govconext-Acceptatie aangesloten ter verificatie. Na geslaagde tests kan de Productie-applicatie op govconext-Productie worden aangesloten.  

Let op: op govconext-Productie worden uitsluitend Productie-SP's aangesloten. Zie ook OTAP/DTAP

Let op: voor govconext-Acceptatie worden geen beschikbaarheid gegarandeerd. Testen met beschikbaarheidsgarantie op specifieke momenten dient overeengekomen worden. 

Aan te leveren gegevens door SP:

Via het Technisch intakeformulier “govconext SAML2 voor SP”, dat de SP ontvangt na aanmelding in het govroam klantportaal, geeft de SP (naast contactinformatie) minimaal aan:

  • soort aansluiting: SAML op Acceptatie of Productie-govconext

  • Applicatie-metadata-URL

  • (Link naar) logo (96x96 pixels PNG bestand met transparante of witte achtergrond)

Let op: voor elke applicatie, en elke Productie- of Acceptatie-versie ervan, dient een individueel aansluitformulier te worden ingestuurd.

De Technisch Contactpersoon van de SP stuurt het formulier naar tech@govroam.nl

De technische aansluiting wordt verzorgd door onze partner Prolocation

Inlogmogelijkheid eindgebruikers 

De loginmogelijkheid via govconext dient op een voor eindgebruikers duidelijk vindbare locatie in de applicatie te worden aangebracht met daarbij de vermelding ‘govconext’, al dan niet met logo van govconext.  

Attributen 

De attributen/claims die elke IdP verplicht aan moet leveren, zijn:  

  • Uniek gebruikers-ID: urn:mace:dir:attribute-def:uid (URI) 

  • Uniek organisatie-ID: urn:mace:terena.org:attribute-def:schacHomeOrganization (URI) 

Andere door de SP benodigde of gewenste claims kunnen in onderstaande tabel worden aangegeven (attribuutnaam en format). Op de SURFconext-wiki is een lijst met veel voorkomende claims/attributen te vinden.

Mogelijkerwijs stellen wij alternatieven voor wanneer al attributen gedeeld worden die dezelfde informatie bevatten.  

Voor sommige projecten of ‘use cases’ zijn zeer specifieke attributen of claims nodig. Deze kan de SP opvragen bij de koepelorganisatie die deze use cases bedient. Indien nieuwe attributen benodigd zijn, dienen deze afgestemd te worden.

govconext-gegevens:

SAML Kenmerk 

Waarde / meer informatie 

govconext SAML metadata-URL Acceptatie:  

https://engine.acc.govconext.nl/authentication/idp/metadata

govconext SAML metadata-URL Productie: 

https://engine.govconext.nl/authentication/idp/metadata  

Testen

Govroam zal een testaccount beschikbaar stellen indien de SP niet al via een bekende IdP testaccounts tot haar beschikking heeft.

Meer informatie 

Zie voor meer informatie de SURFconext wiki, waarbij overal waar ‘SURFconext’ vermeld is dit vervangen kan worden door ‘govconext'. Vragen, opmerkingen en het ingevulde formulier kunnen gestuurd worden naar tech@govroam.nl