Creating a Custom OAuth App
The connector facilitates the following OAuth authentication flows:
- The user consent flow enables individual users to connect to their own data.
- The service account flow enables access to domain-wide data.
Using a User Account to Connect to Google
This OAuth flow requires the authenticating user to interact with Google using the browser. The connector facilitates this in various ways as described below.
Authenticate to Google
When you connect the connector opens the OAuth endpoint in your default browser. Log in and grant permissions to the application. The connector then completes the OAuth process:
- Extracts the access token from the callback URL and authenticates requests.
- Refreshes the access token when it expires.
- Saves OAuth values to be persisted across connections.
Using a Service Account to Connect to Domain-Wide Data
You can use a service account in this OAuth flow to access Google APIs on behalf of users in a domain. A domain administrator can delegate domain-wide access to the service account.
To complete the service account flow, generate a private key in the Google APIs Console. In the service account flow, the connector exchanges a JSON Web token (JWT) for the OAuthAccessToken. The private key is required to sign the JWT. The OAuthAccessToken authenticates that the connector has the same permissions granted to the service account.
Generate a Private Key
Follow the steps below to generate a private key and obtain the credentials for your application:
- Log into the Google API Console.
- Click Create Project or select an existing project.
- In the API Manager, click Credentials -> Create Credentials -> Service Account Key. In the Service Account menu, select New Service Account or select an existing service account. In the Key Type section, select the P12 key type.
- Click Create to download the key pair. The private key's password is displayed: Set this in OAuthJWTCertPassword.
- In the Service Account Keys section on the Credentials page, click Manage Service Accounts and set OAuthJWTIssuer to the email address displayed in service account Id.
- Click Library -> Google Drive API -> Enable API.
Authenticate with a Service Account
After setting the following connection properties, you are ready to connect:
- InitiateOAuth: Set this to GETANDREFRESH. You can use InitiateOAuth to avoid repeating the OAuth exchange and manually setting the OAuthAccessToken connection property.
- OAuthJWTCertType: Set this to "PFXFILE".
- OAuthJWTCertPassword: Set this to the password of the .p12 file.
- OAuthJWTCertSubject: Set this to "*" to pick the first certificate in the certificate store.
- OAuthJWTIssuer: Set this to the email address of the service account.
- OAuthJWTCert: Set this to the path to the .p12 file.
- OAuthJWTSubject: Set this to the email address of the user for whom the application is requesting delegate access.
- Creates and signs the JWT with the claim set required by the connector.
- Exchanges the JWT for the access token.
- Submits the JWT for a new access token when the token expires.