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

• Golang Identity Engine sample app (opens new window)
• Golang Identity Engine embedded Widget 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

The sample app is located here in the Golang embedded Sign-In Widget sample app (opens new window) respository.

1. Ensure that you've configured your Okta org properly by completing the steps in Set up your Okta org for a password factor only use case.
2. Ensure that you've completed the steps in download and set up the sample app.
3. Open the embedded Widget sample application directory using Visual Studio Code or your preferred IDE. The directory path to the sample application directory is: samples-golang/identity-engine/embedded-sign-in-widget.
4. Add an okta.yaml configuration file. See Option 1: Create a configuration file for more information on how to configure and where to place the configuration file.
5. From the command line, navigate to the Widget's sample application directory (../samples-golang/identity-engine/embedded-sign-in-widget/).
6. From the command line, execute the following command to install dependencies: go get
7. From the command line, execute the following command to start the application: go run main.go
8. In a web browser, navigate to http://localhost:8000/. The Golang embedded Widget app landing page appears.
9. Click Login.
10. On the sign-in page, enter the username (email) and password that you've used in Create your Okta account.
11. If you successfully sign in, you'll see a signed in screen customized with your name.

Troubleshoot

• If the "There was an unexpected internal error. Please try again." message appears instead of the Sign-In Widget, then verify that CORS is enabled. Follow the steps in Add a trusted origin and enable CORS to enable CORS.

Start your work with the use cases

After you successfully run the sample app, the next step is to build your integration by using the sample app as your guide. See Load the Widget to start using the Widget and explore the available use cases.

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.
2. If you haven't already done so, download and set up the sample app.
3. Open the embedded SDK sample application directory using Visual Studio Code or your preferred IDE. The directory path to the sample application is samples-golang/identity-engine/embedded-auth-with-sdk.
4. Add an okta.yaml configuration file. See Option 1: Create a configuration file for more information on how to configure and where to place the configuration file.
5. Open a terminal and navigate to the SDK's sample application directory (samples-golang/identity-engine/embedded-auth-with-sdk).
6. Run the following command: go run main.go
7. In a web browser, navigate to http://localhost:8000/. The Golang SDK sample app home page appears.
8. Click Sign In.
9. On the sign-in page, enter the username (email) and password that you used in Create your Okta account.
10. If you've successfully signed in, you'll see a signed in screen displaying your user profile information.

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 using the password factor use case.