Vroom Auth Login w/Google

Install

npm install @vroomlabs/react-gauth-button

How to use

import React from 'react';
import ReactDom from 'react-dom';
import VroomAuthLogin from '@vroomlabs/react-gauth-button';  

const authResponse = (response) {
    console.log(response)
}

ReactDom.render(
    <VroomAuthLogin 
        clientId="someid.apps.googleusercontent.com"
        buttonText="Sign In"
        onSuccess={authResponse}
        onFailure={authResponse}
    />,
    document.getElementById('vroom-auth')
);

Component can accept child components (e.g., icons)

onSuccess callback

If offlineMode is false, callback will return the GoogleUser object.

If offlineMode is true, callback will return the offline GoogleAuth Code for use on the server.

Hosted Domain is defaulted to vroom.com, make sure to validate the id_token (a JWT) returned by Google in your service:

1. The authResponse(response){...} callback function will return a JWT as response.hg.id_token
2. Send the JWT to the backend service (suggest using Auth header)
3. Recommendation: Backend service should verify the id_token by using a JWT library, jsonwebtoken. Use Google's public key to verify the token's signature
4. The returned decoded token should have an hd key value equal to the hosted domain specified.
   hd = hosted domain

Args

arg	type	default	note
clientid	string	REQUIRED - none
hostedDomain	string	vroom.com
scope	string	none	Google scopes can be found here
offlineMode	boolean	false
onSuccess	function	REQUIRED - none
onFailure	function	REQUIRED - none
onRequest	function	none
buttonText	string	Sign In with Google
className	string	none
style	object	none
disabledStyle	object	none
loginHint	string	none
prompt	string	none
tag	string	button	Set element tag (e.g., button, a, div, span)
authLoad	boolean	false
fetchBasicProfile	boolean	true
disabled	boolean	false
uiMode	string	popup	Alternative is uiMode=redirect after login. redirectUri needed if set
redirectUri	string	none	Must be set if uiMode=redirect
isSignedIn	boolean	none	Will return GoogleUser object, if user has granted permission for your app

onSuccess callback - Auth Code

property name	value	definition
code	object	offline token

onSuccess callback - Token (Default)

Provides GAuth User Object with access to GoogleUser methods.
Returned values
| property name | value | definition | |:-------------:|:-------:|:-------------:| | googleId | string | GAuth User ID | | tokenId | string | Token ID | | accessToken | string | Access Token | | tokenObject | object | Token object | | profileObject | object | User Profile object |

onFailure callback

property name	value	definition
error	string	error code
details	string	error message

Issues / Feedback

Please report any issues and suggest feedback through the repo! I hope you find the VroomAuth component useful and would be happy to give guidance on getting you going!

Happy Coding!
Puches

Created by

John Rodkey
Copyright © 2017 Vroom, Inc.
All Rights Reserved