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

iOS 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 iOS.

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. Then, download and set up the sample app.
2. Using XCode, locate and open the okta-idx.xcworkspace file in the following path: okta-idx-swift/.
3. Optionally, open the Okta.plist file and configure it with the settings from your org. See Okta.plist.
4. Click Run to launch the app in the iOS simulator.
5. If you didn't configure the Okta.plist file, you can add your org settings to the Configuration page. Tap the Configure link on the start-up screen. See Configuration page.
6. Tap the Sign In button to start the authentication flow.

Work with the use cases

After you run the sample app, you can build your own integration using the sample app. Explore available use cases for the SDK. See the Basic sign-in flow example with the password factor.