Client keys file¶
The client.keys
file stores the data used to authenticate secure agents.
Location¶
- UNIX systems
- Folder
etc
inside the installation directory. - Windows agents
- Installation directory.
File format¶
This file contains one line per each agent entry. In the case of agents, only one line is allowed, and this line must match exactly one entry in the client.keys
file at manager, otherwise the agent will be rejected.
<ID> <Name> <Address> <Password>
ID
Agent identificator number.
Allowed characters Digits only Allowed size 3 to 8 digits Padding 0-padded Unique value Yes Reserved values ID “000”
Name
Name of the agent.
Allowed characters Alphanumeric characters, -
,_
and.
Allowed size Up to 128 bytes Unique value Yes
Address
Allowed source address range in CIDR format. If specified, the manager will only accept the agent if its source IP matches this address.
Format CIDR. Netmask is optional. Unique value Yes Reserved values None Aliases any
=0.0.0.0/0
Password
String that will take part in the external message encryption.
Allowed characters Printable characters Allowed size Up to 128 bytes Unique value No
Void entries¶
Key entries can be invalidated so the related agent is considered removed: the line is discarded.
- Line starting with
#
or whitespace. - Agent name starting with
#
or!
.
Examples¶
001 server1 any bb8a28997c6c3964eacb3d32308072f6661f567a41105b2b0b09f1a82331b937
002 dbserver 10.0.1.2 363a99a6e9c9a8b6bb766d676453538e0cb20162f84b36472d99cfbef4928440
003 data2 10.1.2.0/24 3d263f5cc513072fe6b63ab221d1facf132918235c97f19efd9446257d16ea4a
004 !data3 any ed52060a133343dbc74474c19aaad8fb7dddd9a4b5965ebbe9edb2a73fd11a17