Auto Browser Sniffer Testing Manual

This manual provides instructions for testing the Auto Browser Sniffer challenge using Docker and Docker Compose.

Overview

• Tests all detection scripts' ability to detect automation frameworks
• Uses Docker for easy submission and testing

Quick Start Guide

Prerequisites

• Docker
• Docker Compose

Step 0: Clone the Repository

git clone https://github.com/RedTeamSubnet/ab-sniffer-challenge.git ab_sniffer
cd ab_sniffer

Step 1: Provide Your all Scripts

• Paste all of your scripts for detection into detections folder with matching names.

Step 2: Prepare Setup

cp .env.example .env
cp ./templates/compose/compose.override.dev.yml ./compose.override.yml

Step 3: Start the Challenge Server

docker compose up -d 

Step 4: Test Your Bot

• Visit https://localhost:10001/docs
• Authenticate using provided authentication method. You can find Api-Key from .env
• Test your detection files by running the /score endpoint
• if you see the warning log(like Please visit endpoint <URI> to complete human verification for the task.) then open given uri in log in your browser to complete human verification in your side.

Important Notes

• The server runs on port 10001 by default
• Make sure port 10001 is available on your system
• All interactions are logged for analysis

Troubleshooting

If you encounter issues:

1. Check if Docker is running
2. Verify port 10001 is not in use
3. Check Docker logs using docker compose logs
4. Ensure you have proper permissions to run Docker commands