Get credentials from Apple
1
Register an App ID
- Sign in to Apple Developer and go to Certificates, Identifiers & Profiles.
- Under Identifiers, click + and choose App IDs.
- Select App as the type, then fill in your bundle identifier (e.g.
com.example.app). - Scroll to Capabilities and enable Sign In with Apple.
- Save the App ID.
2
Create a Services ID
The Services ID is your OAuthclient_id for web and non-iOS flows.- Under Identifiers, click + and choose Services IDs.
- Enter a description and an identifier (e.g.
com.example.app.auth). - Enable Sign In with Apple.
- Click Configure next to Sign In with Apple:
- Set your Primary App ID to the one you just created.
- Add your domain (e.g.
auth.example.com, no trailing slash, no protocol). - Add your Return URL (e.g.
https://auth.example.com/auth/oauth/callback/apple).
- Save and register.
Configuration
lib/theauth.ts
name and email scopes by default and sends a PKCE challenge. Scopes you pass are added to those.
Generate the client secret
Apple does not accept a static client secret. Instead, you generate a JWT signed with your.p8 private key. The JWT is valid for up to 6 months, so you can generate it once and rotate it before it expires.
scripts/generate-apple-secret.ts
APPLE_CLIENT_SECRET environment variable. Re-run before the 6-month window closes.
The
jose library is a dependency of theAuth. Install it in your own project if your script imports it directly.Environment variables
.env
APPLE_CLIENT_ID and APPLE_CLIENT_SECRET are needed at runtime. The Team ID and Key ID are only used when regenerating the secret.
iOS native apps
The provider has no separate setting for native apps. A native flow would use the App ID (bundle identifier) as the client ID, but no endpoint in the
oauth() plugin accepts a code obtained by Apple’s native SDK, so native Sign in with Apple is not supported by the plugin today.Localhost and development
Apple requires HTTPS for redirect URIs.localhost will not work. Options:
- ngrok,
ngrok http 3000gives you a public HTTPS URL instantly. - cloudflared tunnel, persistent tunnel with a stable subdomain.
- mkcert + local proxy, run a local HTTPS reverse proxy with a self-signed cert trusted by your browser.
baseUrl config to match the tunnel URL while developing.
User data
Apple embeds user claims in theid_token JWT returned from the token endpoint. The provider decodes it without verifying the signature, and throws if the sub or email claim is missing.
Endpoints
Theoauth() plugin registers the same routes for every provider:
Related
OAuth overview
Generic OAuth 2.0 setup and account linking behavior.
Another popular sign-in provider using OIDC.
Microsoft
Sign in with Microsoft Entra ID for personal and work accounts.
Authentication overview
All sign-in methods available in theAuth.