Run the sample apps

Identity Engine

This guide describes how to run the embedded Identity Engine SDK or Sign-In Widget sample app. Make sure to successfully create and set up your Okta org first. You also need to download and set up the SDK.

---

Learning outcomes

Run the embedded Identity Engine SDK or Sign-In Widget sample app.

What you need

• An Okta org already configured for a password only use case
• An Identity Engine SDK set up for the sample app
• An Identity Engine sample app

Sample code

Android Identity Engine sample app (opens new window)

---

The embedded widget flow

In tandem with the embedded SDK, the widget integrates into your app by using a native language interface and communicates directly with the Okta APIs. The following diagram summarizes the flow.

Run the embedded widget sample app

Note: There is no Widget sample application for Android.

The embedded SDK flow

The SDK integrates into your app by using a native language interface and communicates directly with the Okta APIs by using a REST interface. The following diagram illustrates the SDK flow.

Run the embedded SDK sample app

1. If you haven't already done so, set up your Okta org by completing these steps:

   • Set up your Okta org for a password factor only use case
   • Download and set up the sample app

2. Using Android Studio, open the okta-idx-android project.

3. Open the okta.properties file in the project root directory and configure it with the settings from your org.

4. Click Run to launch the application in the Android emulator.

5. Tap LOGIN to start the authentication flow.

Work with the use cases

After you successfully run the sample app, you can build your own integration by using the sample app as your guide. Explore use cases that are available with the SDK, starting with the Basic sign-in flow example with the password factor use case.