November 2016 - WG-UMA - mailman.kantarainitiative.org

Agenda for UMA telecon 2016-11-10
by Eve Maler 09 Nov '16

09 Nov '16

http://kantarainitiative.org/confluence/display/uma/UMA+telecon+2016-11-10 Date and Time - *Thursdays,* 9-10am PT - Skype: +99051000000481 / US +1-805-309-2350 / international lines <https://www.turbobridge.com/join.html> / web calling interface <https://panel.turbobridge.com/webcall/> / code 1782540 - Screen sharing: http://join.me/findthomas - NOTE: do not use the join.me dial-in line - UMA calendar: http://kantarainitiative.org/confluence/display/uma/Calendar Agenda - Roll call - Approve minutes of UMA telecon 2016-10-13 <http://kantarainitiative.org/confluence/display/uma/UMA+telecon+2016-10-13> , 2016-11-03 <http://kantarainitiative.org/confluence/display/uma/UMA+telecon+2016-11-03> - Logistics for upcoming meetings (calendar <http://kantarainitiative.org/confluence/display/uma/Calendar>) and 2016 roadmap <http://kantarainitiative.org/confluence/display/uma/UMA+Roadmap+for+2016> check-in - Next week: *WG meeting on Fri Nov 18* at 9am PT after legal call instead of Thu Nov 17 - Week after: *no WG or legal meeting* due to US holiday - Work on UMA.next issues – Core is up to 06 <https://docs.kantarainitiative.org/uma/ed/uma-core-2.0-06.html> and should be up to 07 well before the meeting – please review changes ahead of time if possible - The following changes affect syntax: - Removed config data to declare pat and rpt profiles supported (as agreed last time) - requesting party claims endpoint --> claims interaction endpoint (language that affects syntax in endpoint config data ) - resource set --> resource (language that affects syntax in endpoint config data and token introspection returned object format) - New AS-to-client invalid_scope error (because a client can now ask for scopes) To discuss specifically this time: - Set math: See 9-29 <http://kantarainitiative.org/confluence/display/uma/UMA+telecon+2016-09-29> and 10-6 <http://kantarainitiative.org/confluence/display/uma/UMA+telecon+2016-10-06>, and the email thread <https://groups.google.com/forum/#!searchin/kantara-initiative-uma-wg/though…> – including... - What scopes should the client ask for, *and why*? (E.g., least-privilege rationale.) What should the mechanism be for asking for scopes for specific protected resources? - What permissions should the RS request on behalf of the client, *and why*? - pat_grant_types_supported: My proposal <https://groups.google.com/forum/#!topic/kantara-initiative-uma-wg/GVnuVMnoX…> was to remove it. Any further discussion? - claim_token_profiles_supported: My proposal <https://groups.google.com/forum/#!topic/kantara-initiative-uma-wg/GVnuVMnoX…> was to keep this profiling mechanism, but clean it up and provide two actual profiles or at least credible examples, say, for OIDC ID tokens and SAML assertions. Discussion? - uma_profiles_supported: My proposal <https://groups.google.com/forum/#!topic/kantara-initiative-uma-wg/GVnuVMnoX…> was to keep this profiling mechanism, but figure out seriously if the extensibility profiles are doing the right job, and include credible examples of extensions and not just extensibility profiles. Discussion? - Is step-up auth the way it was conceived in UMA1 hunky dory according to the claims collection mechanism in UMA2? - Is the (client) registration endpoint's name correct according to the naming pattern used in UMA, and also OAuth and OIDC? - See the latest swimlane <http://www.websequencediagrams.com/files/render?link=Pu0sP0Oe2kjKc2WgdKZd> - AOB *Eve Maler*Cell +1 425.345.6756 | Skype: xmlgrrl | Twitter: @xmlgrrl

1 0

UMA Authorization process flow (diagram)
by Domenico Catalano 07 Nov '16

07 Nov '16

Hi all, attached a new version of the authorization process flow, using a business process formalism, hoping it’s more accurate. Any comment? Thanks Domenico

1 0

Thoughts on resource set scope "math"
by George Fletcher 06 Nov '16

06 Nov '16

