Wallet-as-a-ServiceAuthenticationGoogle

Google Authentication

This guide walks you through setting up Google OAuth as a custom authentication provider for your UTXOS application.

Custom authentication providers are available on Pro and Scale plans. The Base plan uses UTXOS-managed Google credentials.

Prerequisites

  • A Google Cloud account
  • Access to the Google Cloud Console
  • A UTXOS project on the Pro or Scale plan

Create Google OAuth Credentials

  1. Navigate to the Google Auth Platform in Google Cloud Console.

  2. Create a new OAuth 2.0 Client ID with the Web application type.

⚠️

Google may require identity verification for your OAuth consent screen before your app can be used by external users.

  1. Configure the authorized URLs:
FieldValue
Authorized JavaScript originshttps://utxos.dev
Authorized redirect URIshttps://utxos.dev/api/auth

Google OAuth URL configuration

  1. Click Create to generate your credentials.

  2. Copy the Client ID and Client Secret. Download the JSON file as a backup.

Configure UTXOS Dashboard

  1. Open the UTXOS Dashboard and select your project.

  2. Navigate to Settings > Authentication.

  3. Select Google from the provider list.

  4. Enter your credentials:

FieldValue
Client IDYour Google OAuth Client ID
Client SecretYour Google OAuth Client Secret

  1. Toggle Enable to activate Google authentication.

  2. Click Save project settings.

Google authentication settings in UTXOS dashboard

Verify the Integration

  1. Open your application and initiate the wallet connection flow.

  2. Select Login with Google.

  3. Complete the Google sign-in process.

  4. Confirm you are redirected back to your application with an active wallet session.

Troubleshooting

”redirect_uri_mismatch” Error

The redirect URI in your Google OAuth configuration does not match the expected value. Verify that https://utxos.dev/api/auth is added exactly as shown, with no trailing slash.

”access_denied” Error

Your OAuth consent screen may be in testing mode. Add your test users in the Google Cloud Console, or publish the app for production use.

”invalid_client” Error

Double-check that you copied the Client ID and Client Secret correctly. Ensure there are no leading or trailing spaces.

Next Steps

DiscordX (Twitter)