<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<style type="text/css" style="display:none;"> P {margin-top:0;margin-bottom:0;} </style>
</head>
<body dir="ltr">
<div style="font-family: Calibri, Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0); background-color: rgb(255, 255, 255);">
<div style="margin-bottom: 15px; caret-color: rgb(0, 0, 0); font-family: Helvetica, arial, sans-serif; font-size: 14px; font-weight: normal; margin-top: 0px; color: rgb(0, 0, 0); background-color: rgb(255, 255, 255);">
<a href="https://gist.github.com/mcguinness/85116690d556f8ddf280143469063a6c" id="LPlnk774965" style="">https://gist.github.com/mcguinness/85116690d556f8ddf280143469063a6c</a><br>
</div>
<div id="LPBorder_GTaHR0cHM6Ly9naXN0LmdpdGh1Yi5jb20vbWNndWlubmVzcy84NTExNjY5MGQ1NTZmOGRkZjI4MDE0MzQ2OTA2M2E2Yw.." class="LPBorder699699" contenteditable="false" style="width: 100%; margin-top: 16px; margin-bottom: 16px; position: relative; max-width: 800px; min-width: 424px;">
<table id="LPContainer699699" role="presentation" style="padding: 12px 36px 12px 12px; width: 100%; border-width: 1px; border-style: solid; border-color: rgb(200, 200, 200); border-radius: 2px;">
<tbody>
<tr valign="top" style="border-spacing: 0px;">
<td>
<div id="LPImageContainer699699" style="position: relative; margin-right: 12px; height: 120px; overflow: hidden; width: 240px;">
<a target="_blank" id="LPImageAnchor699699" href="https://gist.github.com/mcguinness/85116690d556f8ddf280143469063a6c" style=""><img id="LPThumbnailImageId699699" alt="" height="120" style="display: block;" width="240" src="https://github.githubassets.com/images/modules/gists/gist-og-image.png"></a></div>
</td>
<td style="width: 100%;">
<div id="LPTitle699699" style="font-size: 21px; font-weight: 300; margin-right: 8px; font-family: wf_segoe-ui_light, "Segoe UI Light", "Segoe WP Light", "Segoe UI", "Segoe WP", Tahoma, Arial, sans-serif; margin-bottom: 12px;">
<a target="_blank" id="LPUrlAnchor699699" href="https://gist.github.com/mcguinness/85116690d556f8ddf280143469063a6c" style="text-decoration: none; color: var(--themePrimary);">Online Access Refresh Tokens</a></div>
<div id="LPDescription699699" style="font-size: 14px; max-height: 100px; font-family: wf_segoe-ui_normal, "Segoe UI", "Segoe WP", Tahoma, Arial, sans-serif; margin-bottom: 12px; margin-right: 8px; overflow: hidden; color: rgb(102, 102, 102);">
Online Access Refresh Tokens. GitHub Gist: instantly share code, notes, and snippets.</div>
<div id="LPMetadata699699" style="font-size: 14px; font-weight: 400; font-family: wf_segoe-ui_normal, "Segoe UI", "Segoe WP", Tahoma, Arial, sans-serif; color: rgb(166, 166, 166);">
gist.github.com</div>
</td>
</tr>
</tbody>
</table>
</div>
Hello OpenID Connect WG,</div>
<div style="font-family: Calibri, Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0); background-color: rgb(255, 255, 255);">
<br>
<p style="margin-bottom: 15px; caret-color: rgb(0, 0, 0); font-family: Helvetica, arial, sans-serif; font-size: 14px; font-weight: normal; color: rgb(0, 0, 0); background-color: rgb(255, 255, 255); margin-top: 0px !important;">
I hosted a session at IIW last fall discussing the need to introduce support for<span> </span><code style="margin: 0px 2px; padding: 0px 5px; border: 1px solid rgb(234, 234, 234); border-radius: 3px; background-color: rgb(248, 248, 248);">online_access</code><span> </span>refresh
 tokens. I promised to write up the takeaways and send to the OpenID Connect mailing list. I finally found the time before the year closes to complete that promise!</p>
