要約

When attempting to install a Bamboo agent with the security token option enabled, the installation may fail with the one of the following error:

"Security token is required for preliminary authentication, but none was provided. Please obtain the token from https://bamboo-url.com/admin/agent/addRemoteAgent.action"

"Security token verification failed. Please obtain the correct token from https://bamboo-url.com/admin/agent/addRemoteAgent.action"

環境

This issue has been observed with Bamboo version 9.2.13, but it is applicable to any version of Bamboo.

診断

Below errors can be seen during the agent installation process.

• Below error occurs when there is no security token passed:

  "Security token is required for preliminary authentication, but none was provided. Please obtain the token from https://bamboo-url.com/admin/agent/addRemoteAgent.action"

• Below error occurs when an incorrect security token passed:

  "Security token verification failed. Please obtain the correct token from https://bamboo-url.com/admin/agent/addRemoteAgent.action"

原因

In Bamboo, there is an option to enable security token verification during the agent installation process. When this option is activated, a valid security token must be provided during the agent installation.

ソリューション

Solution 1:

1. Get the valid security token by navigating to Bamboo administration > Build resources > Agents > Install remote agent page.

2. Validate the value set for the parameter wrapper.app.parameter.3 in the <bamboo-agent-home>/conf/wrapper.conf file.
   1. If the value is incorrect or empty, edit it to the correct token obtained from step 1.

   2. If the line is missing, add the following entry after wrapper.app.parameter.2:

      wrapper.app.parameter.3=<VALID_SECURITY_TOKEN>

3. After updating the valid security token, stop the Bamboo agent if it is running, and then start it again.

Solution 2:

1. Stop the Bamboo agent if it is running and then delete the <AGENT_HOME_DIR> 

2. Install the Bamboo agent by executing the following command by substituting

   • <AGENT_HOME_DIR> with agent's home directory,

   • <BAMBOO_URL> with your Bamboo server's URL

   • <TOKEN> with the valid security token by navigating to Bamboo administration > Build resources > Agents > Install remote agent

$ java -Dbamboo.home=<AGENT_HOME_DIR> -jar atlassian-bamboo-agent-installer-9.2.13.jar <BAMBOO_URL>/agentServer/ -t <TOKEN>

By following these steps, you should be able to successfully install the Bamboo agent with the security token option enabled. If you continue to experience issues, please consult the Bamboo documentation or contact support for further assistance.