VLT-Website-Heading

How to add your app to the Okta Integration Network marketplace

Jun 21, 2020 1:30:02 PM / by Vu Long Tran

If you're looking to add your app to the Okta Integration Network marketplace, here's a quick guide on how I have submitted an app there.

Okta Verified and now part of Okta Integration Network

This aims to supplement the guide from the Okta team on how to List your app to the How to add my app to OIN (Okta Integration Network) sharing my experiences going through it. 

So, let's give you a sense of what we are talking about here and then I can walk you through how I submitted an app to the OIN (Okta Integration Network).

First off, what is the OIN (Okta Integration Network)?

What is OIN (Okta Integration Network)?

Okta Integration Network marketplace

Okta Integration Network (OIN) is a list of pre-built applications prepared and ready to use for Okta customers. Admins can simply go to Okta admin panel > Applications > Add Application and simply add and configure applications for their users.

Why add an app to the Okta Integration Network (OIN) marketplace ?

If you are working for a vendor like me, you want to make it easier for your customers to be able to set up and configure your application on Okta platform. As any steps that helps to reduce the configuration errors, will save everyone time.

For my example, I will be looking to add an SSO SAML app to the Okta Integration Network (OIN) marketplace.

 

How to add your app to the Okta Integration Network Marketplace?

To add your app to the Okta Integration Network you need to do the following:

  1. To list an application in the Okta Integration Network, you first need to sign up for an Okta developer account.
  2. Add your app into Okta and test to make sure it is working properly.
  3. Submit your request via Okta's ISV Portal, and this will create a ticket automatically with Okta's team

Here is a step-by-step walkthrough of the steps below:

Step 1 - Create an Okta Developer account (if you don't have one already)

You will need to have an Okta account, you will need to use only a developer account to be able to submit an app. So you can sign up for an Okta developer test account.

Please note that you need to use a Preview/Developer account for Submitting your app.

Using a production account for application submission is not possible.

Step 2 - Set up your app on Okta as usual

Set up your app in Okta as per usual using your Okta developer account. ​

I was setting up a SAML 2.0 SSO app. So I was following steps following Okta's guide here: "Preparation steps to set up SSO here ".

Once you get it successfully up and running, then you can look to register your app.

 

Step 3 - Submit app your app to the Okta Integration Network (OIN) ISV portal

After you've tested that your app works with Okta.

You can start looking at submitting your app on Okta's ISV Portal, this will create a ticket automatically with the Okta application team which will review your app and contact you in regards to your submission.

You can do so following this current link:

Okta Integration Network ISV submission

 

Step 4 - Submit your app in the Okta Integration Network (OIN) ISV portal

Once ready, fill in the required details and submit your app in the Okta Integration Network (OIN) ISV portal.

Here are some notes from Okta for your submission:

  • Your app has to support at least one protocol: SAML, SCIM or OIDC.
  • If you want to support more than one, you don't need to do everything at once. For example, you can submit OIDC now and add SAML or SCIM support later.
  • If you want to add a SWA (Secure Web Authentication) app: If the application that you want to add is a SWA application, you may need to Contact Okta Support, describing why you need the application to be added to OIN, provide us the link of the application login page and any other details that you think might be helpful.

Okta Integration Network application form

 

Step 5 - Wait for Okta team to get back to you on your app

After you have submitted your app integration, the Okta engineers will review and test it. Okta keep you updated about where you are in the review process.

Estimated time to completion for your app submission:

  • Initial review by Okta - 5 business days
  • QA testing by Okta - 5 business days
  • Publication to the OIN Catalog - 3 business days

All submissions go through these phases. Okta will update you by email for any remediations arising from the initial review and QA testing phases.

At any point, you can check the status of your submission here in Okta's OIN ISV Portal Manager.

Step 6 - Work with Okta team to test and confirm app is working

The Okta team will reach out and ask you questions around how your app integration will work. 

If it is same process for me, ask you to set up their test organisation on Okta. Once you have successfully working, you will be asked to finalise the app submission via the Okta ISV portal, by selecting the Publish button there.

The Okta team will let you know when it is ready to proceed with that step.

 

Step 7 - Review published app on Okta Integration Network marketplace

Review published app and documentation for the Okta Integration Network (OIN) marketplace.

 

Step 6 - Enjoy your new app on the Okta Integration Network marketplace

Enjoy your new app on the Okta Integration Network marketplace. This should make things easier for your customers to get set up with your company's product on Okta.

Here's the app I added for the company I'm working for right now :)

Okta Verified and now part of Okta Integration Network

Enjoy!

Topics: tech, okta, developer

Vu Long Tran

Written by Vu Long Tran

Solutions Engineer APAC. ex-@Forrester consultant. Writing on #cloud #howto guides and #tech tinkering!