Skip to main content
Docs

Add Box as a social connection

You will learn the following:

  • Use Box to authenticate users with OAuth

Enabling OAuth with Box allows your users to sign up and sign in to your Clerk app with their Box account.

Configure for your development instance

For development instances, Clerk uses preconfigured shared OAuth credentials and redirect URIs—no other configuration is needed.

  1. In the Clerk Dashboard, navigate to the SSO connections page.
  2. Select Add connection and select For all users.
  3. In the Choose provider dropdown, select Box.
  4. Select Add connection.

Configure for your production instance

For production instances, you must provide custom credentials.

To make the setup process easier, it's recommended to keep two browser tabs open: one for the Clerk Dashboard and one for your Box Developer Console.

Enable Box as a social connection

  1. In the Clerk Dashboard, navigate to the SSO connections page.
  2. Select Add connection and select For all users.
  3. In the Choose provider dropdown, select Box.
  4. Ensure that both Enable for sign-up and sign-in and Use custom credentials are toggled on.
  5. Save the Redirect URI somewhere secure. Keep this modal and page open.

Create a Box app

  1. On the homepage of the Box Developer Console, select Custom App. A modal will open.
  2. Fill out the necessary information. Use Box's guide on OAuth 2.0 setup to help you.
  3. Select Next.
  4. In the list of authentication methods, select User Authentication (OAuth 2.0).
  5. Select Create App. You'll be redirected to the app's Configuration page.
  6. In the OAuth 2.0 Redirect URIs section, paste the Redirect URI value you saved from the Clerk Dashboard.
  7. In the OAuth 2.0 Credentials section, save the Client ID and Client Secret somewhere secure.

Set the Client ID and Client Secret in the Clerk Dashboard

  1. Navigate back to the Clerk Dashboard where the modal should still be open. Paste the Client ID and Client Secret values that you saved into the respective fields.
  2. Select Add connection.

Note

If the modal or page is no longer open, navigate to the SSO connections page in the Clerk Dashboard. Select the connection. Under Use custom credentials, paste the values into their respective fields.

The simplest way to test your connection is to visit your Clerk app's Account Portal, which is available for all Clerk apps out-of-the-box.

  1. In the Clerk Dashboard, navigate to the Account Portal page.
  2. Next to the Sign-in URL, select Visit. The URL should resemble:
  • For developmenthttps://your-domain.accounts.dev/sign-in
  • For productionhttps://accounts.your-domain.com/sign-in
  1. Sign in with your connection's credentials.

Feedback

What did you think of this content?

Last updated on