diff --git a/docs/integrations/services/ubuntu-landscape/index.md b/docs/integrations/services/ubuntu-landscape/index.md new file mode 100644 index 0000000000..63d83ba447 --- /dev/null +++ b/docs/integrations/services/ubuntu-landscape/index.md @@ -0,0 +1,58 @@ +# Ubuntu Landscape Integration + +## 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. + +!!! warning + + This requires passbook 0.10.3 or newer. + +## Preparation + +The following placeholders will be used: + + - `landscape.company` is the FQDN of the Landscape server. + - `passbook.company` is the FQDN of the passbook install. + +Landscape uses the OpenID-Connect Protocol for single-sign on. + +## passbook Setup + +Create an OAuth2/OpenID-Connect Provider with the default settings. Set the Redirect URIs to `https://landscape.company/login/handle-openid`. Select all Autogenerated Scopes. + +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: + +``` +oidc-issuer = https://passbook.company/application/o// +oidc-client-id = +oidc-client-secret = +``` + +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. + +First login with your passbook user, and make sure the user is created successfully. + +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 (, 1); +INSERT INTO person_access VALUES (, 1, 1); +``` diff --git a/mkdocs.yml b/mkdocs.yml index 14d0a194b2..b4bd44def8 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -53,6 +53,7 @@ nav: - Sentry: integrations/services/sentry/index.md - Ansible Tower/AWX: integrations/services/tower-awx/index.md - VMware vCenter: integrations/services/vmware-vcenter/index.md + - Ubuntu Landscape: integrations/services/landscape/index.md - Upgrading: - to 0.9: upgrading/to-0.9.md - to 0.10: upgrading/to-0.10.md