BeVigil-cli

Description

A powerful command-line interface (CLI) for extracting various types of assets from Android applications. This tool is designed to help security researchers and penetration testers in their work.

Features

• Extracts URL parameters associated with an android package ID.
• Extracts subdomains associated with a domain.
• Provides tab autocompletion for easy usage.
• Can be integrated into your project using the BeVigil class from the bevigil package.
• Supports various functions to query BeVigil API and extract data.

Functions

• getHostsFromPackage(package_id) => Returns JSON data containing hosts extracted from a package ID.
• getPackagesFromDomain(domain) => Returns JSON data containing android package IDs associated with a domain.
• getPackagesFromSubdomain(subdomain) => Returns JSON data containing android package IDs associated with a subdomain.
• getParamsFromPackage(package_id) => Returns JSON data containing URL parameters associated with a package ID.
• getS3bucketsFromKeyword(keyword) => Returns JSON data containing S3 bucket URLs associated with a keyword.
• getS3bucketsFromPackage(package_id) => Returns JSON data containing S3 bucket URLs associated with a package ID.
• getSubdomainsFromDomain(domain) => Returns JSON data containing subdomains associated with a domain.
• getUrlsFromDomain(domain) => Returns JSON data containing URLs associated with a domain.
• getWordlistFromPackage(package_id) => Returns JSON data containing a wordlist associated with a package ID.

Demonstration

Tab Autocompletion

Tab autocompletion of commands can be activated either by adding an entry manually to your shell config file or using BeVigil-cli inbuilt option.

Manually

For auto completion of commands, user needs to write specific entry to their shell file.

Bash

$ eval  "$(_BEVIGIL_CLI_COMPLETE=bevigil-bash bevigil-cli)" >> ~/.bashrc

Zsh

$ eval  "$(_BEVIGIL_CLI_COMPLETE=zsh-source bevigil-cli)" >> ~/.zshrc

Fish

$ eval (env _BEVIGIL_CLI_COMPLETE=fish-source bevigil-cli) >> ~/.config/fish/completions/foo-bar.fish

Automatically

$ bevigil-cli init --api-key <api_key> --autocomplete

This command allows BeVigil-cli to automatically detect your shell type and write appropriate shell config file with correct entry. Once the entry is added, user needs to restart the terminal for the changes to take effect.

Code Integration

---

To integrate the tool in your project, simply import the BeVigil class from bevigil package.

In [1]: from bevigil import BeVigil
In [2]: bevigil = BeVigil(api_key="API_KEY")
In [3]: packages = bevigil.get_packages_from_domain(domain="netflix.com")
In [4]: wordlist = bevigil.get_urls_from_domain(domain="netflix.com")

Demo

---

The following media demonstrates how BeVigil class can be utilized for extraction of assets.

> Visit BeVigil OSINT CLI Website <