Reconness Universal Wrapper is a wrapper/framework that assists with creating Reconness Agents within the Reconness Web Application. It provides additional functionality that is not currently possibile in reconness and can only be added by modifying the source code of the agent or making a wrapper for it. It does this by allowing you to use "subsitutions" when executing commands.
For example Massdns requires a file with a list of domains to be used as an argument. In reconness there is no way to create that file thus you need to make your own wrapper that calls reconness's API and creates a file as the argument. Instead you can use the universal wrapper:
./bin/massdns -r lists/resolvers.txt domains.txt
reconness-universal-wrapper exec "./bin/massdns -r lists/resolvers.txt *subdomains -w *outputFile" -a api/targets/exportSubdomains/{{target}}/{{rootDomain}} --silent
Subsitutions can be used to replace an argument within the command you're executing. The current subsitutions are:
| subsitutions | E xplination |
|---|---|
| *subdomains | Replaces a file input with a list of all subdomains from the specified API endpoint |
| *outputFile | Replaces the output file with a temp file & displays it's content in stdout, so that the reconness agent can parse it |
| *outputDir/*.ext | Replaces the output directory with a temp directory & will display every file with the specified extension to stdout e.g 'outputDir/*.txt' will print all txt files in the temp directory, while `outputDir/.` will print all files in the output directory |
| Flags | Explination |
|---|---|
| -c, --config | (optional)location of the config file (default is $HOME/.rwrapper.yaml) |
| --debug | Enable debug mode |
| -h, --help | Display help menu |
| --silent | Don't print the commands output |
reconness-universal-wrapper exec "go [redacted]/tools/naabu -hL *subdomains -silent" -a api/targets/exportSubdomains/{{target}}/{{rootDomain}}
reconness-universal-wrapper exec "python3.8 [redacted]/tools/OneForAll/oneforall.py --target *subdomains --path *outputDir/*.txt run" --silent
reconness-universal-wrapper exec "massdns -r [redacted]/tools/massdns/lists/resolvers.txt *subdomains -w *outputFile -o S" -a api/targets/exportSubdomains/{{target}}/{{rootDomain}}
go get -u github.com/hiddengearz/reconness-universal-wrapper
reconness-universal-wrapper setup -u <reconness username> -p <reconness password> -s <https://reconness.mydomain.com:8080>
Modify your Reconness Dockerfile by adding the following to the Agents dependencies section.
RUN apt-get update && apt-get install -y git
RUN apt-get install -y wget
RUN wget https://dl.google.com/go/go1.13.linux-amd64.tar.gz
RUN tar -C /usr/local -xzf go1.13.linux-amd64.tar.gz
RUN echo "export PATH=$PATH:/usr/local/go/bin" >> ~/.profile
RUN /usr/local/go/bin/go get -u github.com/hiddengearz/reconness-universal-wrapper
RUN cd /root/go/bin/ && ./reconness-universal-wrapper setup -u <reconness username> -p <reconness password> -s <https://reconness.mydomain.com:8080>If you change your reconness username, password or domain name you'll need to update the config aswell. You can do this by typing the following in the cli/docker container cd ./root/go/bin/reconness-universal-wrapper setup -u <new username> -p <new password> -s <new domain> --force
| Flags | Explination |
|---|---|
| -c, --config string | location to save the config file too (default is $HOME/.rwrapper.yaml) |
| -f, --force | If an existing config is found, overwite it (default is $HOME/.rwrapper.yaml) |
| -h, --help | help for setup |
| -p, --password string | password used to connect to reconness server |
| -s, --server string | domain name for reconness server e.g https://reconness.mydomain.com:8080 |
| -u, --username string | username used to connect to reconness server |