Install the Threat Stack AppSec Microagent

Follow these steps to instrument an application with the Threat Stack AppSec microagent.

Node.js
  1. If you are installing from a locally downloaded version of the microagent, open the Command Line window and run the following command to verify the integrity of the download:
    {{shasum -a 256 bluefyre-agent-node.tgz
      a70959f1259e425195ad0fb21359c41b36a25bb3d6f1438e4a16b1947c243e69= bluefyre-agent-node-1.2.18.tgz  }}
                 
  2. From the Command Line window, go to your Node application.
  3. Run one of the following commands to install the microagent:

    Threat Stack AppSec installs.

  4. Add a line of code to your Node.js application to initialize the Threat Stack AppSec microagent.
    1. Edit the entry point of your application, typically the index.js or server.js file.
    2. In the first line of the file, add the following command:
      var agent = require('bluefyre-agent-node')
    3. Save the file. Threat Stack AppSec now sends information back to the server when your application runs.
Python
  1. Note your Python version, platform.system value, and abiflags.
  2. Select the corresponding wheel file from the list below.
  3. If you are installing from a locally downloaded version of the microagent, open the Command Line window and run the following command to verify the integrity of the download:
    {{shasum -a 256 bluefyre_agent_python.tgz
                    
    02546ac9f08dce554adb91cd0fe16fefbe268e2490e36b10ad2cb738afdd3c92 ./bluefyre_agent_python-0.0.8-cp27-cp27m-linux_x86_64.whl
    a3ad218939482343fae5703f0452e840d56eefc0d54bdd1fdf71e1a10f57861d ./bluefyre_agent_python-0.0.8-cp27-cp27mu-linux_x86_64.whl
    1e695d5d067fc93cefd1b8162504192072df9bf8e6bc118dd1579768be057da4 ./bluefyre_agent_python-0.0.8-cp34-cp34m-linux_x86_64.whl
    3e71e861060eaf0053425a9183672d34588f672264db09188e77d429af7e9959 ./bluefyre_agent_python-0.0.8-cp35-cp35m-linux_x86_64.whl
    82b6e48dcd8735abcc949f054d654318607b240789ee28d683bf615c53cc75fb ./bluefyre_agent_python-0.0.8-cp36-cp36m-linux_x86_64.whl
    b61c8c1aa6b59d3b9373112e9ea38b4ce4f9eeef855d990e02204b91a5108f31 ./bluefyre_agent_python-0.0.8-cp37-cp37m-linux_x86_64.whl }}
  4. Use the selected wheel files to install the application:
    pip install bluefyre_agent_python-latest-cp37-cp37m-linux_x86_64.whl

Threat Stack AppSec installs.

Note

For Mac or other non-Linux environments, use the source distribution:

1ec2aeaceaa7c24766bb8a468aa28c0a0307b6b7d0265f843af753e586cabd8a  ./bluefyre_agent_python-0.0.8.tar.gz
Ruby
  1. Add the following to your application’s gem file:
    gem "threatstack-agent-ruby", :source => "https://pkg.threatstack.com/appsec/ruby/"
  2. From the Commmand Line window, run the following command to install the dependencies:
    bundle install

    Note

    “make” is required to build the agent for your application (for example, build-essential Ubuntu package)

  3. To ensure you are working with the latest version of the Ruby agent, you can run the following command from the Command Line window:
    bundle update threatstack-agent-ruby
Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request