README

Overview

Custom module that provides admin redirect functionality for Upanup Drupal sites.

• Package: Upanup
• Version: 10.x-2.0
• Drupal compatibility: ^9.0 || ^10 || ^11

Requirements

• Drupal 10 or 11
• DNS record pointing to the server IP or domain (e.g. name.admin.upanup.com, admin.domain.com, name.admin.domain.com)
• Alternatively use a wildcard DNS record (e.g. *.domain.com or *.admin.domain.com)
• SSL certificate for the domains, can also be a wildcard

Installation

1. Enable the module: drush en upanup_admin
   • Or through Drupal admin, navigate to ** Extend ** and enable Upanup Admin
2. Navigate to Administration > Upanup Admin > Settings to configure.
3. Ensure DNS and SSL are configured before enabling.

Features

Admin Redirect

An event subscriber (CustomAdminRedirect) fires on every request and can redirect anonymous users to or from the admin domain. Three redirect strategies are supported, configurable via the settings form:

• Upanup Admin — uses the name.admin.upanup.com subdomain pattern. Requires an Admin Name.
• Admin Domain — uses the admin.domain.com subdomain pattern. Optionally accepts a Custom Admin Name to override the admin prefix (e.g. custom.domain.com).
• Admin Subdomain — uses the name.admin.domain.com subdomain pattern. Requires an Admin Name and optionally a Custom Admin Name to override the admin prefix.

The redirect is only applied to anonymous users and targets login/logout routes (user.login, user.logout). If the upanup_auth or samlauth modules are present, login/logout routes are also included.

Configuration

Navigate to Admin > Configuration > User Interface > Upanup Admin (/admin/upanup_admin).

Requires the administer upanup_admin permission.

Permissions

Notes

• Update .htaccess to redirect only root domains to www.
• Add admin subdomains to the Shield module allowlist domains configuration.