Difference between revisions of "Purpose for Access Request"

From MgmtWiki
Jump to: navigation, search
(→‎Example Schema)
(→‎Example Schema)
Line 78: Line 78:
  
 
     "Purpose": {
 
     "Purpose": {
−
       "@id": "https://www.w3.org/2018/credentials#VerifiableCredential",
+
       "@id": "https://www.w3.org/2018/consents#consent",
 
       "@context": {
 
       "@context": {
 
         "@version": 1.1,
 
         "@version": 1.1,
Line 89: Line 89:
 
         "xsd": "http://www.w3.org/2001/XMLSchema#",
 
         "xsd": "http://www.w3.org/2001/XMLSchema#",
  
−
         "credentialSchema": {
+
         "consentSchema": {
−
           "@id": "cred:credentialSchema",
+
           "@id": "consent:consentSchema",
 
           "@type": "@id",
 
           "@type": "@id",
 
           "@context": {
 
           "@context": {
Line 99: Line 99:
 
             "type": "@type",
 
             "type": "@type",
  
−
             "cred": "https://www.w3.org/20xx/credentials#",
+
             "cred": "https://www.w3.org/20xx/consents#",
  
 
             "JsonSchemaValidator2018": "cred:JsonSchemaValidator2018"
 
             "JsonSchemaValidator2018": "cred:JsonSchemaValidator2018"
 
           }
 
           }
 
         },
 
         },
−
         "credentialStatus": {"@id": "cred:credentialStatus", "@type": "@id"},
+
         "consentStatus": {"@id": "cred:consentStatus", "@type": "@id"},
−
         "credentialSubject": {"@id": "cred:credentialSubject", "@type": "@id"},
+
         "consentSubject": {"@id": "cred:consentSubject", "@type": "@id"},
−
         "evidence": {"@id": "cred:evidence", "@type": "@id"},
+
         "evidence": {"@id": "consent:evidence", "@type": "@id"},
−
         "expirationDate": {"@id": "cred:expirationDate", "@type": "xsd:dateTime"},
+
         "expirationDate": {"@id": "consent:expirationDate", "@type": "xsd:dateTime"},
−
         "holder": {"@id": "cred:holder", "@type": "@id"},
+
         "holder": {"@id": "consent:holder", "@type": "@id"},
−
         "issued": {"@id": "cred:issued", "@type": "xsd:dateTime"},
+
         "issued": {"@id": "consent:issued", "@type": "xsd:dateTime"},
−
         "issuer": {"@id": "cred:issuer", "@type": "@id"},
+
         "issuer": {"@id": "consent:issuer", "@type": "@id"},
−
         "issuanceDate": {"@id": "cred:issuanceDate", "@type": "xsd:dateTime"},
+
         "issuanceDate": {"@id": "consent:issuanceDate", "@type": "xsd:dateTime"},
 
         "refreshService": {
 
         "refreshService": {
−
           "@id": "cred:refreshService",
+
           "@id": "consent:refreshService",
 
           "@type": "@id",
 
           "@type": "@id",
 
           "@context": {
 
           "@context": {
Line 127: Line 127:
 
           }
 
           }
 
         },
 
         },
−
         "termsOfUse": {"@id": "cred:termsOfUse", "@type": "@id"},
+
         "termsOfUse": {"@id": "consent:termsOfUse", "@type": "@id"},
−
         "validFrom": {"@id": "cred:validFrom", "@type": "xsd:dateTime"},
+
         "validFrom": {"@id": "consent:validFrom", "@type": "xsd:dateTime"},
−
         "validUntil": {"@id": "cred:validUntil", "@type": "xsd:dateTime"}
+
         "validUntil": {"@id": "consent:validUntil", "@type": "xsd:dateTime"}
 
       }
 
       }
 
     },
 
     },

Revision as of 15:37, 5 August 2022

Full Title

This is a discussion of the purpose for which a Relying Party or Verifier is requesting User Private Information.

Context

The goal of this discussion is the creation of a display to the holder of a request for some details needed to create a transaction between the holder and the Verifier.

  • The request must reflect:
  1. The sort of transaction for which data is required.
  2. Any information required to complete the transaction and whether it is to be retained by the verifier.
  3. Any optional information that the verifier wishes that is not required by the immediate transaction.
  1. Display the information to the holder in a language that the user can understand.
  2. Input the holder's response

Taxonomy

  • Holder
  • User Agent
  • Verifier

Current Standard Request Messages

These are all call Authorization Requests rather than Access Requests, which is the typical current transaction type.

OAUTH Authorization Request

From RFC 6749 OAuth 2.0 October 2012

The client constructs the request URI by adding the following parameters to the query component of the authorization endpoint URI using the "application/x-www-form-urlencoded" format. 

response_type
REQUIRED.  Value MUST be set to "code".

client_id
REQUIRED.  The client identifier as described in Section 2.2.

redirect_uri
OPTIONAL.  As described in Section 3.1.2.

scope
OPTIONAL.  The scope of the access request as described by   Section 3.3.
(n.b. The scope could imply a purpose or be repurposed to do so.)

