Skip to content

RyosukeDTomita/airis-burp-extensions

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

AIris: Artificial Intelligence Request Insight System

mit license Test codecov OpenSSF Scorecard Scorecard supply-chain security CodeQL

AIris

INDEX


ABOUT

This is an Burp Suite extension that allows you to LLM custom API key and API endpoint, and send the selected request and response from within Burp Suite as context for analysis by an LLM.

Why AIris?

  • Burp AI is not supported in the free version of Burp Suite.
  • Some companies only allow the use of organization-managed AI services, such as Azure OpenAI, Amazon Bedrock.

Not BApp Store Extension

Note

This extension was not accepted into the BApp Store because it uses custom LLM not Burp AI. In detail, See this discussion.

Supported LLMs

  • OpenAI
  • Azure OpenAI
  • Anthropic Claude
  • (Planned) Amazon Bedrock Claude

HOW TO USE

  1. Open Burp Suite and add .jar file. You can download from latet releases or build for yourself. extensions
  2. Move to AIris Config tab and put your API key, endpoint, and preferred model. Don't forget to push Save button. api-key
  3. Select Burp Suite's HTTP history tab, right-click on a request or response, and send to AIris Analysis tab then you can write your prompt. right_click_menu your prompt
  4. Move to AIris Analysis tab right click on the request and push Send Request button. Then you can see the analysis result from LLM. response result

Note

If you are unable to get satisfactory results, please check Airis Analysis tab result area or Logger tab(Built-in Burp Suite) for error messages. AIris Analysis tab Logger tab

Using Azure Open AI

Replacing the endpoint will make it work. Include the model name and version as shown below.

https://<your-resource-name>.openai.azure.com/openai/deployments/<deployment-name>/chat/completions?api-version=<api-version>
e.g. https://sigma-oai-westus.openai.azure.com/openai/deployments/gpt-40-mini/chat/completions?api-version=2024-02-15-preview

Using Amazon Bedrock(Claude)

I'll test it soon. Looking for volunteers to help verify functionality.


ENVIRONMENT

This project is just Vibe Coding right now. I'm improveing it little by little.

  • Docker Image: gradle:9.0.0-jdk21-noble
  • Java: 21
    • montoya-api: 2025.7
  • Gradle: 9.0.0

For Developers

BUILD

cd airis
./build.sh

Format code

cd airis
./gradlew fmt

Test code

cd airis
./gradlew test --tests <ClassName of Test.java>
# print debug
./gradlew test --tests <ClassName of Test.java> --info
# all test
./gradlew test

BApp Store acceptance criteria(self check)

This extension is designed to meet the security- and quality-related acceptance criteria required for the BApp Store:

1. It performs a unique function

Yes. I could not find any other extension in BApp Store with a similar name. Reference: #Not BApp Store Extension

2. It has a clear, descriptive name

Yes (I think so).

3. It operates securely

Yes

  • API keys are masked when writing logs.
  • API keys are stored in encrypted form.

4. It includes all dependencies

Yes. All dependencies are managed via Gradle and shaded into a single airis-burp.jar during ./gradlew jar, so BApp users need no additional installations. In detail: see build.gradle.kts.

5. It uses threads to maintain responsiveness

Yes. All the HTTP requests to external LLM services use threads and work in the background.

6. It unloads cleanly

Yes. Extension.registerUnloadingHandler() is used to register an unload handler.

7. It uses Burp networking

Yes. All the HTTP requests to external LLM services are made via Montoya API.

8. It supports offline working

Out of scope. This Extension use network communication with online llm services via Burp's integrated AI platform.

9. It can cope with large projects

Yes.

10. It provides a parent for GUI elements

Yes. All GUI elements are parented to SwingUtils.suiteFrame().

11. Montoya API Artifact Usage

Yes. This extension uses the official montoya-api artifact via Gradle.

12. Montoya API for AI Functionality

Out of scope. Because this extension does not use Burp AI(Montoya API for AI Functionality).


About

Burp Suite extensions for analyzing requests and responses using an organization-controlled LLM, instead of Burp AI.

Topics

Resources

License

Security policy

Stars

Watchers

Forks

Languages