If you want to implement the OpenID Authorization Code Flow (also called the Server Flow)
in your Web application to use Google OpenID Connect service,
you should follow these steps:
1. Building the Google OpenID Connect Sign-on authentication request:
- Register your Web application to your Google account.
- Add the URL where your server script is located to the above
registration as a "Reply URL". This URL will be used
as the "redirect_uri" in the authentication request.
- Take the "Client ID" from above registration and use it
as the "client_id" in the authentication request.
- Set "scope=openid", and "response_type=code" in the authentication request.
- Set "nonce" to a random number and cache it in your application.
So you can use it to validate the response later.
- Set "state" to the current session id of your application,
So you can resume the session after the response is validated.
2. Triggering the end user browser to fire the authentication request
- Create a login page, login.html, to display a login button.
- When the button is clicked, call a server side script, login.php.
- Create the server side script, login.php, to return a direct HTTP response
with the location of https://accounts.google.com/o/oauth2/auth?...
containing all request parameters in the URL as the query string.
3. Letting the end user sign on to the Active Directory -
This is controlled by the Google OpenID Connect service. Your application is not involved
in this step.
4. Validating the authentication response:
- Scan the response body for 2 possible parameters: "code" and "state"
in your server side script, which you provided as
the "redirect_uri" in the authentication request.
- Implement some logic to analyze the error and
display some error message page back to the end user, if "error" found.
- Verify "state" value, it must be a valid session id in your application.
Otherwise, display some error message page back to the end user.
- Take "code" and use it to make the access token request.
5. Building the Google OpenID Connect access token request:
- Set "code" to the "code" value received from the authentication request call.
- Set "client_id" to the same "client_id" value as the authentication request call.
This is the application id you got when you register your Web application in Google OpenID Connect.
- Set "redirect_uri" to the same "redirect_uri" value as the authentication request call.
- Set "grant_type" to "authorization_code".
- Set "client_secret" to the secret key you created
in your application registration in Google OpenID Connect.
6. Calling the access token request
with the POST method.
7. Validating the access token response:
- Scan the response body for 2 possible parameters:
"id_token" and "access_token",
- Decode "id_token" and perform validation.
See other tutorials on how to validate "id_token".
5. Letting the end user to use your application:
- Take the user name, email address, and other profile information
decoded from the "id_token" as trusted information.
- Record or update the end user profile in your application,
if you maintain user profile in database.
- Let the end user to use your application.
Here is a diagram that shows the Google OpenID Connect OpenID Authentication Code Flow:
⇒ Integration with Azure Active Directory
⇐ Google OpenID Connect Access Token Request Test Page
⇑ Google OpenID Connect Integration
⇑⇑ OpenID Tutorials