Skip to content

Commit

Permalink
Explicits the agent's requirement on the server SSL public key
Browse files Browse the repository at this point in the history
Until version 0.1.15 of Ubuntu Pro for WSL, the app explicitly requires referencing a path
to the SSL certificate on a Windows host machine.
Newer versions completely follow the Windows OS certificate stores, only requiring reference
to that certificate if the machine running the Landscape server is not trusted on a particular network.
  • Loading branch information
CarlosNihelton committed Dec 17, 2024
1 parent 6cb43e3 commit 4d63a76
Show file tree
Hide file tree
Showing 2 changed files with 18 additions and 9 deletions.
18 changes: 9 additions & 9 deletions docs/howto/set-up-landscape-client.md
Original file line number Diff line number Diff line change
Expand Up @@ -57,26 +57,26 @@ When you continue a status screen will appear confirming that configuration is c
![Configuration is complete](../assets/status-complete.png)
### Note on SSL public key
```
````

If the machine running the server is not trusted on your network you may need to
explicitly reference a path to the SSL public key on a Windows host machine.
```{warning}
Until version 0.1.15 of Ubuntu Pro for WSL, the app explicitly requires referencing a path
to the SSL certificate on a Windows host machine.
Newer versions completely follow the Windows OS certificate stores, only requiring reference
to that certificate if the machine running the Landscape server is not trusted on your network.
For example, if you followed the [Landscape Quickstart](https://ubuntu.com/landscape/docs/quickstart-deployment)
installation, the auto-generated self-signed certificate can be found at `/etc/ssl/certs/landscape_server.pem`.
This can be copied to a Windows machine:
C:\Users\\<YOUR_WINDOWS_USER_NAME>\landscape_server.pem
> C:\Users\\<YOUR_WINDOWS_USER_NAME>\landscape_server.pem
The path can then be referenced during Landscape configuration in the UP4W Windows app.
If necessary, the SSL public key can be added after the Windows host has first
been registered in Landscape.
```

````

(howto::config-landscape-client)=
## Configuring the landscape client

Expand Down
9 changes: 9 additions & 0 deletions docs/reference/landscape_config.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,4 +33,13 @@ This section contains settings used by both clients. Most keys in this section b
- `computer_title`: This key will be ignored. Instead, each WSL instance will use its Distro name as computer title.
- `hostagent_uid`: This key will be ignored.

```{warning}
The certificate referred to by the `ssl_public_key` key is used for both the
Landscape client inside the WSL instances as well as the Windows background agent.
Until version 0.1.15 of Ubuntu Pro for WSL, the app explicitly requires referencing a path
to the SSL certificate on a Windows host machine.
Newer versions completely follow the Windows OS certificate stores, only requiring reference
to that certificate if the machine running the Landscape server is not trusted on your network.
```

> See more: [GitHub | Landscape client configuration schema](https://github.com/canonical/landscape-client/blob/master/example.conf)

0 comments on commit 4d63a76

Please sign in to comment.