Files
zitadel/apps/login/next-env-vars.d.ts
T
d27833e1bc feat(login): redirect configuration options in multi-domain setups (#11527)
# Which Problems Are Solved

This PR introduces robust redirect configuration options and enhances
security for Server Actions in multi-domain setups.

# How the Problems Are Solved

- Redirect Fallback Logic: Implemented a unified `resolveRedirectUri`
utility that prioritizes redirect targets as follows:
  - Environment override (`DEFAULT_REDIRECT_URI`)
  - Organization settings (`defaultRedirectUri`).
  - Relative fallback (`/signedin?...`).
- Host Reflection: `DEFAULT_REDIRECT_URI` supports absolute URLs or
relative paths via host reflection.
- Server Action Security: Configured `serverActions.allowedOrigins` to
be dynamically manageable via the `SERVER_ACTION_ALLOWED_ORIGINS`
environment variable (comma-separated list). It defaults to an empty
list for maximum security.
- UI Integration: Updated the /signedin page to use the unified redirect
logic, ensuring consistent behavior for the "Continue" button.
- Documentation: Added type definitions and detailed descriptions for
new environment variables in
`next-env-vars.d.ts`

---------

Co-authored-by: Copilot <[email protected]>
2026-02-24 11:02:29 +03:00

72 lines
2.7 KiB
TypeScript

declare namespace NodeJS {
interface ProcessEnv {
// Allow any environment variable that matches the pattern
[key: `${string}_AUDIENCE`]: string; // The system api url
[key: `${string}_SYSTEM_USER_ID`]: string; // The service account id
[key: `${string}_SYSTEM_USER_PRIVATE_KEY`]: string; // The service account private key
AUDIENCE: string; // The fallback system api url
SYSTEM_USER_ID: string; // The fallback service account id
SYSTEM_USER_PRIVATE_KEY: string; // The fallback service account private key
/**
* The Zitadel API url
*/
ZITADEL_API_URL: string;
/**
* The service account token
* If ZITADEL_SERVICE_USER_TOKEN is set, its value is used.
* If ZITADEL_SERVICE_USER_TOKEN is not set but ZITADEL_SERVICE_USER_TOKEN_FILE is set, the application blocks until the file is created.
* As soon as the file exists, its content is read and ZITADEL_SERVICE_USER_TOKEN is set.
*/
ZITADEL_SERVICE_USER_TOKEN: string;
/**
* Optional: wheter a user must have verified email
*/
EMAIL_VERIFICATION: string;
/**
* Optional: custom request headers to be added to every request
* Split by comma, key value pairs separated by colon
* For example: to call the Zitadel API at an internal address, you can set:
* `CUSTOM_REQUEST_HEADERS=Host:http://zitadel-internal:8080`
*/
CUSTOM_REQUEST_HEADERS?: string;
/**
* The base path the app is served from, e.g. /ui/v2/login
*/
NEXT_PUBLIC_BASE_PATH: string;
/**
* Optional: The application name shown in the login and invite emails
*/
NEXT_PUBLIC_APPLICATION_NAME?: string;
/**
* Optional: override the redirect URI after successful login.
* If the value starts with "/", it will be used as a relative path and prepended with the host of the request (useful for rewrites).
* Otherwise, it will use the value as an absolute redirect URI.
* Takes precedence over organization settings.
*/
DEFAULT_REDIRECT_URI?: string;
/**
* Optional: Comma-separated list of additional allowed origins for Server Actions.
* Origins should include the protocol, e.g., 'https://zitadel.com,http://localhost:3000'.
* If not set, it defaults to an empty list, allowing only same-origin requests.
*/
SERVER_ACTION_ALLOWED_ORIGINS?: string;
/**
* Optional: Enable automatic code submission on page load.
* Set to "true" to auto-submit verification codes (e.g. email verification, Email OTP).
* Default behavior (undefined) requires users to click a Submit button,
* which is safer for environments with enterprise email link scanners.
*/
NEXT_PUBLIC_AUTO_SUBMIT_CODE?: string;
}
}