Skip to Content
Clerk logo

Clerk Docs

Ctrl + K
Go to clerkstage.dev

Authenticate with

These are all methods on the SignIn class that allow you to authenticate with different methods.

Methods

authenticateWithRedirect()

function authenticateWithRedirect(params: AuthenticateWithRedirectParams): Promise<void>;

Signs in users via OAuth. This is commonly known as Single Sign On (SSO), where an external account is used for verifying the user's identity.

AuthenticateWithRedirectParams

NameTypeDescription
strategystringThe OAuth provider that will be used for singing in. Must be one of the supported OAuthStrategy.
redirectUrlstringThe URL that the OAuth provider should redirect to, on successful authorization on their part.
redirectUrlCompletestringThe URL that the user will be redirected to, after successful authorization from the OAuth provider and Clerk sign in

Returns

TypeDescription
Promise<void>This method returns a Promise which doesn't resolve to any value.

authenticateWithMetamask()

function authenticateWithMetamask(): Promise<SignInResource>;

Starts a sign in flow that uses the Metamask browser extension to authenticate the user using their public wallet address.

Returns

TypeDescription
Promise<SignInResource>This method returns a Promise which resolves to the current SignIn.

authenticateWithWeb3()

function authenticateWithWeb3(params: AuthenticateWithWeb3Params): Promise<SignInResource>;

Starts a sign in flow that authenticates the user against their public wallet address.

AuthenticateWithWeb3Params

NameTypeDescription
identifierstringThe user's Web3 ID
generateSignature(opts: GenerateSignatureParams) => Promise<string>The method of how to generate the signature for the Web3 sign-in. See GenerateSignatureParams for more details.
GenerateSignatureParams
NameTypeDescription
identifierstringThe user's Web3 ID
noncestringThe crypographic nonce used in the sign-in.

Types

OAuthStrategy

type OAuthStrategy = |
"oauth_facebook"|
"oauth_github"|
"oauth_google"|
"oauth_hubspot"|
"oauth_tiktok"|
"oauth_gitlab"|
"oauth_discord"|
"oauth_twitter"|
"oauth_twitch"|
"oauth_linkedin"|
"oauth_dropbox"|
"oauth_bitbucket"|
"oauth_microsoft"|
"oauth_notion";

The OAuth provider that will be used for singing in. Must be one of the supported OAuthStrategy.

NameTypeDescription
oauth_facebookstringSpecify Facebook as the verification OAuth provider.
oauth_githubstringSpecify Github as the verification OAuth provider.
oauth_googlestringSpecify Google as the verification OAuth provider.
oauth_hubspotstringSpecify HubSpot as the verification OAuth provider.
oauth_tiktokstringSpecify TikTok as the verification OAuth provider.
oauth_gitlabstringSpecify GitLab as the verification OAuth provider.
oauth_discordstringSpecify Discord as the verification OAuth provider.
oauth_twitterstringSpecify Twitter as the verification OAuth provider.
oauth_twitchstringSpecify Twitch as the verification OAuth provider.
oauth_linkedinstringSpecify LinkedIn as the verification OAuth provider.
oauth_dropboxstringSpecify Dropbox as the verification OAuth provider.
oauth_bitbucketstringSpecify Bitbucket as the verification OAuth provider.
oauth_microsoftstringSpecify Microsoft as the verification OAuth provider.
oauth_notionstringSpecify Notion as the verification OAuth provider.

Was this helpful?

Clerk © 2023