Overview
The Auth Wall feature allows you to restrict access to your deployments by requiring user authentication. This is particularly useful for protecting sensitive environments, such as staging or preview deployments, ensuring that only authorized users can access them. You can locate the Auth Wall settings by navigating to Environment > Config > Auth Wall.Configuration Modes
The Auth Wall has three main configuration modes:Disabled
No authentication requirement for any deployments. All content is publicly accessible.
All Endpoints
Every page and endpoint across all domains requires authentication. Maximum security.
Preview Only
Only preview deployments require authentication. Production deployments remain publicly accessible.
Setting Up Auth Wall
1
Navigate to Auth Wall config
Go to Environment > Config and select the Auth Wall tab in the left-hand sidebar
2
Choose protection mode
Select one of the three configuration modes based on your security needs
3
Add authorized users
Add users who should have access to the protected deployments (see Managing Authorized Users below)
4
Save configuration
Click Save to apply the Auth Wall settings
Managing Authorized Users
The Auth Users section allows you to manage the list of users who have access to the deployment when the Auth Wall is enabled.Viewing Authorized Users
A table displays the list of users with access. Each row includes:- Email: The email address of the authorized user
- Last Login: The timestamp of the user’s last login (if available)
- Checkbox: A checkbox to select the user for removal
Adding Users
1
Click Add User
Click the Add User button (indicated by a
+ icon)2
Enter credentials
You will be prompted to enter:
- User’s email address
- Password for the user
3
Confirm
Click create to add the user. They can now access protected deployments.
Removing Users
To remove a user:- Select the user by checking the box next to their email
- Click the Remove Selected button to revoke their access
Session Management
By default, a user remains logged in for a maximum of 24 hours. After this period, they will need to re-authenticate.Sessions are managed server-side for security. Closing the browser does not immediately invalidate the session.
Use Cases
Staging Protection
Protect staging environments from public access while sharing with your team and stakeholders.
Preview Deployments
Secure preview deployments for feature branches, allowing only team members to review changes.
Client Reviews
Create secure environments for client reviews before going live, with controlled access.
Internal Tools
Protect internal tools and dashboards from unauthorized access.
Best Practices
- Limit access - Only add users who need access to the deployment to minimize security risks
- Regularly review users - Periodically review the list of authorized users and remove those who no longer need access
- Use for sensitive environments - Enable the Auth Wall for environments that contain sensitive data or are not ready for public access
- Strong passwords - Use strong, unique passwords for each authorized user
- Combine with other security measures - The Auth Wall is a layer of protection but should not be used as the primary layer to secure your application
Troubleshooting
Users cannot access the deployment
Users cannot access the deployment
- Ensure the Auth Wall is enabled and the user is added to the authorized users list
- Verify that the user is logging in with the correct credentials
- Check if the user’s session has expired (24-hour limit)
- Try clearing browser cookies and logging in again
Deployment is still public
Deployment is still public
- Check the protection scope. If “Protect only deployment previews” is selected, published deployments will remain public
- Ensure the Auth Wall is enabled and the settings have been saved
- Verify you’re accessing the correct environment
Changes not applied
Changes not applied
- Make sure to click the Save button after making changes to the Auth Wall settings
- Refresh the page to see if settings were saved
- Check browser console for any errors
Session expires too quickly
Session expires too quickly
- Sessions last for 24 hours by default
- User must log in again after session expiration
- This is by design for security purposes
Security Considerations
- Not a replacement for app-level security - Auth Wall protects access to deployments, but your application should still implement its own authentication and authorization
- Password security - Passwords are encrypted and stored securely
- Session security - Sessions are managed server-side and cannot be easily hijacked
- IP logging - Last login information helps track access patterns
- Immediate revocation - Removing users takes effect immediately for new requests