set_private_key
Description:
Private keys are used to authenticate the connecting client to the network when EAP-TLS is used as either the "phase 1" or "phase 2" 802.1x authentication method.
This function reads a private key from disk and sets the NMSetting8021x:private-key property with the private key file data if
using the BLOB scheme, or with the path to the private key file if
using the PATH scheme.
If password is given, this function attempts to decrypt the private key to verify that password is correct, and if it
is, updates the private_key_password property with the
given password. If the decryption is unsuccessful, false is returned, error is set, and no internal data
is changed. If no password is given, the private key is assumed to be valid, no decryption is performed, and the password may be
set at a later time.
WARNING: the private key property is not a "secret" property, and thus unencrypted private key data using the BLOB scheme may be readable by unprivileged users. Private keys should always be encrypted with a private key password to prevent unauthorized access to unencrypted private key data.
Parameters:
| this |
the Setting8021x |
| key_path |
when |
| password |
password used to decrypt the private key, or |
| scheme |
desired storage scheme for the private key |
| out_format |
on successful return, the type of the private key added |
Returns:
|
|