This repository has been archived on 2024-05-31. You can view files and clone it, but cannot push or open issues or pull requests.
authentik/website/docs/integrations/services/ubuntu-landscape/index.md

61 lines
2.0 KiB
Markdown
Raw Normal View History

---
title: Ubuntu Landscape
---
2020-09-18 21:50:11 +00:00
## What is Ubuntu Landscape
From https://en.wikipedia.org/wiki/Landscape_(software)
:::note
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.
:::
2020-09-18 21:50:11 +00:00
:::warning
2020-12-05 21:08:42 +00:00
This requires authentik 0.10.3 or newer.
:::
2020-09-18 21:50:11 +00:00
## Preparation
The following placeholders will be used:
2021-03-02 21:10:54 +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
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);
```