Skip to content

Commit

Permalink
docs: update Docker instructions
Browse files Browse the repository at this point in the history
  • Loading branch information
NSEcho committed Sep 13, 2024
1 parent 61a9250 commit 5688f36
Show file tree
Hide file tree
Showing 5 changed files with 40 additions and 0 deletions.
40 changes: 40 additions & 0 deletions Dockerfile.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,40 @@
# Introduction
furlzz in a Docker container works using `frida-portal` where the application is run and joined to the frida-portal.
Once we did that we can use furlzz to connect to that portal and fuzz the application.

## Building

```bash
$ git clone https://github.com/NSEcho/furlzz.git && cd furlzz/
$ docker build -t furlzz .
```

![Building Docker image](./building_docker_image.png)

## Usage

Download `frida-portal` for your OS and architecture from [here](https://github.com/frida/frida/releases/latest) and run it as
`sudo ./frida-portal-16.5.1-macos-arm64 --cluster-endpoint=0.0.0.0 --control-endpoint=0.0.0.0`.

Make sure to note the IP address of the network which the device can reach (private IPv4 address assuming that both devices are on the same network).

Then run the application and join the portal using `frida-join`.

![Joining portal](./joining_portal.png)

Once all these steps are finished, run `frida-ps` on the portal to get the correct name of the application (`frida-ps -H portalIPv4Address`).

![Running frida-ps](./running_frida-ps.png)

Now create your inputs directory and run the container.

```bash
$ mkdir inputs
$ echo -n '13333337' > ./inputs/1
$ docker run -v /local/path/to/inputs/directory:/tmp/inputs -it --rm furlzz fuzz -b BASE_URL \
-f FUNCTION_TO_APPLY_TO_INPUTS -i /tmp/inputs/ -t TIMEOUT \
-m METHOD -a NAME_RETURNED_BY_FRIDA-PS -d OPTIONAL_DELEGATE \
-n IPv4 address of the portal
```

![Fuzzing](./running_container.png)
Binary file added building_docker_image.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added joining_portal.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added running_container.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added running_frida-ps.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit 5688f36

Please sign in to comment.