Create the .auto.tfvars
variables file:
cp config/template.tfvars .auto.tfvars
Set the required variables:
landscape_server_fqdn
- This will be the internet FQDN for the Landscape server. It is best to use a real domain for this.landscape_certbot_email
- Required while settingcertbot
certificates.
Create the infrastructure:
terraform init
terraform apply -auto-approve
This project currently uses the quickstart
mode for installation. The following are references for such configuration:
- Ubuntu Pro Dashboard
- Landscape quickstart deployment
- Landscape self-hosted documentation
- Landscape self-hosted setup
Elevate your privileges in the server session:
sudo su -
Make sure cloud init executed properly
cloud-init status
Important
Make sure you don't skip the next step. Change the "example.com" to your owned domain of choice.
Setup your domain registry for the landscape.example.com
to the public IP or AWS EC2 instance name.
Note
The project is created with an Elastic IP, therefore the public IP address will not change.
Make sure that the DNS has replicated successfully before continuing:
dig landscape.example.com
Attach the server to your Ubuntu Pro subscription. You're currently allowed 5 machines in the Personal free subscription.
pro attach
Set the session variables:
export FQDN=$(aws ssm get-parameter --name "landscape-server-fqdn" --query "Parameter.Value" --output text)
export CERTBOT_EMAIL=$(aws ssm get-parameter --name "landscape-server-certbot-email" --query "Parameter.Value" --output text)
Set your hostname using variables:
hostnamectl set-hostname "$FQDN"
Install Landscape:
apt update && DEBIAN_FRONTEND=noninteractive apt-get install -y landscape-server-quickstart
Install your certificate:
Important
Make sure the certificate is correctly issued and installed
certbot --non-interactive --apache --no-redirect --agree-tos --email $CERTBOT_EMAIL --domains $FQDN
Your server should be ready for use at https://landscape.example.com
.
Access the server and create your administrator account.
In case this come in handy, these are the commands to manage the Landscape Server CTL:
lsctl status
lsctl restart
This project uses a locally deployed bear metal remote Ubuntu 22.04 Desktop. Create a Ubuntu image. The recommended burning tool is Balena.
Note
Using Ubuntu 22.04 as of the time of this project Ubuntu Pro des not support 24.04 USG, which is part of this scope of experimentation.
Make sure all packages are updated:
sudo apt update
sudo apt upgrade -y
Set up XRDP to manage your machine remotely. This project follows this Digital Ocean's article.
sudo apt install xfce4 xfce4-goodies -y
sudo apt install xrdp -y
sudo systemctl status xrdp
Once logged into your Ubuntu Desktop workstation, attach the machine for Ubuntu landscape management.
The ubuntu-pro-client
should already be installed. Just make sure it is updated:
# This will update the client ot the latest version
sudo apt install -y ubuntu-pro-client
Note
You should be using a Let's Encrypt certificated issued earlier in this documentation. In for some reason you're opting for a self-signed approach, check how to set it up in the client.
Attach the Ubuntu Desktop machine to a license:
sudo pro attach
Now, from your Ubuntu Landscape Server, follow the instructions on how to register a computer vi the menu. The path should be something like this:
https://landscape.example.com/account/standalone/how-to-register
These are examples of commands to be executed in the Ubuntu Desktop client machine:
sudo apt-get update
sudo apt-get install -y landscape-client
# Replace the domain
sudo landscape-config --computer-title "MyUbuntuDesktop" --account-name standalone --url https://landscape.example.com/message-system --ping-url http://landscape.example.com/ping
Note
Make sure to check Ubuntu Pro status in Landscape to confirm it has been properly registered.
In case script execution needs to be enabled.
sudo -u landscape bash -x /opt/canonical/landscape/scripts/update_security_db.sh
Configuration file:
/etc/landscape/client.conf
Restarting the client:
sudo service landscape-client restart
Ubuntu Pro supports Ubuntu Security Guide (USG). For quick guide, the tutorial can be o good starting point.
Following the installation guide:
Note
This is already covered by the previous steps already executed
- Install the UA client
- Attach the subscription
Enable and install USG:
sudo ua enable usg
sudo apt install usg
This project uses CIS benchmarks, for which there are different profiles:
Tip
Check the CIS Benchmark publications for in-depth details about each profile
- Level 1: Balanced
- Level 2: Restrictive
To apply the benchmark, select one of the profiles:
# Profiles: cis_level1_workstation, cis_level2_workstation
sudo usg fix <PROFILE>
A system reboot
is required after this point.
Then, run the audit command:
Tip
Once the audit below is completed, access the HTML page for analysis
# Profiles: cis_level1_workstation, cis_level2_workstation
sudo usg audit <PROFILE>
To access the file from another user:
cp usg-report-xxx.html /home/user/Desktop/
chown <user>: /home/<user>/Desktop/usg-report-20241110.1302.html
To apply for a set of systems:
sudo usg generate-fix <PROFILE> --output fix.sh
If required, explore the customization options.
Other references include the Ubuntu engagement page, and the CIS Benchmark Ubuntu page.