Connect OpenId Connect Integration

Overview

This guide provides step-by-step instructions for initiating the OpenID Connect integration on the Deel platform. By following these steps, you will reach the integration setup screen, where you can configure Single Sign-On (SSO) with your identity provider (such as Okta or Azure). The process is designed for organization administrators and will prepare your account for secure SSO configuration.

Expected outcome: You will arrive at the OpenID Connect integration setup screen, ready to enter your identity provider credentials (Client ID, Client Secret, and Well-known URL).

Estimated time to complete: 5–10 minutes

Prerequisites

• Organization admin permissions on Deel
• Access to the Deel dashboard

Step-by-Step Instructions

1. Open the "More" tab in the header
2. From the Deel dashboard, locate the top navigation bar and click on the More button. This will expand a dropdown menu with additional options.

1. Select "Apps" from the dropdown menu
2. In the expanded dropdown, click on Apps. This will take you to the Apps overview page, where you can browse and manage integrations.

1. Search for "OpenID Connect" in the App Store
2. On the Apps overview page, find the search bar labeled Find apps in the upper left. Type OpenID Connect into the search bar to filter the available apps.

1. Select "OpenID Connect" from the search results
2. In the search results, locate OpenID Connect – SSO for Okta, Azure, and more. Click on this option to open the integration details page.

1. Click the "Connect OpenID Connect" button
2. On the OpenID Connect integration details page, click the Connect OpenID Connect button in the upper right. This will initiate the integration setup process and redirect you to the configuration screen.

1. Verify the integration setup screen appears
2. You should now see the OpenID Connect configuration form. This screen includes fields for Client ID, Client Secret, and Well-known URL. These credentials must be obtained from your external identity provider (such as Okta or Azure).
3. The form will auto-save your progress, and you can return to complete it later if needed.

Success Criteria

• The OpenID Connect integration setup screen is displayed, showing input fields for Client ID, Client Secret, and Well-known URL.
• You are ready to enter your identity provider credentials to complete the SSO configuration.

Troubleshooting

• Dropdown menu does not appear after clicking "More": Click the "More" tab again. If the issue persists, refresh the page or try a different browser.
• Cannot find the "Apps" option: Ensure you have organization admin permissions. If the option is missing, contact your Deel administrator.
• OpenID Connect app does not appear in search: Double-check your spelling in the search bar. If the app is still missing, verify that your organization has access to this integration or contact Deel support.
• Setup screen does not load: Refresh the page or try again. If the issue persists, clear your browser cache or contact Deel support for assistance.

Next Steps

Once you reach the setup screen, gather the required credentials from your identity provider (Client ID, Client Secret, and Well-known URL) and complete the configuration to enable SSO for your organization.