Skip to content

Commit

Permalink
Source Google directory #6265 - update docs
Browse files Browse the repository at this point in the history
  • Loading branch information
vitaliizazmic committed Oct 29, 2021
1 parent 98ba803 commit dec5094
Show file tree
Hide file tree
Showing 2 changed files with 13 additions and 5 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@
"type": "object",
"oneOf": [
{
"title": "Web server application",
"title": "Sign in via Google (Oauth)",
"description": "For these scenario user only needs to give permission to read Google Directory data",
"type": "object",
"required": ["client_id", "client_secret", "refresh_token"],
Expand Down Expand Up @@ -48,7 +48,7 @@
}
},
{
"title": "Service accounts",
"title": "Service account Key",
"description": "For these scenario user should obtain service account's credentials from the Google API Console and provide delegated email",
"type": "object",
"required": ["credentials_json", "email"],
Expand Down
14 changes: 11 additions & 3 deletions docs/integrations/sources/google-directory.md
Original file line number Diff line number Diff line change
Expand Up @@ -35,11 +35,19 @@ This Source is capable of syncing the following Streams:

This connector attempts to back off gracefully when it hits Directory API's rate limits. To find more information about limits, see [Google Directory's Limits and Quotas](https://developers.google.com/admin-sdk/directory/v1/limits) documentation.

## Getting started
## Getting Started \(Airbyte Cloud\)

Google APIs use the OAuth 2.0 protocol for authentication and authorization. The Source supports [Web server application](https://developers.google.com/identity/protocols/oauth2#webserver) and [Service accounts](https://developers.google.com/identity/protocols/oauth2#serviceaccount) scenarios.
1. Click `OAuth2.0 authorization` then `Authenticate your Google Directory account`.
2. You're done.

### Requirements Service accounts scenario
## Getting Started \(Airbyte Open-Source\)

Google APIs use the OAuth 2.0 protocol for authentication and authorization. This connector supports [Web server application](https://developers.google.com/identity/protocols/oauth2#webserver) and [Service accounts](https://developers.google.com/identity/protocols/oauth2#serviceaccount) scenarios. Therefore, there are 2 options of setting up authorization for this source:

* Create service account specifically for Airbyte and authorize with JWT. Select "JWT authorization" from the "Authentication mechanism" dropdown list.
* Use your Google account and authorize over Google's OAuth on connection setup. Select "Default OAuth2.0 authorization" from dropdown list.

### Service account requirements

* Credentials to a Google Service Account with delegated Domain Wide Authority
* Email address of the workspace admin which created the Service Account
Expand Down

0 comments on commit dec5094

Please sign in to comment.