<h1 style="margin: 20px 0px 10px; font-weight: bold; cursor: text; font-size: 28px; font-family: Helvetica, arial, sans-serif; color: black; background-color: rgb(255, 255, 255);">
Problem Statement</h1>
<p style="margin: 15px 0px; caret-color: rgb(0, 0, 0); font-family: Helvetica, arial, sans-serif; font-size: 14px; font-weight: normal; color: rgb(0, 0, 0); background-color: rgb(255, 255, 255);">
The<span> </span><a href="https://tools.ietf.org/html/rfc6749" style="color: rgb(65, 131, 196);">OAuth 2.0 Authorization Framework</a><span> </span>defines the<span> </span><code style="margin: 0px 2px; padding: 0px 5px; border: 1px solid rgb(234, 234, 234); border-radius: 3px; background-color: rgb(248, 248, 248);">authorization_code</code><span> </span>grant
 type and refresh token. It doesn't establish any rules for issuing refresh tokens and explicitly states in<span> </span><a href="https://tools.ietf.org/html/rfc6749#section-1.5" style="color: rgb(65, 131, 196);">Section 1.5</a><span> </span>that "Issuing a
 refresh token is optional at the discretion of the authorization server". One of the explicit goals for Rfc6749 was to enable offline access to protected resources when the end-user is not present. It does not define any request semantics for how a client
 can explicitly request a refresh token or whether that refresh token's lifecycle should be bound to the user's session that granted the refresh token. Authorization Servers are free to define these behaviors on a per-implementation or policy basis.</p>
<p style="margin: 15px 0px; caret-color: rgb(0, 0, 0); font-family: Helvetica, arial, sans-serif; font-size: 14px; font-weight: normal; color: rgb(0, 0, 0); background-color: rgb(255, 255, 255);">
OpenID Connect being the identity layer ontop of OAuth 2.0 needed to define some new authorization server behaviors to enable end-user consent for when a client can access their identity info (UserInfo). This resulted in a new scope<span> </span><a href="https://openid.net/specs/openid-connect-core-1_0.html#OfflineAccess" style="color: rgb(65, 131, 196);">offline_access</a><span> </span>being
 defined to allow a client to access their identity info when they are not present.</p>
<div style="caret-color: rgb(0, 0, 0); font-family: Helvetica, arial, sans-serif; font-size: 14px; font-weight: normal; color: rgb(0, 0, 0); background-color: rgb(255, 255, 255);">
<pre style="margin: 0.5em 0px 1em; border-width: 1px 1px 1px 10px; border-style: solid; border-color: rgb(204, 204, 204) rgb(204, 204, 204) rgb(204, 204, 204) rgb(53, 140, 203); font-size: 13px; line-height: 1.5; border-radius: 3px; background-image: linear-gradient(transparent 50%, rgba(69, 142, 209, 0.04) 50%); background-size: 3em 3em; background-origin: content-box; font-family: Consolas, Monaco, "Andale Mono", "Ubuntu Mono", monospace; text-align: left; word-spacing: normal; tab-size: 4; box-shadow: rgb(53, 140, 203) -1px 0px 0px 0px, rgb(223, 223, 223) 0px 0px 0px 1px; box-sizing: border-box; background-color: rgb(253, 253, 253); color: black;"><code style="margin: 0px; padding: 0px 1em; border: none; border-top-left-radius: 3px; border-top-right-radius: 3px; border-bottom-right-radius: 3px; border-bottom-left-radius: 3px; background-image: none; tab-size: 4; height: 38px; display: block; overflow: auto; background-position: initial initial; background-repeat: initial initial">offline_access
OPTIONAL. This scope value requests that an OAuth 2.0 Refresh Token be issued that can be used to obtain an Access Token that grants access to the End-User's UserInfo Endpoint even when the End-User is not present (not logged in).</code></pre>
</div>
<p style="margin: 15px 0px; caret-color: rgb(0, 0, 0); font-family: Helvetica, arial, sans-serif; font-size: 14px; font-weight: normal; color: rgb(0, 0, 0); background-color: rgb(255, 255, 255);">
OpenID Connect 1.0 does not define how the<span> </span><code style="margin: 0px 2px; padding: 0px 5px; border: 1px solid rgb(234, 234, 234); border-radius: 3px; background-color: rgb(248, 248, 248);">offline_access</code><span> </span>scope should constrain
 access to other protected resources, nor does it define the behavior of the refresh token if this scope is not requested. Authorization Servers are free to define behaviors for other protected resources and/or non-OIDC defined scopes when<span> </span><code style="margin: 0px 2px; padding: 0px 5px; border: 1px solid rgb(234, 234, 234); border-radius: 3px; background-color: rgb(248, 248, 248);">offline_access</code><span> </span>is
 requested.</p>
