2020-11-15 21:42:02 +00:00
---
title: Ubuntu Landscape
---
2020-09-18 21:50:11 +00:00
2022-06-15 19:31:34 +00:00
< span class = "badge badge--secondary" > Support level: Community< / span >
2020-09-18 21:50:11 +00:00
## What is Ubuntu Landscape
2023-07-31 10:16:58 +00:00
> Landscape is a systems management tool developed by Canonical. It can be run on-premises or in the cloud depending on the needs of the user. It is primarily designed for use with Ubuntu derivatives such as Desktop, Server, and Core.
>
> -- https://en.wikipedia.org/wiki/Landscape_(software)
2020-09-18 21:50:11 +00:00
2023-01-13 15:22:03 +00:00
:::caution
2020-12-05 21:08:42 +00:00
This requires authentik 0.10.3 or newer.
2020-11-15 21:42:02 +00:00
:::
2020-09-18 21:50:11 +00:00
## Preparation
The following placeholders will be used:
2022-05-09 19:22:41 +00:00
- `landscape.company` is the FQDN of the Landscape server.
- `authentik.company` is the FQDN of the authentik install.
2020-09-18 21:50:11 +00:00
Landscape uses the OpenID-Connect Protocol for single-sign on.
2020-12-05 21:08:42 +00:00
## authentik Setup
2020-09-18 21:50:11 +00:00
2021-02-16 18:18:57 +00:00
Create an OAuth2/OpenID-Connect Provider with the default settings. Set the Redirect URIs to `https://landscape.company/login/handle-openid` . Select all Managed Scopes.
2020-09-18 21:50:11 +00:00
Keep Note of the Client ID and the Client Secret.
Create an application and assign access policies to the application. Set the application's provider to the provider you've just created.
## Landscape Setup
On the Landscape Server, edit the file `/etc/landscape/service.conf` and add the following snippet under the `[landscape]` section:
```
2020-12-05 21:08:42 +00:00
oidc-issuer = https://authentik.company/application/o/< slug of the application you ' ve created > /
2020-09-18 21:50:11 +00:00
oidc-client-id = < client ID of the provider you ' ve created >
oidc-client-secret = < client Secret of the provider you ' ve created >
```
Afterwards, run `sudo lsctl restart` to restart the Landscape services.
## Appendix
To make an OpenID-Connect User admin, you have to insert some rows into the database.
2020-12-05 21:08:42 +00:00
First login with your authentik user, and make sure the user is created successfully.
2020-09-18 21:50:11 +00:00
Run `sudo -u postgres psql landscape-standalone-main` on the Landscape server to open a PostgreSQL Prompt.
Then run `select * from person;` to get a list of all users. Take note of the ID given to your new user.
Run the following commands to make this user an administrator:
```sql
INSERT INTO person_account VALUES (< user id > , 1);
INSERT INTO person_access VALUES (< user id > , 1, 1);
```
