providers/cognito

Built-in Cognito integration.

default()

default<P>(options): OAuthConfig< P >

Add Cognito login to your page.

Setup

Callback URL

https://example.com/api/auth/callback/cognito

Configuration

import Auth from "@auth/core"
import Cognito from "@auth/core/providers/cognito"

const request = new Request(origin)
const response = await Auth(request, {
  providers: [
    Cognito({
      clientId: COGNITO_CLIENT_ID,
      clientSecret: COGNITO_CLIENT_SECRET,
      issuer: COGNITO_ISSUER
    })
  ]
})

Resources

• Cognito OAuth documentation

Notes

You need to select your AWS region to go the the Cognito dashboard.

tip

The issuer is a URL, that looks like this: https://cognito-idp.{region}.amazonaws.com/{PoolId}

PoolId is from General Settings in Cognito, not to be confused with the App Client ID.

danger

Make sure you select all the appropriate client settings or the OAuth flow will not work.

By default, Auth.js assumes that the Cognito provider is based on the Open ID Connect specification.

tip

The Cognito provider comes with a default configuration. To override the defaults for your use case, check out customizing a built-in OAuth provider.

Disclaimer

If you think you found a bug in the default configuration, you can open an issue.

Auth.js strictly adheres to the specification and it cannot take responsibility for any deviation from the spec by the provider. You can open an issue, but if the problem is non-compliance with the spec, we might not pursue a resolution. You can ask for more help in Discussions.

Type parameters

Parameter
P extends CognitoProfile< P >

Parameters

Parameter	Type
options	OAuthUserConfig< P >

Returns

OAuthConfig< P >