Set up the first mobile app

In this section, you configure settings for the first mobile app.

Note: This section assumes that you have already downloaded the appropriate sample apps from GitHub.

Instructions for

Android

Loading...

The first steps are to set up the configuration file.

Modify the configuration file

Make the following modifications in your sample app. Open the existing config.json located under res/raw and add the following values for these parameters:

• client_Id: Enter the Client ID that you copied during the last step.
• redirect_uri: Enter com.first.sample:/callback as the value, which is what you defined as the Login Redirect URI in the Native app that you created in the last step.
• end_session_redirect_uri: Enter com.first.sample:/logout as the value, which is what you defined as the Logout Redirect URI in the Native app that you created in the last step.
• discovery_uri: Enter your Okta domain that appears in the upper-right corner of your Okta org dashboard.

Example

{
  "client_id": "clientId",
  "redirect_uri": "com.first.sample:/callback",
  "end_session_redirect_uri": "com.first.sample:/logout",
  "scopes": [
    "openid",
    "profile",
    "offline_access"
  ],
  "discovery_uri": "https://${yourOktaDomain}"
}

Add the redirect scheme

To redirect back to your application from a web browser, specify a unique URI to your app.

Instructions for

Android

Loading...

To add a redirect scheme for Android, you must define a gradle manifest placeholder in your app's build.gradle.

In your app's build.gradle, add the redirect scheme inside the defaultConfig property. The redirect scheme should match what you used when you modified the config.json file.

For example, if your redirect URI is com.first.sample:/callback, then the appAuth redirect scheme is com.first.sample.

Example

    manifestPlaceholders = [
        "appAuthRedirectScheme": "com.first.sample"
    ]

Native sign in

To compile your project, you need to set up the AuthenticationClient with an Org URL.

You can find the Org URL in the Admin Console's global header in the upper-right corner of the page. Click the section that displays your email and company name. A drop-down box appears and displays general org information including the Org URL (for example, subdomain.okta.com).

After you find your Org URL, add the following to your local.properties file:

Example

    authn.orgUrl="https://${yourOktaDomain}"

Note: When you finish, you can build and run the app.

Next: Create a second mobile app