Summary
This article describes an alternative method to access the CAS administration web interface for CAS users via the Cloudflare “Zero Trust” tunnel: “cloudflared”.
Technical explanation
Cloudflare offers (amongst it's rich services) a tunnel daemon that can expose your port to your company while hiding your CAS server IP and protecting your system. The cloudflared daemon is used for this purpose. The recommended procedure for accessing the Admin interface is still via VPN, however the Cloudflare Zero Trust tunnel provides a more user-friendly alternative with sufficient security.
...
You must have a Cloudflare account (free) and use their DNS services (not free) to employ this option.
...
Overview:
Create your Cloudflare tunnel
Restrict access via Cloudflare
Automating access via Google
Troubleshooting
...
Create your Cloudflare tunnel
Navigate to: https://one.dash.cloudflare.com/
1. Create a tunnel.
...
2. Enter a descriptive name:
...
3. Save it.
...
4. Select your Operating System (debian) and architecture (64-bit):
...
5. Execute the installation command on your CAS HOST:
...
Paste it into your SSH window on your CAS system, and
press Enter.
...
6. Enter the tunnel endpoints.
...
All tunnel configuration is performed at this web page (no configuration at the CAS server).
the Subdomain will be used in your browser, i.e. the “admin” in:
https://admin.yourcasdomain.comChoose your Domain (it should already be listed in the dropdown box).
Type must be
HTTPS.The URL for the CAS admin is the same as “Admin IP” as shown by
batm-manage info:e.g. 10.3.2.2:7777
...
Click on “TLS”, and
enable the option “No TLS Verify”.
...
7. Finally:
Save it (click “Save tunnel” in the bottom right corner).
...
It is not protected from threat actors though, and you’re not quite done yet. You’ll need to restrict access to the page by changing one more tunnel setting, and configuring Google access.
...
Restrict access via Cloudflare
You need to setup some authorization rules in a new Cloudflare “application”. These rules will determine who is permitted access to the newly shared subdomain.
Navigate to: https://one.dash.cloudflare.com/
Open “Access”, then “Applications”:
...
Create a new “Application”:
...
Choose “Self-hosted”
Fill in the details:
...
The Application name will be displayed on the login page, and is not critical.
Session Duration is the time before re-authorization is required. When the authorization expires, the user attempting to access your domain will have to either enter a new PIN, or login to Google (again).
Subdomain should be the same as what you entered in Step 6 of tunnel creation.
Domain is one of the Cloudflare-handled domains you have registered with them.
Scroll down, click NEXT.
Create an “Allow” Policy
...
Name the policy something meaningful for authorizing CAS access, e.g. “CAS Access”.
Action: “Allow” enables only people that pass the “included” rules to be permitted access.
Next, add “Include” rules to the new policy. All rules will “allow” access:
...
This example “Include rule” will allow access to anyone with a generalbytes.com email.
The rules are tricky. Keep it simple to get it working now, then play with the settings later. Add yourself (or your email domain if you have one) as the single rule and move on to the next step.
Scroll down, click NEXT. Skip the next page.
Scroll down, click Add application.
...
Finished:
Now you’ve restricted access to the subdomain to only the people that pass the “Include rules”.
...
Only people you’ve added to the “Include rules” will receive a PIN.
Next, you can (optionally) configure Google to automate more of this process.
...
Automating access via Google
Google can authenticate users for you, and forward the authenticated info to Cloudflare for comparison against your rules. Currently (as configured above), Cloudflare will send a PIN to the email (if they’re on the Allow list) which is requesting access, and after entering the PIN - the user will be permitted to access the subdomain . If the user has a Google-managed email, then they can skip a step (if not - they’re stuck using a PIN).
...
Now, when you access the subdomain, you should also be offered a Google login (instead of just a PIN):
...
Troubleshooting
You may start the Cloudflared daemon in the foreground to watch live activity.
Stop the daemon:
sudo systemctl stop cloudflaredStart it manually:
| Code Block |
|---|
/usr/bin/cloudflared --no-autoupdate tunnel run --token insert_your_token_here |
Logs
Working directory for the daemon using this article:
/usr/local/etc/cloudflared
...