AARNet Copyright 2013 Network Operations OpenConext Workshop Down-Under Enabling Federated Team...

AARNet Copyright 2013

Network Operations

OpenConext WorkshopDown-Under

Enabling Federated Team Management,

Group-Aware SPs, and SP Shop-Fronts

Neil Witheridge, AARNetAuthentication & Authorisation Services Technical Manager

25th October 2013

Session 1: Overview


Session 1: Overview - Topics

Session Topics:

• Federated Authentication & Authorisation Background

• OpenConext Features (SP Shopfront, Group/Team mgnt & Group info retrieval)

• Architecture & Components (Demo clean installed OpenConext)

• SAML Proxy: IdP and SP Integration (Demo integrated IdP and SP)

• Group/Team Management (Demo Team Creation & Management)

• Group Proxy: Group Provider Integration (Demo API Playground)

2

Overview


Session 1: Overview - TopicsSession Topics cont’d

• Virtual Organisations & VO-based Authorisation (Demo VOs & AuthZ)

• OpenSocial Container, Portal & Gadget Integration (Demo Shindig OpenSocial Container, Rave Portal & Etherpad gadget)

• Security, Sustainability & Usability

• OpenConext Roadmap

• Session Wrap-up

3

Overview

Non-third-party-sourced content is under the Creative Commons “Attribution 3.0 Unported” license. This means that you are permitted to freely copy, distribute, display, present, or perform material on the wiki, and create derivative works from it, for either commercial or non-commercial purposes.

http://creativecommons.org/licenses/by/3.0/




4

Federated Authentication & Authorisation Background

Overview


5

Federated Authentication• SAML Federated Identity & Access ‘state of the art’

– Service Providers trust Identity Providers & vice versa (via SAML metadata) – SPs requests user attributes from the user’s IdP (info stored in institution’s identity store)

– IdP delivers according to Attribute Release Policy (ARP), with optional user consent

• E.g. AAF– Metadata– Policy– Info– WAYF

Overview


6

Authorisation Post Federated AuthN• Importance of group-based access for HE&R services

– Research Team access to federated services– VOs for Grid Services– Service licensing, restricted access to commercially sensitive info

• User information used by service for authorisation decision– IdP user attributes

• IdP authoritative & owned, directory schema -> namespace– Team-attributes (Research Teams, Virtual Organisations)

• Team authoritative & owned namespace (URN), bilateral agreement with services– urn:collab:group:biolabs:au:genome-team

– Authorisation Rights (e.g. populated in eduPersonEntitlement)• Service authoritative & owned namespace (URN), delegates authority to issue

– urn:service-x:entitlement:foo

Overview


7

Group-management Systems

http://www.youtube.com/watch?v=kUpn568NSl0&feature=player_embedded

Overview

Source: http://www.switch.ch/aai/support/presentations/installfest-2008/D2-P3-GMT.pdf

Source: http://www.its.hku.hk/services/research/grid/egee/userguide

Source: https://spaces.internet2.edu/display/COmanage/Home

Source: http://www.internet2.edu/products-services/trust-identity-middleware/grouper/

Source: http://www.eresearch.edu.au/docs/280607/James_Dalziel_Alan_Lin_Neil_Witheridge.pdf

Source: SURFnet Source: SURFnet

Source: SURFnet

http://www.youtube.com/watch?v=kUpn568NSl0&feature=player_embedded


8

OpenConext Features

Overview


9

SAMLFed, IdP, SP Integration• Federated authentication of users

Overview


10

SAML Proxy Benefits• OpenConext Engine as an IdP/SP Proxy

– Hub&Spoke -> centralised admin– Potential for attribute aggregation– Enables Services Shopfront

Overview


11

Group Information Retrieval • Authenticated user group information from “Group Providers”• Internal Group Provider “Grouper” + External Group Providers

– Registration of Group Providers = shared credentials

Overview


12

Group/Team Management • Types of Group Providers supported by OpenConext:

– Grouper– OpenSocial

• Group Management via “Teams” (interface to “Grouper”)– Need trust in both Group management side (cf. IdP & institutional idm)

and mechanism for group information retrieval (cf. attribute resolver)– Internet2’s Grouper is comprehensive group management solution

• Hierarchical groups, stems• Advanced delegation of authority to administer

– “stem”: string that forms the leading part of a Group's name

Overview



13

OpenConextArchitecture and Components

Overview


14

OpenConext Architecture Overview



15

OpenConext Components• Application components making up OpenConext

Overview

MockGroup

Provider

APIPlayground

GrouperJavaJANUS


16

OpenConext Installation• OpenConext Repository https://github.com/OpenConext

• Downloading OpenConext from Githubgit clone https://github.com/OpenConext/OpenConext-vm.gitorcurl https://codeload.github.com/OpenConext/OpenConext-vm/tar.gz/master

• Easy OpenConext installation by running installation scripts– Installation and setup will be covered in next session

