Skip to content
Trimble Identity

trimble-id-android

Maven Central

Trimble Identity Android OAuth Library

Table of Contents

Features

  • 🔐 OAuth 2.0 Authentication - Secure authentication with Trimble Identity
  • 👥 Multi-User Support - Manage multiple user accounts (Preview)
  • 📱 Offline Authentication - Work offline with cached credentials (Preview)
  • 🔄 Token Management - Automatic token refresh and management
  • ⚡ Modern API - Kotlin-first with coroutines support
  • 📖 Comprehensive Documentation - Complete guides and API reference

Versions

We provide two versions of the Trimble Identity Android SDK:

🟢 Stable Version (Recommended for Production)

  • Version: 1.0.1
  • Repository: Maven Central
  • Status: Production-ready, stable API
  • Use Case: Stable integrations

🟡 Preview Version (Beta)

  • Version: 1.2.0-alpha-20250620
  • Repository: Trimble Artifactory
  • Status: Beta release with new features
  • Features: Offline Authentication, Multi-User Support
  • Use Case: Early adoption and feature testing

Installation

Stable Version

Gradle

dependencies {
    implementation 'com.trimble:trimble-id-android:1.0.1'
}

Maven

<dependency>
    <groupId>com.trimble</groupId>
    <artifactId>trimble-id-android</artifactId>
    <version>1.0.1</version>
</dependency>

Preview Version (Beta)

First, add the Trimble Artifactory repository:

Gradle

repositories {
    maven {
        url 'https://artifactory.trimble.tools/artifactory/trimblecloudplatform-engagement-maven/'
    }
}


dependencies {
    implementation 'com.trimble:trimble-id-android:1.2.0-alpha-20250620'
}

Maven

<dependencies>
    <dependency>
        <groupId>com.trimble</groupId>
        <artifactId>trimble-id-android</artifactId>
        <version>1.2.0-alpha-20250620</version>
    </dependency>
</dependencies>

Configure Trimble Identity

1. Register Your Application

Create a new application in the Trimble Developer Console:

  1. Navigate to Applications in the left pane
  2. Click + NEW APPLICATION
  3. Fill in your application details:
    • Name: Your application name
    • Description: Brief description of your app
  4. Configure OAuth settings:
    • Grant Type: Authorization Code Grant
    • Enable: Use Refresh tokens
  5. Set your callback URLs:
    • Callback URL: Where users return after login
    • Logout URL: Where users go after logout
  6. Click Create Application

For more information, see Authentication documentation.

2. Configure Scopes

Scopes determine the aud claim in access tokens and are mandatory. Use your application name registered in the Trimble Developer Console.

Format: {uuid}-{application-name} Example: 12345678-1234-1234-1234-123456789012-myapp

Documentation

Stable Version (1.0.1)

Preview Version (1.2.0-alpha-20250620)

Reporting Issues

Found a bug or have a feature request? Please open an issue

Support