React OAuth2 | Google

Google OAuth2 using the new Google Identity Services SDK for React @react-oauth/google🚀

Install

1$ npm install @react-oauth/google@latest
2
3# or
4
5$ yarn add @react-oauth/google@latest

Demo

https://react-oauth.vercel.app/

Seamless sign-in and sign-up flows

Sign In With Google

Add a personalized and customizable sign-up or sign-in button to your website.

One-tap sign-up

Sign up new users with just one tap, without interrupting them with a sign-up screen. Users get a secure, token-based, passwordless account on your site, protected by their Google Account.

Automatic sign-in

Sign users in automatically when they return to your site on any device or browser, even after their session expires.

User authorization for Google APIs (with custom button)

OAuth 2.0 implicit and authorization code flows for web apps

The Google Identity Services JavaScript library helps you to quickly and safely obtain access tokens necessary to call Google APIs. Your web application, complete either the OAuth 2.0 implicit flow, or to initiate the authorization code flow which then finishes on your backend platform.

How to use

1. Get your Google API client ID

Key Point: Add both http://localhost and http://localhost:<port_number> to the Authorized JavaScript origins box for local tests or development.

2. Configure your OAuth Consent Screen

3. Wrap your application with GoogleOAuthProvider

1import { GoogleOAuthProvider } from '@react-oauth/google';
2
3<GoogleOAuthProvider clientId="<your_client_id>">...</GoogleOAuthProvider>;

Sign In With Google

1import { GoogleLogin } from '@react-oauth/google';
2
3<GoogleLogin
4  onSuccess={credentialResponse => {
5    console.log(credentialResponse);
6  }}
7  onError={() => {
8    console.log('Login Failed');
9  }}
10/>;

One-tap

1import { useGoogleOneTapLogin } from '@react-oauth/google';
2
3useGoogleOneTapLogin({
4  onSuccess: credentialResponse => {
5    console.log(credentialResponse);
6  },
7  onError: () => {
8    console.log('Login Failed');
9  },
10});

or

1import { GoogleLogin } from '@react-oauth/google';
2
3<GoogleLogin
4  onSuccess={credentialResponse => {
5    console.log(credentialResponse);
6  }}
7  onError={() => {
8    console.log('Login Failed');
9  }}
10  useOneTap
11/>;

If you are using one tap login, when logging user out consider this issue may happen, to prevent it call googleLogout when logging user out from your application.

1import { googleLogout } from '@react-oauth/google';
2
3googleLogout();

Automatic sign-in

auto_select prop true

1
2<GoogleLogin
3    ...
4    auto_select
5/>
6
7useGoogleOneTapLogin({
8    ...
9    auto_select
10});

Custom login button (implicit, authorization code & credential flow)

Implicit flow

1import { useGoogleLogin } from '@react-oauth/google';
2
3const login = useGoogleLogin({
4  onSuccess: tokenResponse => console.log(tokenResponse),
5});
6
7<MyCustomButton onClick={() => login()}>
8  Sign in with Google 🚀{' '}
9</MyCustomButton>;

Authorization code flow

Requires backend to exchange code with access and refresh token.

1import { useGoogleLogin } from '@react-oauth/google';
2
3const login = useGoogleLogin({
4  onSuccess: codeResponse => console.log(codeResponse),
5  flow: 'auth-code',
6});
7
8<MyCustomButton onClick={() => login()}>
9  Sign in with Google 🚀{' '}
10</MyCustomButton>;

Credential flow

This will return a JWT token in tokenResponse.credential.

1import { useGoogleLogin } from '@react-oauth/google';
2
3const login = useGoogleLogin({
4  onSuccess: credentialsResponse => console.log(tokenResponse),
5  flow: 'credential',
6});
7
8<MyCustomButton onClick={() => login()}>
9  Sign in with Google 🚀{' '}
10</MyCustomButton>;

Checks if the user granted all the specified scope or scopes

1import { hasGrantedAllScopesGoogle } from '@react-oauth/google';
2
3const hasAccess = hasGrantedAllScopesGoogle(
4  tokenResponse,
5  'google-scope-1',
6  'google-scope-2',
7);

Checks if the user granted any of the specified scope or scopes

1import { hasGrantedAnyScopeGoogle } from '@react-oauth/google';
2
3const hasAccess = hasGrantedAnyScopeGoogle(
4  tokenResponse,
5  'google-scope-1',
6  'google-scope-2',
7);

API

GoogleOAuthProvider

Required	Prop	Type	Description
✓	clientId	string	Google API client ID
	onScriptLoadSuccess	function	Callback fires on load gsi script success
	onScriptLoadError	function	Callback fires on load gsi script failure

GoogleLogin