• Mujina IdP – Installed and pre-configured as IdP in OpenConext– convenient ‘test’ and ‘bootstrap’ IdP’– provides default “admin” user– REST interface provided to create users e.g. “addjane”

Overview

https://github.com/OpenConext

https://github.com/OpenConext

https://github.com/OpenConext/OpenConext-vm.git

https://github.com/OpenConext/OpenConext-vm.git

https://codeload.github.com/OpenConext/OpenConext-vm/tar.gz/master

https://codeload.github.com/OpenConext/OpenConext-vm/tar.gz/master


17

Installed Components• ServiceRegistry

– OpenConext admin user management– SAML Proxy configuration– Adding connections (IdP and SP)

• Manage– OpenConext usage, access to Engine metadata– Adding Group Providers (also to configure test External Group Provider)– Creating VOs (VO-based authZ described later)

• Other tools– Teams (creation and management of Teams) (and Grouper native UI)– API Playground (experiment with Group Info retrieval via “API” component)– Profile (basic identity management)

Overview


18

SAML Proxy:IdP and SP Integration

Overview


19

SAML-Proxy functionality• Engine proxies trusted SPs to trusted IdPs & vice versa

– Trusted IdPs metadata provisioned in Engine SP– Engine IdP metadata provisioned in Trusted SPs

Overview


20

Integration with SAML Fed• OpenConext in the national federation

– Registered as single SP (Engine)• Federation IdPs release attributes to OpenConext Engine• Proxy functionality -> “SP shopfront” or “Super SP”

Overview


21

Attribute Release Policy (ARP)• OpenConext Engine deployed as SP in the National SAML Fed

– Engine SP SAML metadata provisioned in Nat Fed IdPs (& vice versa)

– OpenConext SPs provisioned with Engine IdP SAML metadata (& vice versa)

– Attribute requirements for Engine determine Nat Fed IdPs’ ARP– Attribute req’s for OpenConext SPs determine OpenConext IdP ARP– Only att’s received by Engine SP are available for release by Engine IdP– OpenConext SP requirements configured in Service Registry

Overview


22

SAML Proxy Technology• OpenConext Engine (Corto) & Service Registry (JANUS)

– Reuse of mature technology for SAML proxying, metadata admin– SURFnet responsible for JANUS development

• Corto https://sites.google.com/site/cortopages/

• JANUS http://code.google.com/p/janus-ssp/

Overview

Source: https://sites.google.com/site/cortopages/

Source: https://code.google.com/p/janus-ssp/


23

SAML Proxy: Power & Flexibility

“IdP A” a member of Nat SAML Fed butnot trusting/trusted by OpenConext(i.e. users can’t access “SP 1”, “SP-2”, “SP 3”)

“IdP 1”& “IdP 2” not members of Nat Fed but trusted by OpenConext(i.e. users can’t access “SP A” or “SP B”)

Overview


24

Group/Team Management

Overview


25

Group/Team Management• Groups/Teams

– Groups=Teams in OpenConext– Team types: private, public

• Group Providers– Source of user group information (cf IdP for SAML federation)– Built-in Group Provider: Internet2’s “Grouper”

• OpenConext groups/teams are flat– External Group Providers can be integrated

• Types of Group Provider: Grouper, OpenSocial• OpenConext “Teams” service, a GUI for Grouper

– Provision of GUI for External Group Providers ?

Overview



26

Team creation and admin• “Teams” provides for secure team creation and administration

– Delegation of responsibilities for team administration• User role requirements for team creation• Email workflow

– User added to team at manager’s invitation– User added to team at user’s request

• Adding Groups to Teams– tbd

• Using the Grouper GUI directly– Significance of ‘stem’

Overview


27

Group ProxyGroup Provider Integration

( for Group Information Retrieval)

Overview


28

Group Proxy Functionality• “API” component acts as Proxy to Group Providers for SPs

Overview


29

VOOT Protocol • From SP perspective, requests are issued via VOOT protocol• Retrieval of group and person information

– Standardised REST API based on OpenSocial Social API• Subset of OpenSocial + {voot_membership_role} attributes

• Supported Requests:– Information about authenticated user /people/@me– List of groups the user is a member of /groups/@me– List of people that are members of the user’s group /people/@me/<groupId>– OAuth 2.0 and OAuth 1.0a (for legacy SPs) authentication supported

Overview


30

VOOT Request/Response e.g.GET /groups/@me?sortBy=title HTTP/1.1

HTTP/1.1 200 OKContent-Type: application/json{ "entry": [ { "description": "Group containing employees.", "id": "employees", "title": "Employees", "voot_membership_role": "admin" }, { "description": "Group containing everyone at this institute.", "id": "members", "title": "Members", "voot_membership_role": "member" } ], "itemsPerPage": 2, "startIndex": "0", "totalResults": 2}

Overview



31

