Guide to Deploying Firezone with Google Workspace OIDC Integration on VPS for Secure Remote SSH Access for Developers
A detailed guide to deploying Firezone with Google Workspace OIDC integration on a VPS, providing a secure, high-security solution for managing remote SSH access for developers and...
Firezone is an open-source solution for managing secure remote SSH access, replacing traditional methods such as direct SSH over the Internet or insecure VPNs. With Firezone, you can create a small virtual private network (VPN), integrate single sign-on (SSO) authentication via Google Workspace using the OIDC standard, and protect your VPS from external threats.
This solution is especially suitable for developers, development teams, or enterprises requiring high-security remote access to VPS servers with detailed access control. Firezone operates as an access management server rather than exposing the VPS SSH port directly to the Internet.
Requirements and Preparations Before Deployment
System Requirements
- 1 VPS server (minimum 2GB RAM, 1 vCPU, 20GB SSD)
- Operating System: Ubuntu 20.04 or 22.04 LTS
- Stable Internet connection
- Public IP address (static or dynamic)
Google Workspace Preparation
To integrate Firezone with Google Workspace, you need:
- Google Workspace account (not a regular Gmail account)
- Administrator privileges in Google Workspace
- Two-factor authentication (2FA) enabled for the admin account
Deploying Firezone on VPS
Step 1: Install Firezone
Run the following commands on the Ubuntu VPS:
# Update the system
sudo apt update && sudo apt upgrade -y
# Install Docker
sudo apt install docker.io -y
sudo systemctl enable docker
sudo systemctl start docker
# Download and run Firezone
sudo docker run -d \
--name firezone \
--restart unless-stopped \
-p 80:80 \
-p 443:443 \
-v /var/lib/firezone:/var/lib/firezone \
-e FIREZONE_ADMIN_EMAIL="[email protected]" \
-e FIREZONE_ADMIN_PASSWORD="your_secure_password" \
-e FIREZONE_SERVER_NAME="your-firezone-domain.com" \
--privileged \
firezone/firezone:latest
Step 2: Configure Google Workspace OIDC
In the Google Workspace Admin Console:
- Navigate to
Security > API & Services > OAuth consent screen - Select "External" and fill in application details
- Navigate to
Security > API & Services > Credentials - Create an OAuth 2.0 Client ID with type "Web application"
- Add redirect URI:
https://your-firezone-domain.com/auth/google/callback - Save the Client ID and Client Secret
Step 3: Integrate with Firezone
Access the Firezone admin interface at https://your-firezone-domain.com. Log in with the admin account you set up.
- Navigate to
Settings > Identity Providers - Select "Google Workspace" and enter the Client ID and Client Secret
- Select the required permissions (such as email, profile)
- Save the configuration
Managing SSH Access Permissions
After successful integration, Google Workspace users can log in to Firezone using their Google accounts. Administrators can:
- Assign SSH access permissions by Google Groups
- Set access time limits
- Monitor access history
- Disable remote access when needed
Verification and Testing
Perform the following checks after deployment:
- Access
https://your-firezone-domain.comfrom a browser - Select "Sign in with Google"
- Log in with your Google Workspace account
- Select the connected VPS server
- Establish a successful SSH connection
Alternative Solutions and Security Notes
Firezone offers a secure alternative to traditional SSH access methods. However, you should combine it with additional security measures such as:
- Running Firezone on a VPS with DDoS protection (see: Cloud VPS with L3/L4/L7 Anycast Anti-DDoS)
- Setting up a firewall (iptables) and Fail2Ban
- Integrating with monitoring systems (logs, alerts)
For enterprises needing a higher-security Federated Identity SSO solution, consider Self-Hosting Federated Identity SSO with High Security on 4GB RAM VPS using Zitadel or Authentik.
Additional Information
Firezone uses the WireGuard platform to create secure VPN connections. All data is encrypted end-to-end, and no intermediary servers store user information.
To optimize performance and security, you should:
- Regularly update Firezone
- Set strong passwords for the admin account
- Do not expose SSH ports directly on the VPS
Recommended NVMe Cloud VPS Plans to Deploy This Setup
Enterprise RAID 10 NVMe SSDs, CMC & FPT District 9 uplinks with Anycast Anti-DDoS and 99.99% SLA.
VPS-3E
10% VAT included
- CPU: 2 vCPU
- RAM: 4 GB
- SSD: 50 GB NVMe
