Skip to content

Commit

Permalink
Merge pull request #221 from levoai/okta-docs
Browse files Browse the repository at this point in the history
Adding docs for Okta integration
  • Loading branch information
mgiamberardino authored Apr 9, 2024
2 parents b706790 + 7474752 commit cb8b7fc
Show file tree
Hide file tree
Showing 6 changed files with 25 additions and 1 deletion.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/assets/Integrations/Okta/levo-logo.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
26 changes: 25 additions & 1 deletion docs/integrations/okta.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,4 +4,28 @@ sidebar_position: 4

# Okta

Watch out this space for more information on Okta integration.
## Configure Okta Integration using SAML

Follow these steps to configure the Okta Integration for your Levo organization. This will allow you to use Okta to login to the platform.

1. Navigate to Levo console IAM settings section and click on "Configure Okta" button.
2. Copy **ACS Url** and **Entity ID** to be used during the Okta app creation.
![](../assets/Integrations/Okta/levo-okta-config-acs-entity.png)
3. Navigate to the application creation screen in your Okta admin console.
4. Add the Descope app from the Okta Integration Marketplace.
5. When you first add the integration, set the name as **Levo** and click Done:
![](../assets/Integrations/Okta/add-descope-app.png)
6. Under Sign On > Advanced Sign-on Settings use the values we got in step 2:
![](../assets/Integrations/Okta/acs-url-and-entity-id.png)
7. Once you've added the app, expand the attributes field in the SAML section and add the following mapping:
![](../assets/Integrations/Okta/levo-okta-attribute-mapping.png)
8. Under Assignments in the same section, add the relevant User and Group assignments to your new application.
9. Go to Sign on methods > SAML 2.0 > Metadata details, to locate and copy your Okta Metadata URL.
10. And as a last step in the Okta app creation edit the logo of the application and replace it with the [Levo logo](../assets/Integrations/Okta/levo-logo.png) so you can identify it in your Okta dashboard.
11. Go back to Levo console and fill in the details to connect your Okta app.
- **Connection Name**: AN identifier for the connection.
- **Domain**: Email domain of your organization users.
- **Okta Metadata Url**: The Metadata URL you copied from Okta.


After that, you should be able to use this custom app to login to Levo using Okta.

0 comments on commit cb8b7fc

Please sign in to comment.