In this article

DNSFilter supports SSO with any identity provider (IdP) that uses the generic OpenID Connect (OIDC) authentication process. This article covers Okta, JumpCloud, and Google Workspace.

Each section lists the IdP settings DNSFilter needs. For more detail on configuring the IdP environment, see the IdP documentation.

Okta

To configure Okta for DNSFilter SSO:

1. Follow the Okta documentation to create an OIDC app integration. Enter these settings:
   • Application type: Web Application
   • Sign-in redirect URIs: https://auth.dnsfilter.com/login/callback
   • Assignments: Controlled access
2. From the General tab, copy the Client ID and Client secret in the Client Credentials section.
3. From General Settings, copy the Discovery URL. Format the URL to match the Okta OpenID URL, such as https://{domain}.okta.com/.well-known/openid-configuration

JumpCloud

To configure JumpCloud for DNSFilter SSO:

1. Create a custom OIDC app. Add any organization-specific customizations, such as a logo.
2. Under SSO, enter:
   • The DNSFilter Redirect URI: https://auth.dnsfilter.com/login/callback
   • The DNSFilter Login URL, found in the DNSFilter dashboard after configuring the SSO connection, in the format https://app.dnsfilter.com/login/<SSO GUID> or https://app.dnsfilter.com/login/<VanityURL>
3. Assign the app to the appropriate User Groups to grant DNSFilter access.
4. Copy the Client ID and Client Secret.
5. Format the Discovery URL to match the JumpCloud OpenID URL, such as https://oauth.id.jumpcloud.com/.well-known/openid-configuration

Google Workspace

Follow the Google OAuth configuration article to create OAuth credentials. At Create Credentials, use these settings:

1. Select Web Application as the Application Type.
2. Enter the App Name.
3. Under Authorized JavaScript origins, select Add URI and enter https://auth.dnsfilter.com.
4. Under Authorized redirect URIs, select Add URI and enter https://auth.dnsfilter.com/login/callback.
5. Select Create.
6. Copy the Client ID and Client secret, or select Download JSON.
7. Format the Discovery URL to match the Google Workspace OpenID URL, such as https://accounts.google.com/.well-known/openid-configuration

Complete the setup in DNSFilter

After completing the IdP steps, follow Configure SSO in the DNSFilter dashboard to enter the IdP information and finish the setup.

Related content

• Configure single sign-on (SSO) for DNSFilter
• Configure DNSFilter SSO with Entra ID (Active Directory)