Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/projectdiscovery/interactsh-web

Web dashboard for Interactsh client
https://github.com/projectdiscovery/interactsh-web

Last synced: 3 months ago
JSON representation

Web dashboard for Interactsh client

Awesome Lists containing this project

README

        

# interactsh-web

[Interactsh-web](https://github.com/projectdiscovery/interactsh-web) is a free and open-source web client that displays [Interactsh](https://github.com/projectdiscovery/interactsh) interactions in a well-managed dashboard in your browser. It uses the **browser's local storage** to store and display interactions. By default, the web client is configured to use - **interachsh.com**, a cloud-hosted interactsh server, and supports other self-hosted public/authencaited interactsh servers as well.

A hosted instance of **interactsh-web** client is available at https://app.interactsh.com

interactsh-web

## Configuring Self-Hosted Interactsh Server

- Navigate to hosted interactsh-web client at https://app.interactsh.com
- Click on `oast.fun` link at top bar
- Submit domain name running self-hosted interactsh server, optionally token (for protected server)

Here is an example configuring self-hosted interactsh server with web-client:

https://user-images.githubusercontent.com/8293321/163819390-b2677f3b-4c31-4439-b258-33b8bee87bf1.mp4

## Build from Source

Note:
----

In order to run the local version of the web client, **acao-url** flag should be pointed to **localhost** while running interactsh server to avoid CORS errors. for example,

```
interactsh-server -acao-url http://localhost:3000
```

### Using Yarn

```
git clone https://github.com/projectdiscovery/interactsh-web
cd interactsh-web
yarn install
yarn start
```

### Using Docker

```
docker pull projectdiscovery/interactsh-web
docker run -it -p 3000:3000 projectdiscovery/interactsh-web
```

Once successfully started, you can access web dashboard at [localhost:3000](http://localhost:3000)

-----

### Custom configuration

You can set a custom configuration when deploying this project.
If you want to avoid the registration of your server host and token, you can give the below environnement variable to your docker-compose / server.

For this, just specify
- `REACT_APP_HOST` for the host (default: "oast.fun")
- `REACT_APP_TOKEN` for the custom token (default: "")
- `REACT_APP_CIDL` for the custom correlation id length (default: 20)
- `REACT_APP_CIDN` for the custom correlation nonce length (default: 13)

**interactsh-web** is made with 🖤 by the [projectdiscovery](https://projectdiscovery.io) team.