The test-tcell Developer Hub

Welcome to the test-tcell developer hub. You'll find comprehensive guides and documentation to help you start working with test-tcell as quickly as possible, as well as support if you get stuck. Let's jump right in!

Quick Start Guide

This guide should get you started with tCell

TCell by Rapid7 is a next-gen cloud web application firewall (WAF) and runtime application self-protection (RASP) tool that gives you complete visibility into your application and provide defense in depth.

You can sign up for tCell here.

Login

When you sign up for , you will receive a Rapid7 Insight account. If you did not receive a login email, please contact Rapid7 Support.

Visit the Rapid7 Insight Platform at https://insight.rapid7.com and enter your credentials to access .

Creating Your First App

monitors and protects your web applications. Creating an app within enables it to know that all the data that is coming to it from the agents are all associated with a single app instance. You must create a new app for each unique application in your environment.

To create an application, click on the tCell Admin button in the top toolbar to launch the "Admin" panel. In the Admin panel, select the first tab called "Applications" and click the Add Application button. The "Add Application" window will appear. Enter a name for your application, and optionally enter a description and tag to easily identify and group your applications in the future. Click the Add application button.

After you have created your app, you should see it in the table on the Admin > Applications screen. Note that every app has a unique "Application Id" that is used throughout the system.

Installing Server Agent

An agent is a software application that integrates with your web application and web server code to monitor all incoming requests, and block malicious requests that can attack your application.

This quick start will assume that you have a Java application. To set up an agent in your server, go to Admin > Download Agent , select Java, and follow the instructions.

Start your Application

You should now start your application, and you should be able to see some initial data go to the dashboard.

In your console, click the Home link the sidebar to visit the application dashboard. On the upper left side of the dashboard, you will see the name of your application and a button showing the number of agents you currently have installed.

Hover over the button to reveal a link for the Agents Dashboard. Click the Agents Dashboard link to open the "Server Agents" dashboard. You should see the one agent you have installed, displaying the IP and host name of the system it's installed on.

Sanity Checks

Some simple checks can be performed to see if things are not working properly:

  1. Check via the browser developer console or similar to see if there are CSP headers in the response body from the application.
  2. Check via the browser developer console or similar to see if JSAgent is being loaded in page.
  3. Check the tcell.log file in the tcell folder for recent activity. If you are testing with a Rails project, check to see if there are any recent writes to the ./tcell directory.

Quick Start Guide


This guide should get you started with tCell

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.