Client Authentication¶
When using LXD over https, LXD uses an asymmetric keypair for authentication. The keypairs are added to the authentication database after entering the LXD instance’s “trust password”.
Generate a certificate¶
To generate a keypair, you should use the openssl command. As an example:
openssl req -x509 -newkey rsa:2048 -keyout lxd.key -nodes -out lxd.crt -subj "/CN=lxd.local"
For more detail on the commands, or to customize the keys, please see the documentation for the openssl command.
Authenticate a new keypair¶
If a client is created using this keypair, it would originally be “untrusted”, essentially meaning that the authentication has not yet occurred.
>>> from pylxd import Client
>>> client = Client(
... endpoint='http://10.0.0.1:8443',
... cert=('lxd.crt', 'lxd.key'))
>>> client.trusted
False
In order to authenticate the client, pass the lxd instance’s trust password to Client.authenticate
>>> client.authenticate('a-secret-trust-password')
>>> client.trusted
>>> True