ADFS integration
Denne side beskriver hvilke opgaver der skal udføres for at oprette et fødereret login mellem Medcoms videobooking og en ADFS løsning.
Medcom har udviklet en brugergrænseflade, der kan anvendes til at vedligeholde møder i Medcoms VDX system. Et screenshot fra løsningen vises nedenfor:
Brugergrænsefladen kan tilgås på følgende adresse: https://vconf.dk/booking
Inden brugere kan opnå adgang til brugergrænsefladen skal brugerne logge ind. Hvis man prøver at tilgå løsningen, uden at være logget ind, vil man blive mødt med en loginside i stil med nedenstående.
Da Medcoms loginløsning bygger på SAML standarden er det muligt at delegere selve login problematikken til andre SAML Identity Providers.
Når der er lavet en ADFS integration vil aktivering af fortsæt knappen, for den givne organisation, have den effekt, at brugeren stilles videre til organisationens Identity Provider (Microsoft ADFS).
Organisationens Identity Provider skal forestå selve brugerautentificering (validering af brugeren akkreditiver) og ved succesfuldt login sende en SAML assertion tilbage til Medcoms loginløsning indeholdende informationer om den indloggede bruger.
Overordnet set er der to opgaver:
- Sammenkobling mellem Medcoms videologin og organisationens ADFS
- Mapning af brugeregenskaber i organisationens ADFS til egenskaber i Medcoms bookingløsning
De to opgaver beskrives og nedbrydes nedenfor.
Ved sammenkoblingen skal der udveksles metadata mellem de to systemer:
- Videoløsningens metadata skal sættes op/importeres i organisationens ADFS. Videoløsningens metadata er udstillet på denne URL: https://login.vconf.dk/auth/realms/<organisation>/broker/<organisation>/endpoint/descriptor
- Medcoms login skal have tilsvarende IdP metadata for organisationens ADFS - enten som en fil eller en tilsvarende URL.
I første omgang vil brugeregenskaberne fra organisationen ikke anvendes, men vil sættes til passende værdier i Medcoms loginløsning, så sammenkoblingen kan testes.
Opgave nr | Beskrivelse | Ansvarlig |
---|---|---|
1 | Import af Medcoms metadata i organisationens ADFS | Tilkoplende organisation |
2 | Fremskaffelse af metadata for organsiationens ADFS | Tilkoplende organsiation |
3 | Import af organisationens ADFS metadata i Medcoms loginløsning | KvalitetsIT |
4 | Opsætning af standardværdier for krævede brugeroplysninger | KvalitetsIT |
5 | Test af loginflow | Tilkoplende organisation + KvalitetsIT |
Som beskrevet i foregående afsnit, så vil der i første omgang opsættes standardværdier for krævede brugeroplysninger (se punkt 4 i foregående afsnit).
I Medcoms bookingløsning anvendes der følgende typer af brugeroplysninger:
- Brugerens organisation
- Brugerens identitet (som email)
- Brugerens (videobooking)-roller
- Brugerens fornavn og efternavn
I forhold til roller, så skelnes der i øjeblikket mellem roller, der anvendes til VDX Booking og Management API.
- VDX Booking (https://vconf.dk/booking)
- Management API (https://vconf.dk/management)
Rollerne er som følger:
- VDX Booking:
- meeting-admin: Kan administrere bookingdetaljer i egen organisation
- meeting-planner: Kan booke møder på vegne af andre
- meeting-user: Kan se egne møder og oprette møder for sig selv
- VDX Management
- management-admin (kan alt i egen organisation samt alle underorganisationer.)
- management-groups (kan styre grupper og undergrupper i egen organisationen)
- management-orgs (kan styre underorganisationer i egen organisation)
- management-localusers (kan styre lokale grupper)
- management-services (kan styre alle services i egen organisation)
- management-meetingrooms (kan styre møderum i egen organisation)
- management-registeredclients (kan styre registrerede klienter i egen organisation)
- management-autoparticipants (kan styre automatiske deltagere i egen organisation)
- management-themes (kan styre temaer i egen organisation)
Udover nævnte brugeroplysninger skal der også laves et claim af typen Name ID i ADFS. Dette skal være i formatet “Persistent Identifier” og værdien skal være noget der unikt identificerer brugeren.
Der skal tages stilling til, hvor de enkelte oplysninger skal stamme fra. Nedenstående tabel opsummerer:
Oplysning | Kilde | Beskrivelse |
---|---|---|
Brugerens organisation | Organisationens ADFS | Denne overføres i attributten ‘http://schemas.xmlsoap.org/ws/2005/05/identity/claims/organisation-id’ i assertion fra organisationens ADFS. |
Brugeren identitet (email) | Organisationens ADFS | Denne overføres i attributten ‘http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress’ i assertion fra organisationens ADFS. |
Brugeren fornavn | Organisationens ADFS | Denne overføres i attributten ‘http://schemas.xmlsoap.org/ws/2005/05/identity/claims/givenname’ i assertion fra organisationens ADFS. |
Brugeren efternavn | Organisationens ADFS | Denne overføres i attributten ‘http://schemas.xmlsoap.org/ws/2005/05/identity/claims/surname i assertion fra organisationens ADFS. |
Brugerens (videobooking)-roller | Organisationens ADFS | Listen af roller overføres i attributten ‘http://schemas.microsoft.com/ws/2008/06/identity/claims/role’ i assertion fra orgsanisationens ADFS. |
Brugerens ID | Organisationens ADFS | Brugerens ID overføres som typen “Name ID” og er i formatet “Persistent Identifier”. |
Der er følgende opgaver:
Opgave nr | Beskrivelse | Ansvarlig |
---|---|---|
1 | Validering+specificering af kilde og beskrivelse af mapning af “Brugerens organisation” | Tilkoplende organisation |
2 | Validering+specificering af kilde og beskrivelse af mapning af “Brugerens identitet (email)” samt for og efternavn (se mapningstabel ovenfor) | Tilkoplende organsiation |
3 | Validering+specificering af kilde og beskrivelse af mapning af “Brugerens (videobooking)-roller” | Tilkoplende organisation |
4 | Mapning af konkrete brugerværdier i Medcoms login løsning | KvalitetsIT |
5 | Test af mapning | Tilkoplende organisation + KvalitetsIT |
Hvis i ønsker at anvende denne loginløsning skal i kontakte vdx@medcom.dk. Medcom verificerer at alle forudsætninger, som f.eks. tilslutningsaftale, er på plads. Er de det vil Medcom sørge for at leverandøren, KvalitetsIT, hjælper jer videre med denne loginløsning.