User-Managed Access

From Wikipedia, the free encyclopedia

User-Managed Access (UMA) is an OAuth-based access management protocol standard. Version 1.0 of the standard was approved by the Kantara Initiative on March 23, 2015.[1]

As described by the charter of the group that developed UMA,[2] the purpose of the protocol specifications is to “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”. This purpose has privacy and consent implications for web applications and the Internet of Things (IoT), as explored by the collection of case studies contributed by participants in the standards group.[3]

History and background[edit]

The Kantara Initiative's UMA Work Group[4] held its first meeting[5] on August 6, 2009. UMA's design principles and technical design have been informed by previous work by Sun Microsystems employees, begun in March 2008, on a protocol called ProtectServe. In turn, ProtectServe was influenced by the goals of the Vendor Relationship Management movement and an offshoot effort called feeds-based VRM.

ProtectServe and UMA's earliest versions leveraged the OAuth 1.0 protocol. As OAuth underwent significant change through the publication of the Web Resource Authorization Protocol (WRAP) specification and, subsequently, drafts of OAuth 2.0, the UMA specification has kept pace, and it now uses the OAuth 2.0 family of specifications for several key protocol flows.

UMA does not use or depend on OpenID 2.0 as a means of user identification. However, it optionally uses the OAuth-based OpenID Connect protocol as a means of collecting identity claims from a requesting party in order to attempt to satisfy the authorizing user's access policy.

UMA also does not use or depend on the eXtensible Access Control Markup Language (XACML) as a means of encoding user policy or requesting policy decisions. UMA does not dictate policy format, as policy evaluation is performed internally to the authorization server (AS) from the UMA perspective. Typically XACML would be used to implement the policies inside the AS. Its implementation is out-of-scope of UMA. The UMA protocol flows for requesting access permission have some features in common with the XACML protocol.

Standardization status[edit]

The UMA group conducts its work in the Kantara Initiative[6] and has also contributed a series of Internet-Draft specifications to the Internet Engineering Task Force (IETF) as an eventual home for UMA standardization work. To this end, the WG has contributed several individual Internet-Drafts to the IETF for consideration. One of these, a specification for OAuth dynamic client registration,[7] served as input for the more generalized mechanism ultimately developed for OAuth.[8] UMA was presented to the OAuth Working Group[9] at the IETF 104 conference in March 2019,[10] but that did not result in any UMA specifications being adopted by the IETF.

Implementation and adoption status[edit]

The UMA core protocol has several implementations,[11] including several open source implementations. Sources of active and available open-source implementations include ForgeRock,[12] Gluu,[13] IDENTOS Inc.,[14] MITREid Connect,[15] Atricore, Node-UMA,[16] Roland Hedberg,[17] Keycloak,[18] and WSO2 Identity Server.[19] A Kantara Initiative group is working on developing "free and open-source software (FOSS), in several popular programming languages, that empowers developers to incorporate UMA protection and authorization API enablement into applications, services, and devices".[20]

UMA-enabled products are available from Gluu,[21] Jericho Systems,[22] ForgeRock,[23] IDENTOS Inc.[24] and WSO2 Identity Server [19]

Comparison to OAuth 2.0[edit]

This diagram provides a high level overview of the entities and relationships involved in the UMA specification.

The diagram (see right) highlights key additions that UMA makes to OAuth 2.0.

In a typical OAuth flow, a human resource owner (RO) operating a client application is redirected to an authorization server (AS) to log in and consent to the issuance of an access token so that the client application can gain access to the resource server (RS) on the RO’s behalf in future, likely in a scoped (limited) fashion. The RS and AS are in all likelihood operating within the same security domain, and any communication between them is not standardized by the main OAuth specification.

UMA adds three main concepts and corresponding structures and flows. First, it defines a standardized API at the AS, called the protection API, that the RS speaks to; this enables multiple RS’s to communicate with one AS and vice versa, and because the API is itself secured with OAuth, allows for formal trust establishment between each pair. This also allows an AS to present an RO with a centralized user interface. Second, UMA defines a formal notion of a requesting party (RqP) that is autonomous from an RO, enabling party-to-party sharing and delegation of access authorization. An RO need not consent to token issuance at run time but can set policy at an AS, allowing an RqP to attempt access asynchronously. Third, UMA enables access attempts to result in successful issuance of tokens associated with authorization data based on a process of trust elevation in the RqP, for example, gathering identity claims or other claims from them.

Applicable use cases[edit]

UMA's architecture can serve a variety of consumer-facing and enterprise-facing use cases. The UMA group collects case studies on its wiki.[3]

One example set of use cases is in healthcare IT and consumer health. In the OpenID Foundation organization, a working group called Health Relationship Trust (HEART)[25] is working to "harmonize and develop a set of privacy and security specifications that enable an individual to control the authorization of access to RESTful health-related data sharing APIs", building upon, among other standards, UMA.

Another example set of use cases, which originally influenced UMA's development, is in the area of "personal data stores" in the fashion of vendor relationship management. In this conception, an individual can choose an operator of an authorization service that accepts connections from a variety of consumer-facing digital resource hosts in order to offer a dashboard with resource sharing management capabilities.


  1. ^ "User Managed Access - Leadership Council - Kantara Initiative".
  2. ^ "Charter - WG - User Managed Access - Kantara Initiative".
  3. ^ a b "Case Studies - WG - User Managed Access - Kantara Initiative".
  4. ^ UMA Work Group Wiki
  5. ^ UMA workgroup meeting minutes
  6. ^ "Home - WG - User Managed Access - Kantara Initiative".
  7. ^ Internet Draft: OAuth 2.0 Dynamic Client Registration Core Protocol
  8. ^ Richer, Justin; Jones, Michael; Bradley, John; Machulak, Maciej; Hunt, Phil (July 2015). Richer, J (ed.). "OAuth 2.0 Dynamic Client Registration Protocol". doi:10.17487/RFC7591. {{cite journal}}: Cite journal requires |journal= (help)
  9. ^ "Home - WG - Web Authorization Protocol (Oauth) - IETF".
  10. ^ "IETF104 - oauth WG - meeting minutes".
  11. ^ "UMA Implementations - WG - User Managed Access - Kantara Initiative".
  12. ^ "Digital Identity for Consumers and Workforce | ForgeRock".
  13. ^ Archived 2014-02-09 at the Wayback Machine Gluu OSS implementation of UMA
  14. ^ IDENTOS Inc. Federated Privacy Exchange (FPX)
  15. ^[permanent dead link]
  16. ^ Atricore OSS implementation of UMA for Node.js
  17. ^ "Rohe/Pyuma". GitHub. 22 January 2018.
  18. ^ "Keycloak 4.0.0.Final". Archived from the original on 2019-03-06. Retrieved 2019-03-05.
  19. ^ a b "User Managed Access - Identity Server 5.8.0 latest - WSO2 Documentation".
  20. ^ "Home - WG - User-Managed Access Developer Resources - Kantara Initiative". Archived from the original on 2016-02-16. Retrieved 2015-08-13.
  21. ^ "Web Access Management | the Gluu Server for SSO, WAM, & 2FA | Gluu". Archived from the original on 2015-08-05. Retrieved 2015-08-13.
  22. ^
  23. ^ "User-Managed Access (UMA) - ForgeRock".
  24. ^ "Federated Privacy Exchange - by IDENTOS".
  25. ^ "HEART WG | OpenID". 27 October 2014.

External links[edit]