Back to articles
Security & Anti-DDoS

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...

DPTCloud Engineering4 min read
Guide to Deploying Firezone with Google Workspace OIDC Integration on VPS for Secure Remote SSH Access for Developers

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:

  1. Navigate to Security > API & Services > OAuth consent screen
  2. Select "External" and fill in application details
  3. Navigate to Security > API & Services > Credentials
  4. Create an OAuth 2.0 Client ID with type "Web application"
  5. Add redirect URI: https://your-firezone-domain.com/auth/google/callback
  6. 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.

  1. Navigate to Settings > Identity Providers
  2. Select "Google Workspace" and enter the Client ID and Client Secret
  3. Select the required permissions (such as email, profile)
  4. 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:

  1. Access https://your-firezone-domain.com from a browser
  2. Select "Sign in with Google"
  3. Log in with your Google Workspace account
  4. Select the connected VPS server
  5. 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:

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
DPTCloud Tier III Infrastructure

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.

View 22 VPS Plans
ECO · vn-02

VPS-2E

94.600 ₫ / mo

10% VAT included

  • CPU: 2 vCPU
  • RAM: 2 GB
  • SSD: 30 GB NVMe
ECO · vn-02Recommended

VPS-3E

170.500 ₫ / mo

10% VAT included

  • CPU: 2 vCPU
  • RAM: 4 GB
  • SSD: 50 GB NVMe
BASIC · vn-01Recommended

VPS-05

457.600 ₫ / mo

10% VAT included

  • CPU: 4 vCPU
  • RAM: 8 GB
  • SSD: 50 GB NVMe

Related Articles

View all
ZaloZalo SupportDiscord0384 753 478