Observe Android SDK

com.corbado:observe records native authentication telemetry. Your existing authentication code remains responsible for credentials, method execution and sessions. Early access: the Kotlin API can change between minor releases.

Install

Use Android API level 23 or later and enable mavenCentral() in your dependency repositories.

dependencies {
    implementation("com.corbado:observe:0.1.5")
}

See Maven Central for published versions.

Initialize explicitly

import com.corbado.observe.CorbadoObserve
import com.corbado.observe.ObserveOptions

val tracker = CorbadoObserve.init(
    context = applicationContext,
    options = ObserveOptions(
        projectId = "<ProjectID>",
        apiBaseUrl = "<APIBaseURL>",
    ),
)

Keep the nullable tracker in your app. Initialization can return null; authentication should continue independently. No Observe API key is needed in the app.

Report flow boundaries

When the login screen becomes visible:

tracker?.flowStarted(flowName = "login", touchpoint = "account")

After your identity system confirms a successful login:

tracker?.flowFinished("login")

Instrument method attempts between those boundaries with typed operation helpers. See the shared event model.

Native capture boundaries

The SDK provides optional autofill observation and operation helpers for credential ceremonies. Your application supplies screen and flow semantics; native capture does not infer the entire login journey. Web-based login components can use Autocapture.

Runtime controls and verification

tracker?.setCollectionEnabled(false)
tracker?.setTransportEnabled(false)

Stopping transport alone still allows collection. Configure both controls according to your application’s requirements. The SDK batches delivery and can recover queued events after process restart. The library manifest includes INTERNET for transport and USE_BIOMETRIC for capability checks. These are normal Android permissions and do not present a runtime permission dialog. Verify failed attempts, method switches and the eventual outcome in Observe. See verification.

Overview

Corbado Observe

Corbado Connect

Native capture boundaries

Runtime controls and verification

​Native capture boundaries

​Runtime controls and verification

Native capture boundaries

Runtime controls and verification