Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/abunuwas/fencer
Automated API security testing
https://github.com/abunuwas/fencer
api api-security api-security-testing graphql jwt oauth2 openapi owasp-top-10 rest-api security sql-injection testing
Last synced: 3 months ago
JSON representation
Automated API security testing
- Host: GitHub
- URL: https://github.com/abunuwas/fencer
- Owner: abunuwas
- License: mit
- Created: 2023-01-31T15:11:31.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2024-04-13T22:48:58.000Z (7 months ago)
- Last Synced: 2024-04-24T19:01:18.836Z (7 months ago)
- Topics: api, api-security, api-security-testing, graphql, jwt, oauth2, openapi, owasp-top-10, rest-api, security, sql-injection, testing
- Language: Python
- Homepage:
- Size: 442 KB
- Stars: 66
- Watchers: 6
- Forks: 10
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGES.md
- License: LICENSE
Awesome Lists containing this project
- awesome-python-testing - fencer - Fencer is an automated API security testing tool. It's an experimental project to see how much of the API security testing process can be automated. (Penetration Testing)
README
# Fencer
[![pypi](https://img.shields.io/pypi/v/fencer.svg)](https://pypi.python.org/pypi/fencer)
[![versions](https://img.shields.io/pypi/pyversions/fencer.svg)](https://github.com/abunuwas/fencer)Automated API security testing tool.
**DO NOT run this against production!!**
Fencer is an automated API security testing tool. It's an experimental project to see how much of the API
security testing process can be automated. I believe that API security testing requires a holistic approach.
An API is part of a bigger system, and the security configuration of the whole system affects the security of
the API. However, it's also true that many security tests on APIs are easy to formalize and hence automate. The
goal of this project is to capture all those formal test cases.The starting point is the [OWASP Top 10 API Security Threats](https://owasp.org/www-project-api-security/)
checklist. The goal is to create automated tests for each of those threats. Once we've covered OWASP, the goal
is to move beyond the checklist and add more tests for all sorts of common API security vulnerabilities. If you
have suggestions about cases that should be covered and don't appear in the OWASP checklist, please raise an issue!Use fencer responsibly. I suggest running fencer against development environments, or even better, against
ephemeral environments in which you can do no harm to your systems. I'd generally advise against running fencer
directly against production.---
## Limitations
Fencer is still pretty much work in progress. I'm adding new features every day, but there's still a long way to go.
I very much welcome contributions to make progress faster. At the moment, these are the most important limitations:* Only works with Python 3.10 and upwards for now
* Only works with API specifications available as local files in JSON or YAML
* Only works with OpenAPI 3.X.X and probably has missing features
* A lot of tests are missing, e.g. noSQL injection, command injection, JWT tests, and so on. I'll include them as
soon as I can.
* The CLI is super simple at the moment but will soon get better.
* Failing tests are stored under a folder named `.fencer/` relative to the directory from which you run the tool.
As soon as I can, I'll add commands to work with those tests and be able to visualise them and storage will be
optional too.## Requirements
Python 3.10+
## Installation
To install fencer, run the following command:
```bash
$ pip install -U fencer
```## Running fencer
After installation, you can run fencer directly from the command line. The basic test suite runs like this:
```bash
$ fencer run --oas-file --base-url
```Replace `` with the path to the OpenAPI specification for your API in your local machine.
It only works with JSON specs at the moment. Replace also `` with the base URL of the server you want
to test against.For example:
```bash
$ fencer run --oas-file openapi.json --base-url http://localhost:5000
```![image info](https://github.com/abunuwas/fencer/blob/742b9dd62bae3dadd838b7085336da7cdc98a06b/img/fencer_demo.gif)
## Contributing
Clone the repository and install it locally by running:
```bash
$ pipenv install -e .
```I'm just getting started with this project, and I could use some help! I'll be uploading a contribution guideline
in the coming days, but if you have suggestions in the meantime, please raise an issue and let's have a chat!