Sorry, my design patterns might have been a little too light on detail. Here are "user stories" that go with them:
I hope that last one is clear. I see now how Adrian and I might have been confusing each other.


Eve Maler
Cell +1 425.345.6756 | Skype: xmlgrrl | Twitter: @xmlgrrl


On Mon, Feb 15, 2016 at 8:21 PM, Eve Maler <eve@xmlgrrl.com> wrote:
Below...


Eve Maler
Cell +1 425.345.6756 | Skype: xmlgrrl | Twitter: @xmlgrrl


On Fri, Feb 12, 2016 at 2:56 PM, Adrian Gropper <agropper@healthurl.com> wrote:
- Definitions:

Resource Registration Agreement - A contract between the Resource Server Operator and the resource subject or authorized agent of the resource subject that defines a resource pertaining to the resource subject, including available and supported scopes, and delegates some control over that resource to an Authorization Server. The Resource Registration Agreement establishes Phase 1 of the UMA Protocol at a time when neither the Client nor the Requesting Party are known to either the RS / RSO or the AS / ASO. As such, this is equivalent to a typical healthcare ROI form if the ROI form were to specify an agent for the subject instead of the client for for the purpose of authorized access to the resource.

This looks just about exactly like what we've been categorizing as the Resource Server Operator's aggregate set of obligations to the Authorizing Party so far, both in the old Binding Obligations spec (where the latest possible "tripping event" was PAT issuance) and in our nascent model clause work, with one big clarification. We've been saying that the RSO would make these promises generically to the Authorizing Party. You're suggesting that the Authorizing Party explicitly needs to either be the Resource Subject or acting on their behalf.

(Did you mean to say "an agent for the subject instead of the subject"? Otherwise, I'm confused.)

(I think you're overcooking some of the details here, btw. Phase 1 is certainly before a client or requesting party is required to be in the picture, technically speaking, but of course Clients and Requesting Parties may already be known to these other parties.)

(You are using "Resource Subject" below to mean something equivalent to "Data Subject" or "PII Subject", but haven't defined it apart from a longer term. Do we care which we use? What is going to be friendlier to the purposes of our customers? If it's six of one and half a dozen of another, it might actually be easiest to use this third-way term, because we can use it freely in our own UMA-related definitions, and then define the term by referencing the other two terms of art, mentioning their standards origin -- in other words, have as clean an interface between the UMA terminology world and the "outside" terminology world as possible. So for now, I've stuck with Resource Subject.)
 
Authorization Server Endpoint - The URI and associated .well_known endpoints of a standards-based authorization server acting as the agent of the resource subject during UMA Phase 2. Under this Resource Registration Agreement, the RSO agrees to consider a token signed by the AS as presented by the RqP / Client. The RS may either accept the token or it can notify the AS that the token was not accepted or modified in scope.

The endpoint description goes off the rails technically here, a bit. I don't think it's too useful to define technical stuff in a legal discussion; more important to focus on the legal distinctions. Here is the question I have regarding your ROI form concerns:
  • Are you proposing that a different Person interact with the authorization server and the resource server, so that one can be the Authorizing Party and the other can be the Resource Subject, respectively? 
Resource Subject Signature and Date - The individual who's PII is accessed via the resource. This individual could be any age and should not need to be able to read or write or use technology. 

And here's the next question I have regarding your ROI form concerns:
  • What if the Resource Subject does not have legal capacity to sign and date a form? (aha, but I think I see where you're going in the next step...)
Authorized Agent Name, Signature and Date - The individual that the RSO recognizes as an authorized agent of the resource subject in cases where the resource subject is unable to sign for herself. The basis of this recognition is completely out of band from UMA. 
  • So if the Resource Subject does not have legal capacity, then the you're saying the Authorized Agent would become the Authorizing Party on their behalf. I agree that the basis of this recognition is a BLT thing and not part of UMA-the-protocol. 

- Is this UMA?

In my subject-centered vision of UMA, the RS has no visibility into whether the Resource Subject or the Authorized Agent or anyone else is in control of the Authorization Server Endpoint. In Phase 2 or 3 of UMA, the RS can choose to take attributes of the Client and RqP into consideration along with the Token issues by the AS or the RS can accept the token as is. If the RS changes the intent of the token, either more or fewer privileges, then the RS must notify the AS of the change.

It may be that my subject-centered vision of UMA is not actually UMA. I don't know. If it's not, then we should try to give it a name because all I'm talking about is the subject's right to specify an agent by executing a Resource Registration Agreement - period.

UMA-the-protocol does not care whether the resources being protected even contain PII. :-) The resources could be sensitive by virtue of being valuable (someone wants to charge for them or someone considers them trade secrets, or whatever). But if they are both sensitive and personal, we have treated it as an important UMA use case -- if not the only UMA use case -- that the resource owner/Authorizing Party is the Resource Subject. So it's a very very good idea for our work in this subgroup to focus first and foremost on model definitions and model clauses that get this right.

This discussion is helping me get some of the use cases (or are they UMA design patterns?) swirling in my head into some kind of order. Let me try them in the attached graphic.... I've highlighted a few technical challenges there. We also have some legal definitional challenges remaining, like maybe: Authorizing Party Agent? What else?
 
Adrian

--

Adrian Gropper MD

PROTECT YOUR FUTURE - RESTORE Health Privacy!
HELP us fight for the right to control personal health data.

DONATE: http://patientprivacyrights.org/donate-2/

_______________________________________________
WG-UMA mailing list
WG-UMA@kantarainitiative.org
http://kantarainitiative.org/mailman/listinfo/wg-uma