Required	Prop	Type	Description
✓	onSuccess	(response: CredentialResponse) => void	Callback fires with credential response after successfully login
	onError	function	Callback fires after login failure
	type	standard | icon	Button type type
	theme	outline | filled_blue | filled_black	Button theme
	size	large | medium | small	Button size
	text	signin_with | signup_with | continue_with | signin	Button text. For example, "Sign in with Google", "Sign up with Google" or "Sign in"
	shape	rectangular | pill | circle | square	Button shape
	logo_alignment	left | center	Google logo alignment
	width	string	button width, in pixels
	locale	string	If set, then the button language is rendered
	useOneTap	boolean	Activate One-tap sign-up or not
	promptMomentNotification	(notification: PromptMomentNotification) => void	PromptMomentNotification methods and description
	cancel_on_tap_outside	boolean	Controls whether to cancel the prompt if the user clicks outside of the prompt
	auto_select	boolean	Enables automatic selection on Google One Tap
	ux_mode	popup | redirect	The Sign In With Google button UX flow
	login_uri	string	The URL of your login endpoint
	native_login_uri	string	The URL of your password credential handler endpoint
	native_callback	(response: { id: string; password: string }) => void	The JavaScript password credential handler function name
	prompt_parent_id	string	The DOM ID of the One Tap prompt container element
	nonce	string	A random string for ID tokens
	context	signin | signup | use	The title and words in the One Tap prompt
	state_cookie_domain	string	If you need to call One Tap in the parent domain and its subdomains, pass the parent domain to this attribute so that a single shared cookie is used
	allowed_parent_origin	string | string[]	The origins that are allowed to embed the intermediate iframe. One Tap will run in the intermediate iframe mode if this attribute presents
	intermediate_iframe_close_callback	function	Overrides the default intermediate iframe behavior when users manually close One Tap
	itp_support	boolean	Enables upgraded One Tap UX on ITP browsers
	hosted_domain	string	If your application knows the Workspace domain the user belongs to, use this to provide a hint to Google. For more information, see the hd field in the OpenID Connect docs

useGoogleLogin (Both implicit & authorization code flow)

Required	Prop	Type	Description
	flow	implicit | auth-code	Two flows, implicit and authorization code are discussed. Both return an access token suitable for use with Google APIs
	onSuccess	(response: TokenResponse|CodeResponse) => void	Callback fires with response (token | code) based on flow selected after successfully login
	onError	(errorResponse: {error: string; error_description?: string,error_uri?: string}) => void	Callback fires after login failure
	onNonOAuthError	(nonOAuthError: NonOAuthError) => void	Some non-OAuth errors, such as the popup window is failed to open or closed before an OAuth response is returned. popup_failed_to_open | popup_closed | unknown
	scope	string	A space-delimited list of scopes that are approved by the user
	enable_serial_consent	boolean	defaults to true. If set to false, more granular Google Account permissions will be disabled for clients created before 2019. No effect for newer clients, since more granular permissions is always enabled for them.
	hint	string	If your application knows which user should authorize the request, it can use this property to provide a hint to Google. The email address for the target user. For more information, see the login_hint field in the OpenID Connect docs
	hosted_domain	string	If your application knows the Workspace domain the user belongs to, use this to provide a hint to Google. For more information, see the hd field in the OpenID Connect docs

useGoogleLogin (Extra implicit flow props)

Required	Prop	Type	Description
	prompt	'' | none | consent | select_account	defaults to 'select_account'. A space-delimited, case-sensitive list of prompts to present the user
	state	string	Not recommended. Specifies any string value that your application uses to maintain state between your authorization request and the authorization server's response

useGoogleLogin (Extra authorization code flow props)

Required	Prop	Type	Description
	ux_mode	popup | redirect	The UX mode to use for the authorization flow. By default, it will open the consent flow in a popup. Valid values are popup and redirect
	redirect_uri	string	Required for redirect UX. Determines where the API server redirects the user after the user completes the authorization flow The value must exactly match one of the authorized redirect URIs for the OAuth 2.0 client which you configured in the API Console and must conform to our Redirect URI validation rules. The property will be ignored by the popup UX
	state	string	Recommended for redirect UX. Specifies any string value that your application uses to maintain state between your authorization request and the authorization server's response
	select_account	boolean	defaults to 'false'. Boolean value to prompt the user to select an account

useGoogleOneTapLogin

Required	Prop	Type	Description
✓	onSuccess	(response: CredentialResponse) => void	Callback fires with credential response after successfully login
	onError	function	Callback fires after login failure
	promptMomentNotification	(notification: PromptMomentNotification) => void	PromptMomentNotification methods and description
	cancel_on_tap_outside	boolean	Controls whether to cancel the prompt if the user clicks outside of the prompt
	hosted_domain	string	If your application knows the Workspace domain the user belongs to, use this to provide a hint to Google. For more information, see the hd field in the OpenID Connect docs