Authentication

ShipAny currently supports three login methods: Google Login / Google One-Tap Login / Github Login.

Other login methods will be integrated gradually. You can also refer to the next-auth documentation to implement them yourself.

Generate Auth Secret

Run in terminal:

Terminal

openssl rand -base64 32

This generates a 32-byte random string to use as Auth Secret

Modify the AUTH_SECRET value in your environment variables:

.env.development

AUTH_SECRET = "xxx"

Create a new project, go to the Credentials management page of the new project, and create an OAuth Client ID

google-console

Configure the necessary callback information according to your project’s port and production domain

callbackUrl

https://localhost:3000/api/auth/callback/google

google-clientid

After creating the OAuth Client ID, you’ll receive a Client ID and Client Secret

Enable Google login:

.env.development

AUTH_GOOGLE_ID = "4680xx-xxx.apps.googleusercontent.com"
AUTH_GOOGLE_SECRET = "GOxxx"

NEXT_PUBLIC_AUTH_GOOGLE_ENABLED = "true"

First, follow the Google login steps to obtain AUTH_GOOGLE_ID and AUTH_GOOGLE_SECRET

Modify NEXT_PUBLIC_AUTH_GOOGLE_ONE_TAP_ENABLED and NEXT_PUBLIC_AUTH_GOOGLE_ID in your configuration file

Enable Google One-Tap login:

.env.development

NEXT_PUBLIC_AUTH_GOOGLE_ONE_TAP_ENABLED = "true"
NEXT_PUBLIC_AUTH_GOOGLE_ID = "4680xx-xxx.apps.googleusercontent.com"

The NEXT_PUBLIC_AUTH_GOOGLE_ID used for Google One-Tap login should be the same as the AUTH_GOOGLE_ID configured for Google login.

Create a new OAuth app

callbackUrl

https://localhost:3000/api/auth/callback/github

github-callback

For development and production environments, you need to create two different OAuth apps with different callback URLs.

Enable Github login:

.env.development

AUTH_GITHUB_ID = "xxx"
AUTH_GITHUB_SECRET = "xxx"
NEXT_PUBLIC_AUTH_GITHUB_ENABLED = "true"