# 
---
### Open Source Vulnerability Manager
Security has two difficult tasks: designing smart ways of getting new information, and keeping track of findings to improve remediation efforts. With Faraday, you may focus on discovering vulnerabilities while we help you with the rest. Just use it in your terminal and get your work organized on the run.
Faraday was made to let you take advantage of the available tools in the community in a truly multiuser way.
Faraday aggregates and normalizes the data you load, allowing exploring it into different visualizations that are useful to managers and analysts alike.
To read about the latest features check out the [release notes](https://github.com/infobyte/faraday/blob/master/RELEASE.md)!
## Install
---
### Docker-compose
The easiest way to get faraday up and running is using our docker-compose
```shell
$ wget https://raw.githubusercontent.com/infobyte/faraday/master/docker-compose.yaml
$ docker-compose up
```
If you want to customize, you can find an example config over here [Link](https://docs.faradaysec.com/Install-guide-Docker/)
### Docker
You need to have a [Postgres](https://github.com/infobyte/faraday/wiki/Install-Guide) running first.
```shell
$ docker run \
-v $HOME/.faraday:/home/faraday/.faraday \
-p 5985:5985 \
-e PGSQL_USER='postgres_user' \
-e PGSQL_HOST='postgres_ip' \
-e PGSQL_PASSWD='postgres_password' \
-e PGSQL_DBNAME='postgres_db_name' \
faradaysec/faraday:latest
```
### PyPi
```shell
$ pip3 install faradaysec
$ faraday-manage initdb
$ faraday-server
```
### Binary Packages (Debian/RPM)
You can find the installers on our [releases page](https://github.com/infobyte/faraday/releases)
```shell
$ sudo apt install faraday-server_amd64.deb
# Add your user to the faraday group
$ faraday-manage initdb
$ sudo systemctl start faraday-server
```
Add your user to the `faraday` group and then run
### Source
If you want to run directly from this repo, this is the recommended way:
```shell
$ pip3 install virtualenv
$ virtualenv faraday_venv
$ source faraday_venv/bin/activate
$ git clone git@github.com:infobyte/faraday.git
$ pip3 install .
$ faraday-manage initdb
$ faraday-server
```
Check out our documentation for detailed information on how to install Faraday in all of our supported platforms
For more information about the installation, check out our [Installation Wiki](https://github.com/infobyte/faraday/wiki/Install-Guide).
In your browser now you can go to http://localhost:5985 and login with "faraday" as username, and the password given by the installation process
## Getting Started
---
Learn about Faraday holistic approach and rethink vulnerability management.
- [Centralize your vulnerability data](https://faradaysec.com/centralize-vulnerability-data/)
- [Automate the scanners you need](https://faradaysec.com/automate-scanners/)
### Integrating faraday in your CI/CD
**Setup Bandit and OWASP ZAP in your pipeline**
- [GitHub](https://faradaysec.com/wp-content/whitepapers/Integrating%20Faraday%20-%20Part%20One.pdf) [PDF]
- [Jenkins](https://faradaysec.com/wp-content/whitepapers/Integrating%20Faraday%20-%20Part%20Two.pdf) [PDF]
- [TravisCI ](https://faradaysec.com/wp-content/whitepapers/Integrating%20Faraday%20-%20Part%20Three.pdf) [PDF]
**Setup Bandit, OWASP ZAP and SonarQube in your pipeline**
- [Gitlab](https://faradaysec.com/wp-content/whitepapers/Integrating%20Faraday%20-%20Part%20Four.pdf) [PDF]
## Faraday Cli
---
Faraday-cli is our command line client, providing easy access to the console tools, work in faraday directly from the terminal!
This is a great way to [automate scans](https://docs.faraday-cli.faradaysec.com/), integrate it to [CI/CD pipeline](https://docs.faraday-cli.faradaysec.com/) or just get [metrics](https://docs.faraday-cli.faradaysec.com/) from a workspace
```shell
$ pip3 install faraday-cli
```
Check our [faraday-cli](https://github.com/infobyte/faraday-cli) repo
Check out the documentation [here](https://docs.faraday-cli.faradaysec.com/).
## Faraday Agents
---
[Faraday Agents Dispatcher](https://github.com/infobyte/faraday_agent_dispatcher) is a tool that gives [Faraday](https://www.faradaysec.com) the ability to run scanners or tools remotely from the platform and get the results.
## Plugins
---
Connect you favorite tools through our [plugins](https://github.com/infobyte/faraday_plugins). Right now there are more than [80+ supported tools](https://github.com/infobyte/faraday/wiki/Plugin-List), among which you will find:
Missing your favorite one? [Create a Pull Request](https://github.com/infobyte/faraday_plugins/issues)!
There are two Plugin types:
**Console** plugins which interpret the output of the tools you execute.
```shell
$ faraday-cli tool run \"nmap www.exampledomain.com\"
💻 Processing Nmap command
Starting Nmap 7.80 ( https://nmap.org ) at 2021-02-22 14:13 -03
Nmap scan report for www.exampledomain.com (10.196.205.130)
Host is up (0.17s latency).
rDNS record for 10.196.205.130: 10.196.205.130.bc.example.com
Not shown: 996 filtered ports
PORT STATE SERVICE
80/tcp open http
443/tcp open https
2222/tcp open EtherNetIP-1
3306/tcp closed mysql
Nmap done: 1 IP address (1 host up) scanned in 11.12 seconds
⬆ Sending data to workspace: test
✔ Done
```
**Report** plugins which allows you to import previously generated artifacts like XMLs, JSONs.
```shell
faraday-cli tool report burp.xml
```
Creating custom plugins is super easy, [Read more about Plugins](http://github.com/infobyte/faraday/wiki/Plugin-List).
## API
---
You can access directly to our API,
check out the documentation [here](https://api.faradaysec.com/).
## Links
* Homepage: [faradaysec.com](https://www.faradaysec.com)
* Documentation: [Faraday Docs](https://docs.faradaysec.com)
* Download: [Download .deb/.rpm from releases page](https://github.com/infobyte/faraday/releases)
* Issue tracker and feedback: [Github issue tracker](https://github.com/infobyte/faraday/issues)
* Frequently Asked Questions: [FaradaySEC FAQ](https://docs.faradaysec.com/FAQ/)
* Twitter: [@faradaysec](https://twitter.com/faradaysec)
* Try one of our [Demos](https://demo101.faradaysec.com/#/login)
Raw data
{
"_id": null,
"home_page": "https://github.com/infobyte/faraday",
"name": "faradaysec",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": null,
"keywords": "security tools",
"author": "Faradaysec",
"author_email": "devel@faradaysec.com",
"download_url": "https://files.pythonhosted.org/packages/07/9a/8a9ff5e27e112a0b4b1cdb2eb182b6b9731d9ab2f4eb907e06cbbf23a44d/faradaysec-5.2.1.tar.gz",
"platform": null,
"description": "# \n\n\n---\n\n\n### Open Source Vulnerability Manager\n\nSecurity has two difficult tasks: designing smart ways of getting new information, and keeping track of findings to improve remediation efforts. With Faraday, you may focus on discovering vulnerabilities while we help you with the rest. Just use it in your terminal and get your work organized on the run.\nFaraday was made to let you take advantage of the available tools in the community in a truly multiuser way.\n\nFaraday aggregates and normalizes the data you load, allowing exploring it into different visualizations that are useful to managers and analysts alike.\n\n\n\n\n\n\n\nTo read about the latest features check out the [release notes](https://github.com/infobyte/faraday/blob/master/RELEASE.md)!\n\n\n## Install\n\n---\n\n### Docker-compose\n\nThe easiest way to get faraday up and running is using our docker-compose\n\n```shell\n$ wget https://raw.githubusercontent.com/infobyte/faraday/master/docker-compose.yaml\n$ docker-compose up\n```\nIf you want to customize, you can find an example config over here [Link](https://docs.faradaysec.com/Install-guide-Docker/)\n\n\n### Docker\n\nYou need to have a [Postgres](https://github.com/infobyte/faraday/wiki/Install-Guide) running first.\n\n```shell\n $ docker run \\\n -v $HOME/.faraday:/home/faraday/.faraday \\\n -p 5985:5985 \\\n -e PGSQL_USER='postgres_user' \\\n -e PGSQL_HOST='postgres_ip' \\\n -e PGSQL_PASSWD='postgres_password' \\\n -e PGSQL_DBNAME='postgres_db_name' \\\n faradaysec/faraday:latest\n ```\n\n### PyPi\n```shell\n$ pip3 install faradaysec\n$ faraday-manage initdb\n$ faraday-server\n```\n\n### Binary Packages (Debian/RPM)\nYou can find the installers on our [releases page](https://github.com/infobyte/faraday/releases)\n\n```shell\n$ sudo apt install faraday-server_amd64.deb\n# Add your user to the faraday group\n$ faraday-manage initdb\n$ sudo systemctl start faraday-server\n```\n\nAdd your user to the `faraday` group and then run\n\n### Source\nIf you want to run directly from this repo, this is the recommended way:\n\n```shell\n$ pip3 install virtualenv\n$ virtualenv faraday_venv\n$ source faraday_venv/bin/activate\n$ git clone git@github.com:infobyte/faraday.git\n$ pip3 install .\n$ faraday-manage initdb\n$ faraday-server\n```\n\nCheck out our documentation for detailed information on how to install Faraday in all of our supported platforms\n\nFor more information about the installation, check out our [Installation Wiki](https://github.com/infobyte/faraday/wiki/Install-Guide).\n\n\nIn your browser now you can go to http://localhost:5985 and login with \"faraday\" as username, and the password given by the installation process\n\n## Getting Started\n\n---\n\nLearn about Faraday holistic approach and rethink vulnerability management.\n\n- [Centralize your vulnerability data](https://faradaysec.com/centralize-vulnerability-data/)\n- [Automate the scanners you need](https://faradaysec.com/automate-scanners/)\n\n### Integrating faraday in your CI/CD\n\n**Setup Bandit and OWASP ZAP in your pipeline**\n- [GitHub](https://faradaysec.com/wp-content/whitepapers/Integrating%20Faraday%20-%20Part%20One.pdf) [PDF]\n- [Jenkins](https://faradaysec.com/wp-content/whitepapers/Integrating%20Faraday%20-%20Part%20Two.pdf) [PDF]\n- [TravisCI ](https://faradaysec.com/wp-content/whitepapers/Integrating%20Faraday%20-%20Part%20Three.pdf) [PDF]\n\n**Setup Bandit, OWASP ZAP and SonarQube in your pipeline**\n- [Gitlab](https://faradaysec.com/wp-content/whitepapers/Integrating%20Faraday%20-%20Part%20Four.pdf) [PDF]\n\n## Faraday Cli\n\n---\n\nFaraday-cli is our command line client, providing easy access to the console tools, work in faraday directly from the terminal!\n\nThis is a great way to [automate scans](https://docs.faraday-cli.faradaysec.com/), integrate it to [CI/CD pipeline](https://docs.faraday-cli.faradaysec.com/) or just get [metrics](https://docs.faraday-cli.faradaysec.com/) from a workspace\n\n```shell\n$ pip3 install faraday-cli\n```\n\nCheck our [faraday-cli](https://github.com/infobyte/faraday-cli) repo\n\nCheck out the documentation [here](https://docs.faraday-cli.faradaysec.com/).\n\n\n\n\n## Faraday Agents\n\n---\n\n[Faraday Agents Dispatcher](https://github.com/infobyte/faraday_agent_dispatcher) is a tool that gives [Faraday](https://www.faradaysec.com) the ability to run scanners or tools remotely from the platform and get the results.\n\n\n\n\n## Plugins\n\n---\n\nConnect you favorite tools through our [plugins](https://github.com/infobyte/faraday_plugins). Right now there are more than [80+ supported tools](https://github.com/infobyte/faraday/wiki/Plugin-List), among which you will find:\n\n\n\nMissing your favorite one? [Create a Pull Request](https://github.com/infobyte/faraday_plugins/issues)!\n\nThere are two Plugin types:\n\n**Console** plugins which interpret the output of the tools you execute.\n\n```shell\n$ faraday-cli tool run \\\"nmap www.exampledomain.com\\\"\n\ud83d\udcbb Processing Nmap command\nStarting Nmap 7.80 ( https://nmap.org ) at 2021-02-22 14:13 -03\nNmap scan report for www.exampledomain.com (10.196.205.130)\nHost is up (0.17s latency).\nrDNS record for 10.196.205.130: 10.196.205.130.bc.example.com\nNot shown: 996 filtered ports\nPORT STATE SERVICE\n80/tcp open http\n443/tcp open https\n2222/tcp open EtherNetIP-1\n3306/tcp closed mysql\nNmap done: 1 IP address (1 host up) scanned in 11.12 seconds\n\u2b06 Sending data to workspace: test\n\u2714 Done\n\n```\n\n\n**Report** plugins which allows you to import previously generated artifacts like XMLs, JSONs.\n\n```shell\nfaraday-cli tool report burp.xml\n```\n\nCreating custom plugins is super easy, [Read more about Plugins](http://github.com/infobyte/faraday/wiki/Plugin-List).\n\n\n## API\n\n---\nYou can access directly to our API,\ncheck out the documentation [here](https://api.faradaysec.com/).\n\n\n## Links\n\n* Homepage: [faradaysec.com](https://www.faradaysec.com)\n* Documentation: [Faraday Docs](https://docs.faradaysec.com)\n* Download: [Download .deb/.rpm from releases page](https://github.com/infobyte/faraday/releases)\n* Issue tracker and feedback: [Github issue tracker](https://github.com/infobyte/faraday/issues)\n* Frequently Asked Questions: [FaradaySEC FAQ](https://docs.faradaysec.com/FAQ/)\n* Twitter: [@faradaysec](https://twitter.com/faradaysec)\n* Try one of our [Demos](https://demo101.faradaysec.com/#/login)\n",
"bugtrack_url": null,
"license": null,
"summary": "Open Source Collaborative Penetration Test and Vulnerability Management Platform https://www.faradaysec.com",
"version": "5.2.1",
"project_urls": {
"Bug Reports": "https://github.com/infobyte/faraday/issues",
"Homepage": "https://github.com/infobyte/faraday",
"Say Thanks!": "http://saythanks.io/to/faradaysec",
"Source": "https://github.com/infobyte/faraday/"
},
"split_keywords": [
"security",
"tools"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "5cc1b195f4bf826de2bc2d7b7bec794cc4b1e85358b54aeb1007c9fa7ae74106",
"md5": "fecdda12c20c5dad9e047a56d98cc832",
"sha256": "47206b8ddddf226a1a3728a3d6b79cf9c649c878e4f52383ddcf7b32b4c8526a"
},
"downloads": -1,
"filename": "faradaysec-5.2.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "fecdda12c20c5dad9e047a56d98cc832",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 8786523,
"upload_time": "2024-03-20T20:45:14",
"upload_time_iso_8601": "2024-03-20T20:45:14.520956Z",
"url": "https://files.pythonhosted.org/packages/5c/c1/b195f4bf826de2bc2d7b7bec794cc4b1e85358b54aeb1007c9fa7ae74106/faradaysec-5.2.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "079a8a9ff5e27e112a0b4b1cdb2eb182b6b9731d9ab2f4eb907e06cbbf23a44d",
"md5": "5086c03fb11d28926ea7e80489d628b2",
"sha256": "f44e912a423659b7f0174d19a909c2a86a07512e4d3a21dfa3ac286cc03a98c9"
},
"downloads": -1,
"filename": "faradaysec-5.2.1.tar.gz",
"has_sig": false,
"md5_digest": "5086c03fb11d28926ea7e80489d628b2",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 8625072,
"upload_time": "2024-03-20T20:45:18",
"upload_time_iso_8601": "2024-03-20T20:45:18.146770Z",
"url": "https://files.pythonhosted.org/packages/07/9a/8a9ff5e27e112a0b4b1cdb2eb182b6b9731d9ab2f4eb907e06cbbf23a44d/faradaysec-5.2.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-03-20 20:45:18",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "infobyte",
"github_project": "faraday",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [],
"lcname": "faradaysec"
}
JSON
