Creating Your Keys
By default the join.key and master.key files are automatically generated by Artifactory during the initial start up of the service.
A different key (hexadecimal encoded) can be created using the following command.
openssl rand -hex 16 /or openssl rand -hex 32
Bootstrapping with your own keys
There are two ways to manually update your keys: file copy and/or bootstrap via system.yaml file.
Bootstrapping keys using system.yaml file
This method only applies if you have installed but not started your service yet.
- Save the security section of the system yaml file with the generated string for each key using masterKey parameter for the Master Key and joinKey parameter for the Join Key.
- Start the service.
Bootstrapping the join.key using file system
This method can be used even if you already have a join.key
- Save the generated string file as join.key.
- Place each file in the
$JFROG_HOME/artifactory/var
/bootstrap/access/etc/security
directory. Add the Artifactory permissions to the directories and the join.key file. For example,
chown -R artifactory:artifactory access/etc/security/join.key
- Start the service.
Managing the join.key
By Default, a join.key is automatically generated and stored in the Access database during Access startup.
The join.key is then automatically copied by Access to Artifactory over the file system and is re-provisioned every time the services are restarted.
Access shares the join.key with Artifactory by copying it to the following location:
$JFROG_HOME/artifactory/var/etc/security/join.key
Upgrading to Artifactory 6.8 automatically initiates and generates the join.key
mechanism.
Managing join.keys in HA
There should only be one join.key
per HA cluster since the Access database is shared across all nodes of an HA cluster.
In case a join key is provided and not generated by the system, it can be provided to a single cluster node as it will be propagated to all nodes of the cluster by the system.