Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/thehive-project/cortex4py
Python API Client for Cortex
https://github.com/thehive-project/cortex4py
api api-client cortex dfir free-software incident-response open-source python
Last synced: about 1 month ago
JSON representation
Python API Client for Cortex
- Host: GitHub
- URL: https://github.com/thehive-project/cortex4py
- Owner: TheHive-Project
- License: agpl-3.0
- Created: 2017-03-20T14:59:48.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2022-02-24T10:02:54.000Z (almost 3 years ago)
- Last Synced: 2024-11-08T04:09:06.360Z (about 2 months ago)
- Topics: api, api-client, cortex, dfir, free-software, incident-response, open-source, python
- Language: Python
- Homepage:
- Size: 87.9 KB
- Stars: 32
- Watchers: 7
- Forks: 30
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Code of conduct: code_of_conduct.md
Awesome Lists containing this project
README
# Cortex4py
Cortex4py is a Python API client for [Cortex](https://thehive-project.org/), a powerful observable analysis engine where observables such as IP and email addresses, URLs, domain names, files or hashes can be analyzed one by one using a Web interface.
Cortex4py allows analysts to automate these operations and submit observables in bulk mode through the Cortex REST API from alternative SIRP platforms, custom scripts or MISP.
# Features
Cortex4py 2 is compatible with Cortex 2 and does not work with Cortex 1. It can:
- Manage organizations
- Manage users
- Configure analyzers within an organization
- List and launch analyzers
For more details, please refer to the [full documentation](Usage.md).
**Note**: Cortex4py 2 requires Python 3. It does not support Python 2.
# Use It
On macOS and Linux, type:
```
sudo -H pip3 install cortex4py
```
or, if you already have it, update it:
```
sudo -H pip3 install -U cortex4py
```
If you are using Python on a Windows operating system, please forgo the `sudo` command.
# License
Cortex4py is an open source and free software released under the [AGPL](https://github.com/CERT-BDF/Cortex4py/blob/master/LICENSE) (Affero General Public License). We, TheHive Project, are committed to ensure that Cortex4py will remain a free and open source project on the long-run.
# Updates
Information, news and updates are regularly posted on [TheHive Project Twitter account](https://twitter.com/thehive_project) and on [the blog](https://blog.thehive-project.org/).
# Contributing
We welcome your contributions. Please feel free to fork the code, play with it, make some patches and send us pull requests using [issues](https://github.com/CERT-BDF/Cortex4py/issues).
We do have a [Code of conduct](code_of_conduct.md). Make sure to check it out before contributing.
# Support
Please [open an issue on GitHub](https://github.com/TheHive-Project/Cortex4py/issues/new) if you'd like to report a bug or request a feature. We are also available on [Discord](https://chat.thehive-project.org) to help you out.
If you need to contact the project team, send an email to .
# Community Discussions
We have set up a Google forum at . To request access, you need a Google account. You may create one [using a Gmail address](https://accounts.google.com/SignUp?hl=en) or [without one](https://accounts.google.com/SignUpWithoutGmail?hl=en).
# Website