Skip to content
Last updated

BigQuery integration

BigQuery is Google Cloud's fully managed, serverless data warehouse that enables scalable analysis over large datasets. The BigQuery integration allows your application to connect to BigQuery through Frontegg, enabling users to run queries, manage datasets and tables, and stream data — all through a secure OAuth 2.0 connection.


Prerequisites

  • A Google Cloud account with an active project
  • Admin or editor permissions on the Google Cloud project
  • BigQuery API enabled in your Google Cloud project

Connect BigQuery

Step 1: Open the Google Cloud console

Navigate to Google Cloud Console and select your project from the project selector at the top of the page. If you do not have a project yet, create a new one.

Google Cloud Console welcome page

Step 2: Enable the BigQuery API

Go to APIs & ServicesLibrary and search for BigQuery API. If it is not already enabled, click Enable.

BigQuery API enabled

Step 3: Navigate to the credentials page

Go to APIs & ServicesCredentials. This page lists all your existing API keys, OAuth 2.0 Client IDs, and service accounts. Click Create credentials and select OAuth client ID.

Credentials page with Create credentials menu

Select OAuth client ID from dropdown

Step 4: Create an OAuth client ID

On the Create OAuth client ID page, configure the following:

  1. Set Application type to Web application.
  2. Set Name to a descriptive name (e.g., Frontegg Integration).
  3. Under Authorized redirect URIs, click Add URI and enter the following redirect URIs:
  • https://YOUR_MCP_GATEWAY_URL/integration-callback
  1. Click Create.

OAuth client ID creation form with redirect URIs

Step 5: Copy your credentials

After creating the OAuth client, a dialog appears with your Client ID and Client Secret. Copy both values and store them securely — the Client Secret will not be shown again after you close this dialog.

OAuth client created dialog with credentials

Step 6: Configure OAuth scopes

The BigQuery integration requires the following OAuth scopes:

ScopeDescription
https://www.googleapis.com/auth/bigqueryFull access to BigQuery resources
https://www.googleapis.com/auth/bigquery.readonlyRead-only access to BigQuery data
https://www.googleapis.com/auth/bigquery.insertdataInsert data into BigQuery tables
https://www.googleapis.com/auth/cloud-platformFull access to Google Cloud Platform resources
openidOpenID Connect authentication
https://www.googleapis.com/auth/userinfo.emailAccess to user email address
https://www.googleapis.com/auth/userinfo.profileAccess to user profile information

Minimum required scopes

For basic read-only functionality, you need: https://www.googleapis.com/auth/bigquery.readonly, openid, and https://www.googleapis.com/auth/userinfo.email.

Configure the Frontegg portal

Once you have obtained your Client ID and Client Secret from the steps above, enter them in the integration configuration page of the Frontegg portal:

  1. Open the Frontegg portal and navigate to [Environment]IntegrationsBigQuery.
  2. Enter the Client ID and Client Secret in the corresponding fields.
  3. Select the required scopes.
  4. Click Save.

Keep your credentials secure

Never share or commit your Client Secret to version control.

Additional resources