https://github.com/hacker1024/mitmproxy_ri_client.dart

A Dart client for the mitmproxy Remote Interceptions addon.
https://github.com/hacker1024/mitmproxy_ri_client.dart

dart dart-library dart-package dartlang mitm mitmproxy mitmproxy-addons websocket websocket-client

Last synced: 16 days ago
JSON representation

A Dart client for the mitmproxy Remote Interceptions addon.

• Host: GitHub
• URL: https://github.com/hacker1024/mitmproxy_ri_client.dart
• Owner: hacker1024
• License: mit
• Created: 2022-05-28T13:18:16.000Z (over 2 years ago)
• Default Branch: master
• Last Pushed: 2023-05-07T14:32:22.000Z (over 1 year ago)
• Last Synced: 2024-10-13T11:44:17.368Z (about 1 month ago)
• Topics: dart, dart-library, dart-package, dartlang, mitm, mitmproxy, mitmproxy-addons, websocket, websocket-client
• Language: Dart
• Homepage: https://pub.dev/packages/mitmproxy_ri_client
• Size: 80.1 KB
• Stars: 2
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# mitmproxy_ri_client

A Dart client for the [mitmproxy Remote Interceptions][addon] addon.

## Features

This package enables access to all functionality provided by the [mitmproxy Remote Interceptions][addon] addon, including:

- A HTTPS-compatible proxy server provided by [mitmproxy]

- Interception and modification of all HTTP(S) requests and responses

- Dynamic interception filtering based on summarised request and response data

## Usage

### Quick start

1. Familiarize yourself with [mitmproxy] and the [mitmproxy Remote Interceptions][addon] addon.

2. Import the package:

```dart

import 'package:mitmproxy_ri_client/mitmproxy_ri_client.dart' as mitm_ri;

```

3. Now, intercept to your heart's content:

```dart

final client = await mitm_ri.Client.connect(

  // Add a header to every response.

  handleResponse: (request, response) {

    return mitm_ri.MessageSet(

      response: response!.copyWith(

        headers: {

          ...response.headers,

          'X-MITM-Dart-Example': ['Hello, world!'],

        },

      ),

    );

  },

);

```

## Additional information

The interception flow is described in detail in the [mitmproxy Remote Interceptions][addon] addon [WebSocket API

documentation](https://github.com/hacker1024/mitmproxy_remote_interceptions/blob/master/API.md#flow-stages).

[mitmproxy]: https://mitmproxy.org

[addon]: https://github.com/hacker1024/mitmproxy_remote_interceptions