Skip to content

kkrypt0nn/project-absence

Project Absence

Discord Server Badge Crates.io Badge Docker Badge CI Badge Dependency Status Badge

Last Commit Badge Conventional Commits Badge


Caution

This is a WIP tool that is very unstable and not fully optimised, use at your own care! This README will also be reworked.

πŸ‘οΈ Uncover the unseen

Project Absence is an OSINT (Open Source Intelligence) tool designed to assist cybersecurity professionals, engineers, and system administrators in identifying publicly available information related to their digital infrastructure.

To maintain an OSINT-only approach, the tool contacts each discovered domain or server only once, to extract information based on the returned content - valuable data that can help and lead to further discoveries.

More features are in development.

Getting Started

Rust Features

Project Absence has the following Rust features available:

  • clipboard: Will let you use the --clipboard/-C command line argument, only necessary if you want to copy the result to your clipboard (the result is saved in a file at ~/.absence/result.{json,md} either way)

Installation

To install Project Absence, you can use one of the following methods:

Cargo

You need to have Rust installed. You can then install using:

cargo install project-absence

Docker

You can run the tool from the published Docker image using:

docker run -v ~/.absence:/root/.absence -it kkrypt0nn/project-absence

Docker compose

You can run the tool from a docker-compose.yml file, for example:

services:
  project-absence:
    image: kkrypt0nn/project-absence:latest
    volumes:
      - ${HOME}/.absence:/root/.absence

And then run it with

docker compose run project-absence

Build from source

You need to have Rust installed. After cloning this repository you can build it using:

cargo build --release

Note

On Linux systems, you have to install the following packages if you want to use the --clipboard/-C CLI argument:

  • libxcb1-dev
  • libxcb-render0-dev
  • libxcb-shape0-dev
  • libxcb-xfixes0-dev

They are required for the clipboard crate to work properly. The usage of the crate may be put behind a feature in the future so that you are not forced to install these packages.

Example Usage

Using the tool is straightforward. You may look at the documentation website for the config and CLI arguments that you can pass.

After editing the config as you wish, running the tool with no specific CLI arguments is as simple as doing

project-absence -d <your-domain>

Documentation

Full documentation is available here. It includes detailed explanations of arguments and configurations.

Troubleshooting

If you encounter issues while using Project Absence, consider the following:

Disclaimer

Use responsibly and lawfully. Project Absence is a tool designed to assist cybersecurity professionals, engineers, and system administrators in identifying publicly available information related to their digital infrastructure. Do not use it against systems you do not own or explicitly have permission to test.

By using this tool, you agree to comply with all applicable laws and abide by the Terms of Use.

Contributing

Note

Contributions are more than welcome after the v1.0.0 release which can be tracked here.

People may contribute by following the Contributing Guidelines and the Code of Conduct

License

This project was made with πŸ’œ by Krypton and is under the MIT License.

About

πŸ‘οΈ Uncover the unseen

Topics

Resources

License

Code of conduct

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •