Add a token for secure target registration

The BigFix® Remote Control Target provides an installation option to add a secure registration token. You can also add the token by running a Fixlet in the BigFix® console.

The token is used to prevent unauthorized targets from registering with the Remote Control server. Create a token on the server and use it when you install the target. The secure registration feature on the server must also be enabled.

The target sends the secure registration token to the server the first time it contacts the server. The server verifies that the token matches an existing token on the server. If the token is valid, the target is registered in the server and receives an endpoint token from the server.

Note:

The target includes the token in its callhome to the server only when it uses a secure connection to the server. The server URL that it uses to connect to the server must start with HTTPS.

The token is used to restrict new target registrations, or restrict updates to existing target details when you reinstall a target. After the target registers, the server sends a new token to the target to replace the token that was used when it registered. The target uses the new token to authenticate to the server each time it contacts the server. The feature is controlled by the rc.enforce.secure.registration property in the trc.properties file.
true
Secure target registration is enabled. Secure tokens are used to authenticate a target when it contacts the server. This value is the default value.
false
Secure target registration is disabled.

The secure registration feature is enabled by default on a new server installation when you are using the installer program. For an upgrade, you can enable it during the server installation, or after installation by editing the rc.enforce.secure.registration in the trc.properties file.
New installations
  1. Install the server
  2. Create a registration token
  3. Install the targets along with the registration token
Upgrades
  1. Upgrade the server
  2. Create a registration token
  3. Upgrade the targets along with the registration token

After you install the server, you can create a registration token. For more information about creating the token, see