state
RECOMMENDED.  An opaque value used by the client to maintain state between the request and callback.  The authorization server includes this value when redirecting the user-agent back to the client.  The parameter SHOULD be used for preventing cross-site request forgery as described in Section 10.12.

For example, the parameters "response_type", "client_id", "state", and "redirect_uri" are encoded in the URI of the request:
 GET /authorize?response_type=code&client_id=s6BhdRkqt3&state=xyz&redirect_uri=https%3A%2F%2Fclient%2Eexample%2Ecom%2Fcb

JAR

The OAuth 2.0 Authorization Framework: JWT-Secured Authorization Request IETF RFC 9101 (2021-08-21)]
The authorization request in OAuth 2.0 described in RFC 6749 utilizes query parameter serialization, which means that authorization request parameters are encoded in the URI of the request and sent through User Agents such as web Browsers. While it is easy to implement, it means that a) the communication through the user agents is not integrity protected and thus, the parameters can be tainted, b) the source of the communication is not authenticated, and c) the communication through the user agents can be monitored. Because of these weaknesses, several attacks to the protocol have now been put forward. This document introduces the ability to send request parameters in a JSON Web Token (JWT) instead, which allows the request to be signed with JSON Web Signature (JWS) and encrypted with JSON Web Encryption (JWE) so that the integrity, source authentication, and confidentiality properties of the authorization request are attained.

PAR

OAuth 2.0 Pushed Authorization Requests 2021-09 IETF RFC 9126
This document defines the pushed authorization request (PAR) endpoint, which allows clients to push the payload of an OAuth 2.0 authorization request to the authorization server via a direct request and provides them with a request URI that is used as reference to the data in a subsequent call to the authorization endpoint.

RAR

OAuth 2.0 Rich Authorization Requests draft-ietf-oauth-rar-12 2022-05-05
This document specifies a new parameter "authorization details" that is used to carry fine-grained authorization data in OAuth messages.

W3C Data Privacy Vocabulary

  • Collected sources
  • Data elements defined in the DPV
  • EU SPECIAL Project (Scalable Policy-aware Linked Data Architecture For Privacy, Transparency and Compliance) ran from 2017 to 2019, now dormant.
    • supports the acquisition of user consent at collection time and the recording of both data and metadata (consent policies, event data, context) according to legislative and user-specified policies,
    • caters for privacy-aware, secure workflows that include usage/access control, transparency and compliance verification,
    • demonstrates robustness in terms of performance, scalability and security, all of which are necessary to support privacy preserving innovation in Big Data environments. and
    • provides a dashboard with feedback and control features that make privacy in Big Data comprehensible and manageable for data subjects, controllers, and processors.

Normative Specification

The Purpose MUST be included in all requests for User Information (aka PII). The schema for the Purpose SHOULD be included in a @context element as a URL to the appropriate schema.

Non-normative Information

Example Schema

{
  "@context": {
    "@version": 1.0,
    "@protected": true,

<== other content of the document inserted here ==>

    "Purpose": {
      "@id": "https://www.w3.org/2018/consents#consent",
      "@context": {
        "@version": 1.1,
        "@protected": true,

        "id": "@id",
        "type": "@type",

        "cred": "https://www.w3.org/20xx/consent#",
        "xsd": "http://www.w3.org/2001/XMLSchema#",

        "consentSchema": {
          "@id": "consent:consentSchema",
          "@type": "@id",
          "@context": {
            "@version": 1.1,
            "@protected": true,

            "id": "@id",
            "type": "@type",

            "cred": "https://www.w3.org/20xx/consents#",

            "JsonSchemaValidator2018": "cred:JsonSchemaValidator2018"
          }
        },
        "consentStatus": {"@id": "cred:consentStatus", "@type": "@id"},
        "consentSubject": {"@id": "cred:consentSubject", "@type": "@id"},
        "evidence": {"@id": "consent:evidence", "@type": "@id"},
        "expirationDate": {"@id": "consent:expirationDate", "@type": "xsd:dateTime"},
        "holder": {"@id": "consent:holder", "@type": "@id"},
        "issued": {"@id": "consent:issued", "@type": "xsd:dateTime"},
        "issuer": {"@id": "consent:issuer", "@type": "@id"},
        "issuanceDate": {"@id": "consent:issuanceDate", "@type": "xsd:dateTime"},
        "refreshService": {
          "@id": "consent:refreshService",
          "@type": "@id",
          "@context": {
            "@version": 1.1,
            "@protected": true,

            "id": "@id",
            "type": "@type",

            "consent": "https://www.w3.org/20xx/consent#",

            "ManualRefreshService2018": "cred:ManualRefreshService2018"
          }
        },
        "termsOfUse": {"@id": "consent:termsOfUse", "@type": "@id"},
        "validFrom": {"@id": "consent:validFrom", "@type": "xsd:dateTime"},
        "validUntil": {"@id": "consent:validUntil", "@type": "xsd:dateTime"}
      }
    },
    "Consent" {
      -- all of the elements for consent defined here
    }
  }
}

References

Retrieved from "http://tcwiki.azurewebsites.net/index.php?title=Purpose_for_Access_Request&oldid=15453"