<blockquote style="margin: 15px 0px; border-left: 4px solid rgb(221, 221, 221); padding: 0px 15px; font-family: Helvetica, arial, sans-serif; font-size: 14px; font-weight: normal; color: rgb(119, 119, 119); background-color: rgb(255, 255, 255);">
<p style="margin: 0px">The use of Refresh Tokens is not exclusive to the offline_access use case. The Authorization Server MAY grant Refresh Tokens in other contexts that are beyond the scope of this specification.</p>
</blockquote>
<p style="margin: 15px 0px; caret-color: rgb(0, 0, 0); font-family: Helvetica, arial, sans-serif; font-size: 14px; font-weight: normal; color: rgb(0, 0, 0); background-color: rgb(255, 255, 255);">
There are many large scale OAuth 2.0 deployments the have chosen to only issue refresh tokens for delegated access to their protected non-identity resources only if<span> </span><code style="margin: 0px 2px; padding: 0px 5px; border: 1px solid rgb(234, 234, 234); border-radius: 3px; background-color: rgb(248, 248, 248);">offline_access</code><span> </span>scope
 is requested. This approach often simplified Authorization Server complexity and developer documentation by linking the<span> </span><code style="margin: 0px 2px; padding: 0px 5px; border: 1px solid rgb(234, 234, 234); border-radius: 3px; background-color: rgb(248, 248, 248);">offline_access</code><span> </span>OIDC
 constrain to<span> </span><em>all</em><span> </span>protected resources.</p>
<p style="margin: 15px 0px; caret-color: rgb(0, 0, 0); font-family: Helvetica, arial, sans-serif; font-size: 14px; font-weight: normal; color: rgb(0, 0, 0); background-color: rgb(255, 255, 255);">
OpenID Connect 1.0 also does not define any new behaviors for when an issued refresh tokens should be linked to the authentication session that issued the authorization code/refresh token. Logging out of the OP is an implementation-specific behavior with respect
 to any issued refresh tokens that were not requested with<span> </span><code style="margin: 0px 2px; padding: 0px 5px; border: 1px solid rgb(234, 234, 234); border-radius: 3px; background-color: rgb(248, 248, 248);">offline_access</code><span> </span>scope.</p>
