maltego-transform-test

Maltego Transform Test Skill

Purpose

Test a local maltego-transforms SDK server without the Maltego Desktop client, pTDS, iTDS, or any internal infrastructure. All testing is done via direct HTTP calls and Python import checks.

Prerequisites

• The SDK server must be running locally (start it with python project.py).
• No external secrets or proprietary services are required for basic testing.

Step-by-Step: Test a Transform Server

1. Syntax and Import Check

Before running the server, verify the project is importable:

# Compile-check all Python files
python -m py_compile src/transforms/*.py

# Check the project entry point imports without starting the server
# (project.py only calls run_server() under __main__, so importing is safe)
python -c "import project; print('OK')"

If these fail, fix the syntax/import errors before proceeding.

2. Start the Server (if not already running)

# project.py calls run_server() under __main__
python project.py

Verify it started:

curl -s http://127.0.0.1:8080/health | python -m json.tool
# or just check for a 200 response
curl -o /dev/null -w "%{http_code}" http://127.0.0.1:8080/api/v3/transforms

3. Check the Discovery Endpoint

curl -s http://127.0.0.1:8080/api/v3/transforms | python -m json.tool

Assert:

• Response is a JSON array/object.
• Each registered transform appears by name/ID.
• Each transform has the expected input.type_ids.

4. Check the Entity Discovery Endpoint

curl -s http://127.0.0.1:8080/api/v3/assets/entities | python -m json.tool

Assert:

• Response lists expected entity types.

5. Run a Transform via HTTP

curl -s -X POST http://127.0.0.1:8080/api/v3/transforms/<transform_id>/run \
  -H "Content-Type: application/json" \
  -d '{"input": {"metadata": {"entitiesTypesStat": {"maltego.Domain": 1}, "entitiesTotalCount": 1, "linksTotalCount": 0, "rootEntitiesCount": 1}, "graph": {"entities": [{"id": "0", "valueRef": "fqdn", "type": "maltego.Domain", "properties": [{"name": "fqdn", "type": "STRING", "value": "example.com"}], "displayInformation": []}], "links": []}}, "transformSettings": [], "limit": 12}' \
  | python -m json.tool