Verizon Media

gffletch@aol.com

OpenID Connect Working Group OpenID Connect Prompt Create An extension to the OpenID Connect Authentication Framework defining a new value for the prompt parameter that instructs the OpenID Provider to start the user flow with user registration and after the user account has been created return an authorization code to the client to complete the authentication flow.

Several years of deployment and implementation experience with OpenID Connect Core 1.0 has uncovered a need, in some circumstances, for the client to explicitly signal to the OpenID Provider that the user desires to create a new account rather than authenticate an existing identity. This allows the client to indicate to the OpenID Provider that the user desires to create an account. This improves the user experience because the user doesn't have to first see the login form and then find the sign-up link on the form and select it before getting to the user's desired action. This specification defines a new parameter value for the prompt parameter.

The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in RFC 2119. In the .txt version of this specification, values are quoted to indicate that they are to be taken literally. When using these values in protocol messages, the quotes MUST NOT be used as part of the value. In the HTML version of this specification, values to be taken literally are indicated by the use of this fixed-width font.

This specification uses the terms "authorization endpoint", "authorization request", "authorization response", and "client" defined by The OAuth 2.0 Authorization Framework.

In requests to the OpenID Provider, a client MAY indicate that the desired user experience is for the user to immediately see the user account creation UI instead of the login behavior. A value of create indicates to the OpenID Provider that the client desires that the user be shown the account creation UX rather than the login flow. Care must be taken if combining this value with other prompt values. Mututally exclusive conditions can arise so it is RECOMMENDED that create not be present with any other values.

When the prompt parameter is used in an authorization request to the authorization endpoint with the value of create, it indicates that client desires the user be shown the account creation experience rather than the login experience. This behavior is the same for both the implicit flow (Section 3.2 of OpenID Connect Core 1.0), and the authorization code flow (Section 3.1 of OpenID Connect Core 1.0). For authorization requests sent as a JWTs, such as when using JWT Secured Authorization Request, a single prompt parameter value is represented as a JSON string while multiple values are represented as an array of strings. If the OpenID Provider fails to parse the provided value(s) it should ignore the prompt parameter value and proceed as if the prompt parameter was not specified. An example of an authorization request where the client tells the OpenID Provider that it wants the user to start from the account creation user experience is shown in below (extra line breaks and indentation are for display purposes only).

Below in is an example of an authorization request using the code response type where the the client tells the OpenID Provider that it wants the user to start from the account creation user experience (extra line breaks and indentation are for display purposes only).

Placeholder for now

Nomura Research Institute, Ltd. Ping Identity Microsoft Google Salesforce

This specification was developed within OpenID connect Working Group of the OpenID Foundation. Additionally, the following individuals contributed ideas, feedback, and wording that helped shape this specification: William Dennis

[[ to be removed by the RFC Editor before publication as an RFC ]] Removed "MUST" normative text and replacec with concept that prompt=create is more of a hint to the OpenID Provider.