Skip to main content

Configuring SSO with OIDC (OAuth 2.0)

Connect your identity provider to Yeeflow with OpenID Connect, then verify the callback URL and test member sign-in.

Organization administrators can add an OpenID Connect (OIDC) sign-in method in Yeeflow. Before you begin, make sure you can manage the application registration in your identity provider and still have access through an existing administrator sign-in method.

Understanding OIDC and OAuth 2.0

OAuth 2.0 lets an application obtain limited access to protected resources. It uses access tokens to authorize requests.

OpenID Connect adds sign-in to OAuth 2.0. The identity provider authenticates the user and returns an ID token to Yeeflow. The ID token is a JSON Web Token (JWT) containing claims about the sign-in.


Configure OIDC

Set up the application at your identity provider, then add it in Yeeflow:

OIDC setup between Yeeflow and an identity provider. Copy the provider’s metadata URL into Yeeflow, register the Yeeflow callback URL with the provider, then verify, save, enable, and test sign-in in Yeeflow.

1. Obtain OIDC Configuration Details:

From your identity provider, obtain the OIDC metadata URL and the client ID and client secret for the same application registration. Confirm the exact claim names your provider returns for the user’s display name and email address.

2. Access the Yeeflow Admin Center:

Log in to Yeeflow as a system administrator and navigate to the Yeeflow Admin Center.

3. Open Login Authentication Settings:

In the left navigation menu of the Admin Center, find the "Login Authentication" menu and click on it to open the page.

In the Yeeflow Admin Center, Security is expanded and Login authentication is highlighted.

4. Add Custom Login Method:

Find the "Custom Login Method" section and click on the "Add Custom Login Method" button at the bottom.

5. Select OIDC as the Login Method:

From the drop-down list of available custom login methods, choose "OIDC (OAuth 2.0)" to configure OIDC as the method for user authentication.

The Add custom login method menu shows OIDC (OAuth 2.0) as an available option.

6. Enter OIDC Configuration Details:

In the OIDC dialog, enter the following settings:

  • Name. Choose a label that members will recognize on the organization’s sign-in page.

  • OIDC metadata URL. Enter the provider’s OpenID Connect discovery document URL.

  • Client ID and Client Secret. Enter both values from the same provider application registration.

  • Response Type. Use the default code for the authorization code flow.

  • Scope. Start with email openid profile. The openid scope is required. The email scope requests email claims, and profile requests profile claims such as the user’s name.

  • Property: Name and Property: Email. Enter the claim names confirmed by your provider.

Copy the Callback URL shown in Yeeflow. Register it exactly as shown as a redirect URI in the same provider application.

7. Save and Test Configuration:

Click Verify and save. If verification fails, check the metadata URL, application credentials, and registered callback URL before trying again.

8. Enable the OIDC Login Method:

Under Custom login method, open the menu for your OIDC method and select Enable. Keep your administrator session open. In a separate browser session, open your organization’s sign-in page and test the OIDC method with an authorized member account.

The OIDC login method menu shows Enable beneath Edit.

9. Adjust Other Login Settings (if necessary):

You can further customize the login experience by configuring other settings such as default login method, login page customization, or enabling multi-factor authentication (MFA).

By following these steps, you can configure OIDC user authentication as the custom login method for Yeeflow. Users will be able to authenticate using their OIDC credentials and access Yeeflow with their OIDC identity.


​

Did this answer your question?