Auth

SSO and Social Login with WorkOS

Use Social Login with WorkOS

Step 1. Create a WorkOS organization

Log in to the WorkOS dashboard and visit the Organizations tab to create an organization. Create an Organization

Alternatively, you can create an organization via the WorkOS API.

Step 2. Obtain your Client ID and WORKOS_API_KEY values

Get your Environment's Client ID and Secret

Visit the getting started page of the WorkOS Dashboard. Copy the following values from the Quickstart panel:

  • WORKOS_CLIENT_ID
  • WORKOS_API_KEY

Step 3. Add your WorkOS credentials to your Supabase project

Enter your WorkOS application details in your Supabase app's auth provider settings panel

  1. Go to your Supabase Project Dashboard.
  2. In the left sidebar, click the Authentication icon (near the top).
  3. Click on Providers under the Configuration section.
  4. Click on WorkOS from the accordion list to expand.
  5. Toggle the WorkOS Enabled switch to ON.
  6. Enter https://api.workos.com in the WorkOS URL field.
  7. Enter your WorkOS Client ID and WorkOS Client Secret saved in the previous step.
  8. Copy the Callback URL (for OAuth) value from the form and save it somewhere handy.
  9. Click Save.

You can also configure the WorkOS auth provider using the Management API:

1
# Get your access token from https://supabase.com/dashboard/account/tokens
2
export SUPABASE_ACCESS_TOKEN="your-access-token"
3
export PROJECT_REF="your-project-ref"
4
5
# Configure WorkOS auth provider
6
curl -X PATCH "https://api.supabase.com/v1/projects/$PROJECT_REF/config/auth" \
7
  -H "Authorization: Bearer $SUPABASE_ACCESS_TOKEN" \
8
  -H "Content-Type: application/json" \
9
  -d '{
10
    "external_workos_enabled": true,
11
    "external_workos_url": "https://api.workos.com",
12
    "external_workos_client_id": "your-workos-client-id",
13
    "external_workos_secret": "your-workos-client-secret"
14
  }'

Step 4. Set your Supabase redirect URI in the WorkOS Dashboard

Visit the WorkOS dashboard and click the redirects button in the left navigation panel.

On the redirects page, enter your Supabase project's Callback URL (for OAuth) which you saved in the previous step, as shown below:

Set your Supbase project redirect URL in the WorkOS dashboard

Step 5. Add login code to your client app

When a user signs in, call signInWithOAuth with workos as the provider.

1
async function () {
2
  const { ,  } = await ..({
3
    : 'workos',
4
    : {
5
      : 'http://example.com/auth/v1/callback', // Make sure your redirect URL is configured in the Supabase Dashboard Auth settings
6
      : {
7
        : '<connection_id>',
8
      },
9
    },
10
  })
11
12
  if (.) {
13
    (.) // use the redirect API for your server or framework
14
  }
15
}

Within your specified callback URL, you'll exchange the code for a logged-in user profile:

1
import { NextResponse } from 'next/server'
2
import { createClient } from '@/utils/supabase/server'
3
4
export async function GET(request: Request) {
5
  const { searchParams, origin } = new URL(request.url)
6
  const code = searchParams.get('code')
7
  // if "next" is in param, use it as the redirect URL
8
  let next = searchParams.get('next') ?? '/'
9
  if (!next.startsWith('/')) {
10
    // if "next" is not a relative URL, use the default
11
    next = '/'
12
  }
13
14
  if (code) {
15
    const supabase = await createClient()
16
    const { error } = await supabase.auth.exchangeCodeForSession(code)
17
    if (!error) {
18
      const forwardedHost = request.headers.get('x-forwarded-host') // original origin before load balancer
19
      const isLocalEnv = process.env.NODE_ENV === 'development'
20
      if (isLocalEnv) {
21
        // we can be sure that there is no load balancer in between, so no need to watch for X-Forwarded-Host
22
        return NextResponse.redirect(`${origin}${next}`)
23
      } else if (forwardedHost) {
24
        return NextResponse.redirect(`https://${forwardedHost}${next}`)
25
      } else {
26
        return NextResponse.redirect(`${origin}${next}`)
27
      }
28
    }
29
  }
30
31
  // return the user to an error page with instructions
32
  return NextResponse.redirect(`${origin}/auth/auth-code-error`)
33
}

Resources