Add and configure packages

Next you need to add Okta to your application by installing our SDK.

Install the SDK

• Android
• iOS
• React Native

Use the Okta OIDC library available through JCenter.

To install it, add the following to your build.gradle:

implementation 'com.okta.oidc.android:okta-oidc-androidx:1.0.16'

For projects that don't yet use AndroidX:

repositories {
    maven {
        url  "https://dl.bintray.com/okta/com.okta.android"
    }
}

implementation 'com.okta.oidc.android:okta-oidc-android:1.0.16'

Configure the SDK

You need the following values from the Okta Application and the Developer Console that you worked with in Create an okta application:

• Client ID — Find it in the applications list or on the application's General tab.
• Okta Domain — Find it on the Developer Console dashboard in the upper-right corner as the Org URL.

Note: Your Okta domain is different from your admin domain. Don't include -admin in your Okta domain.

You'll also need the full redirect URI that you defined in Define a callback route.

• Android
• iOS
• React Native

Create a configuration object in code:

config = new OIDCConfig.Builder()
    .clientId("{clientId}")
    .redirectUri("{redirectUri}")
    .endSessionRedirectUri("{endSessionUri}")
    .scopes("openid", "profile", "offline_access")
    .discoveryUri("https://${yourOktaDomain}")
    .create();

Or, create a new okta_oidc_config.json file in your application's res/raw with the following contents:

{
  "client_id": "{clientId}",
  "redirect_uri": "{redirectUri}",
  "end_session_redirect_uri": "{endSessionUri}",
  "scopes": [
    "openid",
    "profile",
    "offline_access"
  ],
  "discovery_uri": "https://${yourOktaDomain}"
}

Then, create a configuration object by loading this file:

config = new OIDCConfig.Builder()
    .withJsonFile(this, R.id.okta_oidc_config)
    .create();

Next: Open the sign-in page