Assumptions: 1. In UMA, scopes are really "per user" rather than per API. Now it is unlikely, and not encouraged, that an RS would produce an API where the scopes are really unique to each user. In most cases it is more likely that the RS will have a set of defined scopes that work across their entire API and hence across all registered resources. 2. For any given resource set, a subset of the full list of the scopes supported by the RS may be registered. Sets of scopes as identified in the meeting notes from 2016-06-02 [1] 1. The universe of scopes the RS has registered for the resource set 2. The scopes the client has registered for at the AS (if it has done this at all) 1. Note that I would add to this that this list of scopes should rather be the list of scopes the AS has determined the client is allowed to request 3. What the RO has attached to the policy for the resource set 4. What the RS requests for at the permission endpoint (in order to get a ticket) 5. The scopes the client requests at the token endpoint Possible algorithm for determining the set of scopes to be issued with a permissions ticket. * The max possible set of scopes that could be returned from the /token endpoint when requesting a token is the "universe of scopes the RS has registered for the resource set" identified by the permissions-ticket * The allowed set of scopes that can be issued by the UMA AS is the INTERSECTION of "universe of scopes [#1]" and the scopes allowed by the RO policy for that resource set [#3]. Let's give this resulting set a number of [#6] {allowed scopes for the resource set} * The list of scopes requested by the client is determined by the INTERSECTION of [#2] and [#5]. Let's give this resulting set a number of [#7] {scopes the client is allowed to request} * The set of requested scopes is the UNION of set [#7] and set [#4]. Let's give this resulting set a number of [#8]. * The max scopes that can be allowed for this access_token request is the INTERSECTION of set [#6] and set [#8]. Mapping this to pseudo-code: Set PossibleScopes = RegisteredResourceSetScopes INTERSECTION ROAllowedScopes Set ClientScopes = ASAllowedClientScopes INTERSECTION ClientRequestedScopes Set RequestedScopes = ClientScopes UNION PermissionTicketScopes Set AllowedScopes = PossibleScopes UNION RequestedScopes Thanks, George [1] https://kantarainitiative.org/confluence/display/uma/UMA+telecon+2016-06-02

5 6

AS configuration data "*supported" properties
by Eve Maler 04 Nov '16

04 Nov '16

https://docs.kantarainitiative.org/uma/ed/uma-core-2.0-06.html#am-endpoints We decided in yesterday's call to remove the following properties entirely: *pat_profiles_supported*: TO BE REMOVED in rev 07 *rpt_profiles_supported*: TO BE REMOVED in rev 07 We agreed to discuss what to do about the others, on the principle that defining extensibility points when there's only a single exemplar of a usage of the extensibility point is not a good enough rationale for it. *pat_grant_types_supported*: REMOVE OR KEEP? The OAuth Metadata spec <https://tools.ietf.org/html/draft-ietf-oauth-discovery-04#section-2> defines an optional grant_types_supported property. We could say that since a PAT is an ordinary OAuth access token, an UMA AS could simply leverage OAuth AS metadata in the usual way and use this property if it wants to (or not say anything at all, since a PAT is 100% purebred OAuth). *Proposal*: Remove. *claim_token_profiles_supported*: REMOVE OR KEEP? This ties to Sec 3.6.1 <https://docs.kantarainitiative.org/uma/ed/uma-core-2.0-06.html#claim-push>. We don't define any claim token profiles ourselves, but -- perhaps dangerously -- provide an example of a format called " http://openid.net/specs/openid-connect-core-1_0.html#HybridIDToken", by which we loosely meant OIDC built-in plus extension claims. I know several UMA implementations have included this, but I have no idea if they're interoperable. *Proposal*: Keep, but seriously clean up the language around HybridIDToken, and possibly supply a couple of real profiles for the obvious ID tokens people would want (canvass implementers for interest in which kinds of tokens). *uma_profiles_supported*: REMOVE OR KEEP? This ties to both Sec 5 <https://docs.kantarainitiative.org/uma/ed/uma-core-2.0-06.html#comms-profil…> (*extensibility* profiles already defined in the spec, with the intention that various communities would hopefully define *extension* profiles on top of them) and Sec 6 (UMA's framework for third parties to build profiles and extensions, based on SAML's similar one). Since the AS has config data, and right now the RS and client don't really (I guess there's software statements too), there's a bit of a hole regarding what profiles and extensions can formally be expressed. *Proposal*: Keep. Canvass implementers for interest in the extensibility profiles. Ensure that Sec 6 fully includes extensions as well as profiles in its language. Consider whether there's anything to say about software statements, and anything forward-looking to add about other "authorization metadata/config framework" efforts going on. *Eve Maler*Cell +1 425.345.6756 | Skype: xmlgrrl | Twitter: @xmlgrrl

1 0

Upcoming changes to WG and legal subgroup meetings in November
by Eve Maler 03 Nov '16

03 Nov '16

(The legal subgroup is meeting tomorrow as usual; I just sent out the agenda.) NEXT WEEK: The WG is MEETING AS USUAL on Thu Nov 10. Sorry I didn't mention this on today's call, but I needed to CANCEL the legal subgroup meeting for Fri Nov 11. WEEK OF NOV 14: Our Thu Nov 17 WG meeting is MOVED to 9am PT (usual hour) Fri Nov 18. The legal subgroup is meeting as usual on Fri Nov 18 at 8am (just before the moved WG meeting). WEEK OF NOV 21: The WG is NOT MEETING Thu Nov 24 and the legal subgroup is NOT MEETING Fri Nov 25 because of the US Thanksgiving holiday. I've just made these changes in the online calendar <http://kantarainitiative.org/confluence/display/uma/Calendar>. If you're not already subscribed, it's a good idea to do so. *Eve Maler*Cell +1 425.345.6756 | Skype: xmlgrrl | Twitter: @xmlgrrl

1 0

Agenda for UMA legal telecon 2016-11-04
by Eve Maler 03 Nov '16

03 Nov '16

http://kantarainitiative.org/confluence/display/uma/UMA+legal+subgroup+note… Date and Time - *Fridays,* 8-9am PT - Voice: Skype: +99051000000481 / US +1-805-309-2350 / international lines <https://www.turbobridge.com/join.html> / web interface <https://panel.turbobridge.com/webcall/>, code 178-2540# - Screen sharing: http://join.me/findthomas – NOTE: do not use the join.me dial-in line - UMA calendar: http://kantarainitiative.org/confluence/display/uma/Calendar 2016-11-04 - Review <https://groups.google.com/forum/#!topic/kantara-initiative-uma-wg/rx7yh92Jp…> draft UMA Legal mission statement (and Jim comments), wordsmith, and decide - Review current use cases and plan for building up new ones Attending: ... *Eve Maler*Cell +1 425.345.6756 | Skype: xmlgrrl | Twitter: @xmlgrrl

1 0

Draft minutes of UMA telecon 2016-11-03
by Eve Maler 03 Nov '16

03 Nov '16

http://kantarainitiative.org/confluence/display/uma/UMA+telecon+2016-11-03 MinutesRoll call Quorum was reached. Logistics *We're ON for Thu Nov 10* – regrets from Justin, Andi is unsure. We need to *MOVE our Thu Nov 17 meeting to 9am (usual hour) Fri Nov 18* – regrets from Cigdem, Domenico. We're *NOT MEETING Thu Nov 24 or Fri Nov 25* because of the US Thanksgiving holiday. Approve minutes Approve minutes of UMA telecon 2016-10-13 <http://kantarainitiative.org/confluence/display/uma/UMA+telecon+2016-10-13>: Deferred. Work on UMA.next issues "Authorization process": The definition could potentially be improved by breaking the first sentence into two. The second sentence could focus on risk management. Can we define "trust" formally somehow as managing risk? Do we need "trust elevation" anymore? This is a live thread in email. Is the equation "The RO only authorizes access within their risk appetite/tolerance"? Maybe this is where we could point off to the UMA Legal work because it's a complex equation and the RO isn't the only party with risk and liability. Robert notes that part of decision is how you make a good decision. A technical spec's job isn't to describe *all* of this, but it could point off to other resources that go into it. "Authorization process: The process through which the client obtains an RPT from the authorization server in order to access a protected resource. The process has two activities, and these can iterate. One activity is assessing claims and other contextual factors against the resource owner's policy conditions. Another is is collecting claims, which can include both claims pushed from a client and interactively gathered from a requesting party. Suggestion to Domenico for his new flowchart: Try switching input and actor bands, and adding an actor so there's always two. Let's be sure that it's "technically accurate" as much as possible, assuming developers will take it seriously. Andi suggests it will be used more "generically", so maybe we can use it more at a 50K foot level. Regarding "token profiling goes poof": Medication/read 22354546 read Regarding the "*supported" options in the config data: Both Justin's and Cigdem's implementations implement and ignore them! Is there any dissent to pulling pat_profiles_supported and rpt_profiles_supported? Instructions: - Sec 3.5.4: "The fifth error response, need_info, begins *or continues* ..." - Redefine "authorization process" through as two activities/states, and be sure to incorporate "client identity" and any other contextual factors (we used to call this "RqP-independent"). - Undo the "token profiling goes poof" and reconstitute the actual introspection response part; make use of 7662 mandatory. - Remove pat_profiles_supported and rpt_profiles_supported *AI:* Eve: Send separate email threads about all the other "*supported" config data fields and rationales pro and con. Attendees As of 3 Oct 2016, quorum is 6 of 11. (Domenico, Sal, Nagesh, Andi, Robert, Maciej, Eve, Jeffrey, Mike, Cigdem, Sarah) 1. Domenico 2. Nagesh 3. Andi 4. Robert 5. Maciej 6. Eve 7. Cigdem 8. Sarah Non-voting participants: - Justin - Francois - Kathleen *Eve Maler*Cell +1 425.345.6756 | Skype: xmlgrrl | Twitter: @xmlgrrl

1 0

Reminder: UK and Europe have changed clocks, US hasn't
by Eve Maler 03 Nov '16

03 Nov '16

What this means for our call times this week, since US Pacific is normative for us, is that the WG and legal calls will be one hour earlier than usual for those in the UK and Europe. The "summertime skew" should right itself next week. If you have any questions, subscribing to the online calendar <http://kantarainitiative.org/confluence/display/uma/Calendar> should answer them. *Eve Maler*Cell +1 425.345.6756 | Skype: xmlgrrl | Twitter: @xmlgrrl

1 0

Proposal for revised UMA Legal mission statement
by Eve Maler 02 Nov '16

02 Nov '16

Completing my action item. Please let me know what you think! Current mission statement(s) <http://kantarainitiative.org/confluence/display/uma/UMA+Legal> Recent discussion on this point <http://kantarainitiative.org/confluence/display/uma/UMA+legal+subgroup+note…> - Produce a set of toolkits and associated educational materials by the end of 2017 whose purpose is to accelerate the ability of those in the following roles to adopt, deploy, and use UMA-enabled services in a manner consistent with UMA's charter <http://kantarainitiative.org/confluence/display/uma/Charter>*, particularly where the resource owner is an individual: - Individuals themselves ("natural persons") - Organizations ("legal persons" such as businesses and governments) - Legal representatives of the above - Focus on GDPR-related toolkits first and foremost. A toolkit could be anything that helps use or leverage an existing piece of legislation or framework, such as an SDK, a checklist, consent receipt templates or profiles, or a set of CommonAccord text, and could be related to the GDPR itself, the EU-U.S. Privacy Shield, BCRs, and so on. - Develop a roadmap by the end of 2016 that identifies specific deliverables and timelines within 2017. - By the end of 2016, develop two initial deliverables to inform the roadmap work: - Comparative analysis of UMA and GDPR concepts such as data subject, processor, and controller - Roundup of contractual and regulatory use cases - Leverage specialist legal expertise wherever possible to complete and review the deliverables. *What I mean here, specifically, is: "enable a resource owner to control the authorization of data sharing and other protected-resource access made between online services on the owner’s behalf or with the owner’s authorization by an autonomous requesting party" *Eve Maler*Cell +1 425.345.6756 | Skype: xmlgrrl | Twitter: @xmlgrrl

2 1

Agenda for UMA telecon 2016-11-03
by Eve Maler 01 Nov '16

01 Nov '16

http://kantarainitiative.org/confluence/display/uma/UMA+telecon+2016-11-03 Date and Time - *Thursdays,* 9-10am PT - Skype: +99051000000481 / US +1-805-309-2350 / international lines <https://www.turbobridge.com/join.html> / web calling interface <https://panel.turbobridge.com/webcall/> / code 1782540 - Screen sharing: http://join.me/findthomas - NOTE: do not use the join.me dial-in line - UMA calendar: http://kantarainitiative.org/confluence/display/uma/Calendar Agenda - Roll call - Approve minutes of UMA telecon 2016-10-13 <http://kantarainitiative.org/confluence/display/uma/UMA+telecon+2016-10-13> - Logistics for upcoming meetings (calendar <http://kantarainitiative.org/confluence/display/uma/Calendar>) and 2016 roadmap <http://kantarainitiative.org/confluence/display/uma/UMA+Roadmap+for+2016> check-in - Meta-discussion: Did anything come up at IIW that we *need* to discuss before/during working on UMA.next issues? - Work on UMA.next issues – Core is up to 06 <https://docs.kantarainitiative.org/uma/ed/uma-core-2.0-06.html> – please review changes <https://github.com/KantaraInitiative/wg-uma/commits/06-edits> ahead of time! – comments in commits link directly to relevant sections in formatted spec - Claims redirection URI language change <https://github.com/KantaraInitiative/wg-uma/commit/b68fed44b33e63265cd1ad5f…> – no discussion unless someone raises a hand - Requesting party claims endpoint option 2: two commits (1 <https://github.com/KantaraInitiative/wg-uma/commit/da255cdb5f719b6ab6b9022f…> , 2 <https://github.com/KantaraInitiative/wg-uma/commit/fc407b420a2c899b81ced965…>) – no discussion unless someone raises a hand - "Authorization process" concept and logic <https://github.com/KantaraInitiative/wg-uma/commit/faf4c903b9b39c81f3a74ff2…> - Token profiling goes poof <https://github.com/KantaraInitiative/wg-uma/commit/48c61b999c9b0ab358102ddc…> – some questions that need discussing - Domenico's latest diagrams - See the up-to-date swimlane <http://www.websequencediagrams.com/files/render?link=Pu0sP0Oe2kjKc2WgdKZd> - Set math: See 9-29 <http://kantarainitiative.org/confluence/display/uma/UMA+telecon+2016-09-29> and 10-6 <http://kantarainitiative.org/confluence/display/uma/UMA+telecon+2016-10-06> - Identify any other parts of the spec that are known to need attending to - AOB *Eve Maler*Cell +1 425.345.6756 | Skype: xmlgrrl | Twitter: @xmlgrrl

1 0