OAuth Authentication• OAuth v2.0, Authorisation Code Grant

Source (reproduced in): http://www.bubblecode.net/en/2013/03/10/understanding-oauth2/


32

API Playground• OpenConext provides an ‘API playground’ for testing OAuth/VOOT calls• OAuth actors

– Resource, Resource Owner, Resource Server, Client, Authorisation Server• OAuth security

– Client Registration with Authorisation Server (consumer key, secret) – Reliance on TLS (i.e. use of https) in requests to service end-points

• API Playground OAuth protocols supported– Version 1.0a 3-legged, 2-legged– Version 2.0 Authorization Code Grant, Implicit Grant

• API Playground workflow– OAuth Settings– Authorisation Request– API Request (changing the API Request to explore different VOOT requests)

Overview


33

OverviewPutting it together: SAML + Group Proxy


34

Virtual Organisations and

VO-based Authorisation

Overview


35

VO’s and VO-based AuthZ• In OpenConext, a Virtual Organisation is an group aggregator

– Defined in terms of groups, IdPs and stems• Creating a VO

– “Manage” component provides for VO creation– Types of VO: group(s), IdP(s), group(s)+IdP(s), stem

• Access to resources based on VO membership– Authorisation built into OpenConext engine– VO-based authorisation by virtue of Engine SAML IdP metadata

• Generate Engine IdP SAML metadata with VO suffix vo:<voName>• Provision protected SP with Engine IdP metadata• Only members of the VO (Groups, IdPs, stem) can access the service

Overview


36

VO-Based Authorisation Overview


37

OpenSocial Container, Portal and Gadget integration

Overview


38

JISC Conext / Jacson• Uptake of OpenConext by JISC

– Development of JISC Conext / Jacson (initially for JISCmail)• Integration of OpenSocial Container & Portal in OpenConext

– Initially intended to be an integral part of OpenConext• OpenSocial Container – Apache Shindig• OpenSocial Portal – Apache Rave

– OpenSocial Gadgets – e.g. Etherpad• Federated Authentication and Group Information retrieval

• Uptake of OpenSocial technology.– Key value of OpenSocial Portal infrastructure such as “Jacson”

• Potential for Australian HE&R Service Providers?

Overview


39

Security, Sustainability and Ease-of Use

Overview


40

OpenConext Security• OpenConext Security Mechanisms

– SAML Proxy related, Group Proxy related (OpenSocial API)• OpenConext Security

– Analysis undertaken of SURFconext components by 3rd party• Australian HE&R focus on Group Information Retrieval

– VOOT/OAuth security• reliance on TLS

– Considerable work on Oauth Security undertaken• http://tools.ietf.org/html/draft-ietf-oauth-v2-threatmodel-01• Security Analysis of Double redirection protocols http://

pomcor.com/techreports/DoubleRedirection.pdf

Overview

http://tools.ietf.org/html/draft-ietf-oauth-v2-threatmodel-01

http://tools.ietf.org/html/draft-ietf-oauth-v2-threatmodel-01

http://pomcor.com/techreports/DoubleRedirection.pdf

http://pomcor.com/techreports/DoubleRedirection.pdf


41

OpenConext Sustainability• Continuing use for The Netherland’s National SAML Federation• Global uptake & collaboration (e.g. in deploying, documenting)

JISC Internet2

Overview

Source: http://conext.jiscconext.org.uk/cgi-bin/greeting?instanceID=1 Source: https://spaces.internet2.edu/download/attachments/10732/2012-COmanage-info-rev.pdf


42

Ease of Use• Deployment

– Open Source, supported, growing development & user community, maillists– Focus on documentation, ease of installation

• Development– OpenSocial / OAuth Client libraries available for most languages

• Java (e.g. Scribe)• PHP (e.g. zend_oauth)• Python (e.g. rauth)

• Workshops & conferences– Active topic at technical conferences– Workshops being created & delivered

Overview


43

OpenConext Roadmap

Overview


44

OpenConext Roadmap• Niels van Dijk to describe current priorities and future plan for

OpenConext development• Also (depending on time) report on

– Global Uptake– Documentation effort– Commitment of SURFnet to support for global uptake– Keeping informed and contributing to development

Overview


45

Wrapping Up, Questions ?

[email protected]

[email protected]

Overview

mailto:[email protected]

mailto:[email protected]


46

Preparation for Session 2• Session 2 to go into technical detail, building on Session 1

– SP development work will be undertaken during afternoon sessions• Preparation for Session 2:

– Preparation section• Confirm connectivity• Virtual Machines

– Assigned to participants – add initials on VM list to reserve– Note IP address, domain name– Username and password on whiteboard– Access via SSH

Overview

AARNet Copyright 2013 Network Operations OpenConext Workshop Down-Under Enabling Federated Team...

Documents

Transcript of AARNet Copyright 2013 Network Operations OpenConext Workshop Down-Under Enabling Federated Team...