A. Creating an App Integration

To enable SAML integration, you need to create a new App integration through the Okta admin centre. Here are the steps for a new App integration in Okta:

1. Visit the Okta admin dashboard. On the left tab, click "Applications" and you will be directed to the Applications page, then click “Create App Integration”.
   
2. Then, a pop up will appear as follows, then select SAML 2.0 then click “Next”.
   
3. In the General Settings tab, fill in the App name field and you can leave the other fields blank. Then click "Next" to continue.
   
   

   You can fill in the App name field by using the Mekari product name that you want to integrate (for example: "Talenta").

4. Then you will be directed to the Configure SAML tab, where you can fill in the Single sign-on URL and Audience URL (SP Entity ID) with https://account.mekari.com/users/sign_in as a temporary placeholder.
   
5. Then scroll down the page and click “Next”.
   
6. After that, you will be directed to the Feedback tab. In the Are you a customer or partner? column, you can select the “I’m an Okta customer adding an internal app” option in the column and you can tick the “It’s required to contact the vendor to enable SAML” option in the Contact app vendor column.
   
7. Then, scroll to the bottom of the page, and click “Finish”.
   
8. If successful, the app will be created and you will be redirected to the app page.
   

B. SAML Configuration Process

Before setting up SAML integration in Okta, you need to send the SAML configuration data to Mekari's specialist/activation team to be able to process the integration setup in the Mekari Account. Here are the steps:

1. On the application page you have created, click the “Sign On” tab.
   
2. Scroll down the page until you find the Metadata URL field. Copy and send the url to the Mekari specialist/activation team.
   
3. After that, the Mekari specialist/activation team will provide you with the configuration details that you need to apply to your application.

C. Integration of Mekari Account with Okta

After you get the configuration data, you can proceed to the integration stage between Mekari Account and Okta. Here are the steps:

1. In the email you received, you will get details about the basic SAML configuration which contains the Entity ID and ACS URL. To set this configuration, you can go to the application page, then select the General tab.
   
2. Scroll down the page, and in the SAML Setting section, click "Edit".
   
3. Then, you will be directed to the Edit SAML Integration page, and on the General Settings tab, click "Next".
   
4. After that, you will be directed to the SAML Configuration page, then in the Single sign-on URL with the ACS URL from the email, and also fill in the Audience URI (SP Entity ID) with the Entity ID from the email.
   
5. Then, in the Application username column, make sure that the option you choose points to the user attribute data that has the same value as the email address column that you entered when making an Invitation from the Mekari product.
   For example, in the picture below, the "Okta username" attribute points to the user email address that is also used in Talenta.
   
6. After that, scroll down to the bottom and click “Next”.
   
7. Then on the Feedback tab, click “Finish”.
   
8. After finishing the integration set up process, you can check whether the integration process has gone well or not, but make sure you have set the user you want to test in the app. Check out the guide here.