<p style="margin: 15px 0px; caret-color: rgb(0, 0, 0); font-family: Helvetica, arial, sans-serif; font-size: 14px; font-weight: normal; color: rgb(0, 0, 0); background-color: rgb(255, 255, 255);">
This lack of clarity hasn't historically been a significant issue as refresh tokens were restricted from being issued via the<span> </span><code style="margin: 0px 2px; padding: 0px 5px; border: 1px solid rgb(234, 234, 234); border-radius: 3px; background-color: rgb(248, 248, 248);">implicit</code>grant
 in<span> </span><a href="https://tools.ietf.org/html/rfc6749#section-4.2" style="color: rgb(65, 131, 196);">Section 4.2</a>. Refresh tokens were often only used for web or native clients where<span> </span><code style="margin: 0px 2px; padding: 0px 5px; border: 1px solid rgb(234, 234, 234); border-radius: 3px; background-color: rgb(248, 248, 248);">offline_access</code><span> </span>was
 the desired behavior (raison d'etre of OAuth 2.0)</p>
<p style="margin: 15px 0px; caret-color: rgb(0, 0, 0); font-family: Helvetica, arial, sans-serif; font-size: 14px; font-weight: normal; color: rgb(0, 0, 0); background-color: rgb(255, 255, 255);">
As developers shift to more browser-based applications (e.g Single Page Apps) and leverage cloud identity services, the need to resolve this undefined behavior has reached a tipping point. The<span> </span><a href="https://tools.ietf.org/html/draft-ietf-oauth-browser-based-apps-04" style="color: rgb(65, 131, 196);">OAuth
 2.0 for Browser-Based Apps BCP</a><span> </span>and<span> </span><a href="https://tools.ietf.org/html/draft-ietf-oauth-security-topics-13" style="color: rgb(65, 131, 196);">OAuth 2.0 Security Best Current Practice BCP</a><span> </span>deprecate the<span> </span><code style="margin: 0px 2px; padding: 0px 5px; border: 1px solid rgb(234, 234, 234); border-radius: 3px; background-color: rgb(248, 248, 248);">implicit</code><span> </span>grant
 and require all browser-based applications to use the<span> </span><code style="margin: 0px 2px; padding: 0px 5px; border: 1px solid rgb(234, 234, 234); border-radius: 3px; background-color: rgb(248, 248, 248);">authorization_code</code><span> </span>grant
 with PKCE. This change requires defining new behaviors for refresh tokens in the browser where it previously never was used.<span> </span><a href="https://tools.ietf.org/html/draft-ietf-oauth-browser-based-apps-04#section-8" style="color: rgb(65, 131, 196);">Section
 8</a>of the BCP defines security mitigations to prevent refresh tokens from being leaked but does not define what should happen if the user logs out of the authorization server.<span> </span></p>
<p style="margin: 15px 0px; caret-color: rgb(0, 0, 0); font-family: Helvetica, arial, sans-serif; font-size: 14px; font-weight: normal; color: rgb(0, 0, 0); background-color: rgb(255, 255, 255);">
When browser-based apps used the<span> </span><code style="margin: 0px 2px; padding: 0px 5px; border: 1px solid rgb(234, 234, 234); border-radius: 3px; background-color: rgb(248, 248, 248);">implicit</code><span> </span>grant they often used patterns like making
 authentication requests with<span> </span><code style="margin: 0px 2px; padding: 0px 5px; border: 1px solid rgb(234, 234, 234); border-radius: 3px; background-color: rgb(248, 248, 248);">prompt=none</code><span> </span>to silently request new access tokens
 when previously issued access tokens were expired. This pattern relied on the client and the end-user being in the same browser context and having a session with the OP. Logout at OP would prevent these clients from obtaining new access tokens. This not only
 had security benefits but also user experience benefits especially when switching accounts at the OP.</p>
<h1 style="margin: 20px 0px 10px; font-weight: bold; cursor: text; font-size: 28px; font-family: Helvetica, arial, sans-serif; color: black; background-color: rgb(255, 255, 255);">
Proposal</h1>
<p style="margin: 15px 0px; caret-color: rgb(0, 0, 0); font-family: Helvetica, arial, sans-serif; font-size: 14px; font-weight: normal; color: rgb(0, 0, 0); background-color: rgb(255, 255, 255);">
It is desirable to have an explicit pattern for a client to opt-in to a refresh token that is tightly coupled to the user's session at the Authorization Server. An explicit pattern enables the client to express it's intent on whether it wants to operate in
 a connected or disconnected mode. The Authorization Server can choose to honor this intent or not based on policy.</p>
<p style="margin: 15px 0px; caret-color: rgb(0, 0, 0); font-family: Helvetica, arial, sans-serif; font-size: 14px; font-weight: normal; color: rgb(0, 0, 0); background-color: rgb(255, 255, 255);">
The recommendation was to introduce a new<span> </span><code style="margin: 0px 2px; padding: 0px 5px; border: 1px solid rgb(234, 234, 234); border-radius: 3px; background-color: rgb(248, 248, 248);">online_access</code><span> </span>scope that when requested,
 binds the issued refresh token to user's session on the Authorization Server. If the user's session is closed or revoked either directly by end-user or indirectly by the Authorization Server such as an inactivity timeout policy the refresh token and children
 access tokens issued with the refresh token MUST be revoked by the Authorization Server.</p>
<p style="margin: 15px 0px; caret-color: rgb(0, 0, 0); font-family: Helvetica, arial, sans-serif; font-size: 14px; font-weight: normal; color: rgb(0, 0, 0); background-color: rgb(255, 255, 255);">
Revoking the issued refresh token directly via Token Revocation Endpoint or indirectly via the Authorization Server should only revoke the refresh token and children access tokens and not the user's session.<span> </span></p>
<p style="margin: 15px 0px; caret-color: rgb(0, 0, 0); font-family: Helvetica, arial, sans-serif; font-size: 14px; font-weight: normal; color: rgb(0, 0, 0); background-color: rgb(255, 255, 255);">
If the need arises to revoke the user's session at the Authorization Server via the backchannel with a Refresh Token, then a new extension to Logout Specifications should be defined.</p>
<p style="margin: 15px 0px; caret-color: rgb(0, 0, 0); font-family: Helvetica, arial, sans-serif; font-size: 14px; font-weight: normal; color: rgb(0, 0, 0); background-color: rgb(255, 255, 255);">
The recommendation was to define the new<span> </span><code style="margin: 0px 2px; padding: 0px 5px; border: 1px solid rgb(234, 234, 234); border-radius: 3px; background-color: rgb(248, 248, 248);">online_access</code><span> </span>in OIDF as this is consistent
 with<span> </span><code style="margin: 0px 2px; padding: 0px 5px; border: 1px solid rgb(234, 234, 234); border-radius: 3px; background-color: rgb(248, 248, 248);">offline_access</code><span> </span>and relates to authentication concerns. Once defined in OIDF,
 we can reference in OAuth 2.0 for Browser-Based Apps BCP. We should maybe consider introducing a new client application_type (e.g. browser) that requires<span> </span><code style="margin: 0px 2px; padding: 0px 5px; border: 1px solid rgb(234, 234, 234); border-radius: 3px; background-color: rgb(248, 248, 248);">online_access</code><span> </span>scope.</p>
<h1 style="margin: 20px 0px 10px; font-weight: bold; cursor: text; font-size: 28px; font-family: Helvetica, arial, sans-serif; color: black; background-color: rgb(255, 255, 255);">
Precedence</h1>
<p style="margin: 15px 0px; caret-color: rgb(0, 0, 0); font-family: Helvetica, arial, sans-serif; font-size: 14px; font-weight: normal; color: rgb(0, 0, 0); background-color: rgb(255, 255, 255);">
The healthcare domain has defined a similar use of<span> </span><code style="margin: 0px 2px; padding: 0px 5px; border: 1px solid rgb(234, 234, 234); border-radius: 3px; background-color: rgb(248, 248, 248);">online_access</code><span> </span>with the<span> </span><a href="http://www.hl7.org/fhir/smart-app-launch/scopes-and-launch-context/index.html#scopes-for-requesting-a-refresh-token" style="color: rgb(65, 131, 196);">HL7
 FHIR specifications</a>.</p>
<br>
</div>
<div style="font-family: Calibri, Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0); background-color: rgb(255, 255, 255);">
Thanks,</div>
<div style="font-family: Calibri, Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0); background-color: rgb(255, 255, 255);">
Karl</div>
<div style="font-family: Calibri, Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0); background-color: rgb(255, 255, 255);">
<div dir="ltr" style="font-weight: normal; font-family: arial; font-size: small; color: rgb(34, 34, 34);">
<div dir="ltr" style="color: rgb(80, 0, 80);"></div>
</div>
<br>
</div>
</body>
</html>