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