awswaf_classification.py

import os
import base64
import requests
from dotenv import load_dotenv

# Load environment variables from .env file
load_dotenv()

# CapSolver API configuration
CAPSOLVER_API_KEY = os.getenv("CAPSOLVER_API_KEY")
CREATE_TASK_URL = "https://api.capsolver.com/createTask"

# Question types for AWS WAF classification
# Grid type questions (support up to 9 images)
GRID_QUESTIONS = [
    "aws:grid:bed",
    "aws:grid:bag",
    "aws:grid:hat",
    "aws:grid:chair",
    "aws:grid:bucket",
    "aws:grid:curtain",
    "aws:grid:mop",
    "aws:grid:clock",
    "aws:grid:suitcase",
    "aws:grid:binocular",
    "aws:grid:cooking pot"
]

# Toy car city type (supports 1 image, marks endpoint of car path)
TOYCARCITY_QUESTIONS = [
    "aws:toycarcity:carcity"
]


def solve_awswaf_classification(images, question):
    """
    Classify AWS WAF image challenges.

    Args:
        images: List of base64 encoded images (up to 9 for grid, 1 for toycarcity)
        question: Question type (see GRID_QUESTIONS or TOYCARCITY_QUESTIONS)

    Returns:
        Solution containing objects (grid) or box coordinates (toycarcity)
    """
    if not images:
        raise ValueError("At least one image must be provided")

    payload = {
        "clientKey": CAPSOLVER_API_KEY,
        "task": {
            "type": "AwsWafClassification",
            "images": images if isinstance(images, list) else [images],
            "question": question
        }
    }

    # AwsWafClassification returns result directly (no polling needed)
    response = requests.post(CREATE_TASK_URL, json=payload)
    result = response.json()

    if result.get("errorId") != 0:
        raise Exception(f"Failed to solve: {result.get('errorDescription')}")

    return result.get("solution", {})


def load_images_as_base64(image_paths):
    """Helper to load multiple images as base64."""
    images = []
    for path in image_paths:
        with open(path, "rb") as f:
            images.append(base64.b64encode(f.read()).decode("utf-8"))
    return images


def main():
    if not CAPSOLVER_API_KEY:
        print("Error: CAPSOLVER_API_KEY not found in .env file")
        print("Please create a .env file with your API key:")
        print("CAPSOLVER_API_KEY=your_api_key_here")
        return

    print("AWS WAF Image Classification")

    print("\nGrid Questions (support up to 9 images):")
    for q in GRID_QUESTIONS:
        print(f"  {q}")

    print("\nToy Car City Questions (1 image):")
    for q in TOYCARCITY_QUESTIONS:
        print(f"  {q}")

    print("\nExample usage:")
    print("  # For grid challenges:")
    print('  images = load_images_as_base64(["img1.png", "img2.png", ...])')
    print('  solution = solve_awswaf_classification(images, "aws:grid:chair")')
    print("  # Returns: {'objects': [0, 2, 5]}  # indices of matching images")

    print("\n  # For toy car city:")
    print('  solution = solve_awswaf_classification([base64_image], "aws:toycarcity:carcity")')
    print("  # Returns: {'box': [x, y]}  # endpoint coordinates")


if __name__ == "__main__":
    main()