View source for Consent to Create Binding

==Full Title==

The definition of a message to carry initial consent from a subject to any digital Service Provider.

===Goals===
* The high level goal is the establishment and maintenance of a relationship (binding) between the subject and one organization.
* The immediate goal is for the subject to receive a consent receipt and authorization in response to this message which meets the security requirements of the intended purpose.
* Ensure solid binding to a secured user's key by requiring user to have private components of the key well secured before this message is created.
* For healthcare the intended purpose is to bind the subject to the identity proofing document (IAL2) and validate the user agent as being in compliance with any health care regulation or code of conduct (AAL2).
* The long term goal is that no website would be permitted to retain any user information without first receiving a signed consent form like the included.

===Scope===
* This specification applies only to websites that have determined that they need to acquire explicit consent from individuals.
* It is just the first interaction to create user context within the larger user experience of consent management of the user with some digital entity.

===Status===
* This page is a work in process towards a work item proposal.
* The Kantara [https://kantarainitiative.org/confluence/display/WT/Draft+Recommendations Distributed Assurance Specification] is a draft proposed specification that includes a consent to create a binding with a Credential Service Provider.

===Justification===

# User consent only matters where there is an ongoing relationship between two entities.
## Ongoing could be only for the duration of a session, but all current IDEF profiles use cases are longer than that.
## The penultimate relationship in the digital age is between a user's agent and a web site - that is the one addressed in all current IDEF profiles.
# Before the user user (via their agent) consents to sharing, the web site MUST display credentials of its own so the user can understand the identity of it (in the full meaning of identity)
##  this is a brand relationship (as opposed to a legal entity identity) for all of the users that are targeted by IDEF profiles.
# [[Consent to Create Binding]] (registration of a user) is required before meaningful consent can be given, because it is only after registration that the user can expect to receive notification from the web site.
## Governmental  legal notices could side step this requirement, but that is really ineffectual from a user's perspective.
# The first and mandatory consent granted by the user during registration is some sort of (1) identifier (2) authentication method and (3) email or sms phone number. (these could all be pseudonymous).
## Often other claims are requested by the web site during registration, these other claims should be in accord with legal regulations.
# Once a relationship is established other claims can be requested by the web site, and optionally granted by the user via the agent. It is this stage that most other specifications address.
## claims MUST be user directed rather than legal directed, which seems to be consonant with the spirit of the GDPR and other privacy regulations that discuss usability.

==Context==
In an environment where a subject is requesting the establishment of a binding between it's private key and a Provider of any identifier services, the implicit assumption has been that the action of the subject on the website is sufficient. In today's world of gathering a subject's most private information some better means of capturing subject consent is urgently needed.

Note that the first use case for this message is in the [[Health Care Profile]].
===Existing Methods===
# While it is true that methods exist for individual subjects to acquire a certificate for signing emails and receiving encrypted email, the adoption of that method outside of th enterprise is essentially failed and will not be considered as a paradigm for this effort.
# The most common request today is for an SSL or EV certificate from a Certificate Authority (CA) which works reasonably well for what it is intended to do. While it is possible to set up a CA of your own, we will address the more common case of a CA that has been approved by the major browser vendors. Before the process begins the user selects a Distinguished Name for the site based on the rules established by the CA/B forum.
# A CSR is an encoded file that provides you with a standardized way to send the Certificate Authority your public key as well as some information that identifies your company and domain name. When you generate a CSR, most server software asks for the following information: common name (e.g., www.example.com), organization name and location (country, state/province, city/town), key type (typically RSA), and key size (2048-bit minimum).

===NIST levels of Assurance===
* [https://pages.nist.gov/800-63-3/ The NIST 800-63-3 document site]
* [https://tcwiki.azurewebsites.net/index.php?title=Assurance Levels of assurance from NIST 800-63-3 are described here]

===External Definitions used here===
* Credential Service Provider (NIST) = A trusted entity that issues or '''registers subscriber authenticators''' and '''issues electronic credentials to subscribers'''. A CSP may be an independent third party or issue credentials for its own use. While the CSP is expected to assure the identity of the subject, this page assumes that the identity proofing occurs in a separate service. In these respects the CSP is simply viewed as a function with the physical realization and co-location of services being entirely up to the implementation.

==Problems==
*Exploits against highly sensitive or valuable content on the web. (aka ex-filtration of valuable content hosted on a web server.)
===Use Cases===
* [[Remote Attestation Use Case]] shows the steps that a user can follow to use the [[Phone as Health Care Credential]] with a NIST AAL2 (authentication assurance level 2).

==Solution==
This particular use case relates to the interchange between the subject and a trust authority. A similar interchange would be used between the subject and a relying party.
===Registration Ceremony===
* A part of establishing an enduring relationship between two entities on the web requires that each be known to the other is some meaningful sense. In the case of the website, there are multiple solutions which started with HTTPS and are currently undergoing  a process of improvement. In the case of the user the needs for identification and authentication proofing vary substantially based on the context. One of the level two assurancances is defined in the companion [https://kantarainitiative.org/confluence/display/WT/Draft+Recommendations Distribute Assurance Specification].
* At the end of the registration ceremony it is expected that a notification channel will be open from the website to the user to meet the requirements of the GDPR or CCPR.

===Consent to Create Binding Request===
The following is the current understanding of what needs to be included in a Consent for Binding Request. This set of requirements can be met by the format of the [[OpenID Connect 1.0]] id_token. The security considerations might be somewhat different than that spec. Also the id_token is viewed as the final step of an authentication interchange, which this message includes a request for a response from the target.
#Identifier of the message<blockquote>Protocol dependent - may have message identifier, version number, unique sequence number, nonce or state.</blockquote>
#Issuer (aka Organization or Audience)<blockquote>MANDATORY - URI OF the CSP (Audience of the request). This would be the entity that supplies a public key when encryption is required.</blockquote>
#Subject (aka Grantor)<blockquote>MANDATORY - this is the identifier from the user that will be the subject of the binding. It serves nearly the same purpose as the the DN of the X.509 certificate. Whether this subject identifier is to be bound to a real world entity (like a human being) is to be determined by the purposes to which the resulting entity statement will be put.</blockquote>
#Subject Role<blockquote>MANDATORY - this is the relationship between the subject and the owner of the information (e.g. patient). Typically will be self or guardian.</blockquote>
#Context (aka trust_framework, may be multiple)<blockquote>MANDATORY - The trust authority that establishes the context.</blockquote>
#Subject Attributes (aka Claims about Contact and other information)<blockquote>OPTIONAL - although a contact email or mobile number might be a requirement during registration for notices.</blockquote>
#Grants<blockquote>MANDATORY - applies to above subject information. This is purely opt-in. No reference denotes no consent. Note that the attributes granted may be part of this message or may be included by reference with an Authorization Code for access.</blockquote>
#Device Statement<blockquote>MANDATORY for AAL2 and higher certifications. It is used by the Issuer to verify the level of protection provided to the Private key of the certificate.</blockquote>
#Identity Proof<blockquote>MANDATORY - although this request might pass responsibility for proofing to the CSP if it is willing and able to provide proofing for the subject. The content of the proof might need to meet specific requirements in IAL2 and higher assurance credentials. This is an array so that more than one proofing document may be included. Note that the legal jurisdiction or address of the subject identifier may be part of this structure. Note that a request for proof that the user is not a robot (CAPTCHA or equal) would fall into this category. "None" would be an acceptable value for the element.</blockquote>
#Purpose of Use (aka reason)<blockquote>MANDATORY for any level of assurance greater than level one in any of the 3 categories of assurance.</blockquote>
#ACR<blockquote>OPTIONAL - this is only useful in the case where the Purpose is not adequate to establish the required levels of assurance of the resulting Entity Statement. </blockquote>
#Issue Date<blockquote>MANDATORY - Linux epoch date is default</blockquote>
#Expiration Date<blockquote>OPTIONAL - Linux epoch date is default</blockquote>
#Subject Public Key<blockquote>MANDATORY - must be included directly or by reference.</blockquote>
#Signature<blockquote>MANDATORY - using the above key.</blockquote>
#Encryption<blockquote>MANDATORY??? - Note that the above items are all a part of the JWS - or signed JWT. Encryption exists above this JWS content and may include multiple JWT elements in a JSON object.</blockquote>

===Consent Receipt with Binding===
The Binding can consist of any sort of authorization or certificate that shows that binding of the user to the resources has been created or reconfirmed.
* n.b. The US Health care proposal has decided to separate the binding and consent receipt into two separate JWT/JWS signed jose documents that could be combined into a single JWT/JWE jose envelope for encryption.
#Binding Statement (aka [[Consent Receipt]] or [https://tcwiki.azurewebsites.net/index.php?title=Entity_Statement Entity Statement])<blockquote>Response to the REQUEST - this is the name, version or identity for message returned by the issuer after the process has been completed. It is then made available to any legitimate request. It is signed by a well-known key belonging the the issuer.</blockquote>
#Issuer (of this receipt aka Organization)<blockquote>MANDATORY This the entity that the subject is forming a binding with. It may be a brand name rather that a legal name.</blockquote>
#Role of Issuer<blockquote>MANDATORY - this is the role(s) that the issue takes. (eg CSP, Identifier Provider, Data Controller)</blockquote>
#Legal Name<blockquote>OPTIONAL - this may be included if the Issuer is not a legal entity. It is required that a legal entity be responsible for the receipt.</blockquote>
#Subject<blockquote>MANDATORY - this is the identifier supplied by the user. This receipt is bound to this identifier.</blockquote>
#Claims<blockquote>OPTIONAL - this will be either the categories of claims granted, or the claims themselves.</blockquote>
#Issue Date<blockquote>MANDATORY - Linux epoch date is default</blockquote>
#Expiration Date<blockquote>OPTIONAL - Linux epoch date is default</blockquote>
#Authority Hints<blockquote>OPTIONAL - List of federation authorities subscribed to by this issuer</blockquote>
#Issuer's Public Key<blockquote>MANDATORY - must be included directly or by reference.</blockquote>
#Signature<blockquote>MANDATORY - using the above key.</blockquote>
#Encryption<blockquote>MANDATORY??? - using the Subject's key.</blockquote>

==References==
* [https://www.globalsign.com/en/blog/what-is-a-certificate-signing-request-csr/ List of CSR contents.] (X.509v3 Certificate Signing Request) which, unlike this consent, is not signed by the user (aka key owner).
* The [[Trustworthy Healthcare Ecosystem]] puts the CSP into context with the other components of the ecosystem.\
* [https://www.ihe.net/uploadedFiles/Documents/ITI/IHE_ITI_TF_Vol1.pdf IHE IT Infrastructure (ITI) Technical Framework Volume 1 (ITI TF-1) Integration Profiles] See Section 13.4 XUA Actors/Transactions and following for terms needed in SAML.

[[Category:Binding]]
[[Category:Profile]]
[[Category:Health]]
[[Category:Trust]]
[[Category:Privacy]]