https://github.com/jul10l1r4/x-force

IBM Security utilitary library in python. Search and query all sources: threat_activities and groups, malware_analysis, industries
https://github.com/jul10l1r4/x-force

cti exchange otx pypi python-library python3 threat-intelligence xforce

Last synced: about 6 hours ago
JSON representation

IBM Security utilitary library in python. Search and query all sources: threat_activities and groups, malware_analysis, industries

• Host: GitHub
• URL: https://github.com/jul10l1r4/x-force
• Owner: Jul10l1r4
• License: gpl-3.0
• Created: 2023-01-18T18:22:00.000Z (almost 2 years ago)
• Default Branch: main
• Last Pushed: 2023-01-30T01:35:07.000Z (almost 2 years ago)
• Last Synced: 2024-09-23T14:41:31.445Z (about 2 months ago)
• Topics: cti, exchange, otx, pypi, python-library, python3, threat-intelligence, xforce
• Language: Python
• Homepage: https://pypi.org/project/XForce/
• Size: 35.2 KB
• Stars: 8
• Watchers: 1
• Forks: 2
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# [IBM X-Force Exchange library]

|![](https://exchange.xforce.ibmcloud.com/favicon.ico)|IBM Security X-FORCE Exchange library in Python 3. Search: threat_activities, threat_groups, malware_analysis, collector and industries. For others applications. See ![X-Force Exchange](//exchange.xforce.ibmcloud.com)|

|---|---|

# Install

```pip

pip3 install XForce

```

# Use

Using you API_KEY make a basic authentication. See ![documentation](https://api.xforce.ibmcloud.com/doc/). After make a base64 code → Key + : + Password:

```sh

printf "d2f5f0f9-2995-42c6-b1dd-4c92252da129:06c41d5e-0604-4c7c-a599-300c367d2090" | base64

# ZDJmNWYwZjktMjk5NS00MmM2LWIxZGQtNGM5MjI1MmRhMTI5OjA2YzQxZDVlLTA2MDQtNGM3Yy1hNTk5LTMwMGMzNjdkMjA5MAo=

``` 

Using API_KEY, call functions. See ![best praticles](https://medium.com/geekculture/python-separate-code-and-sensitive-information-elegantly-ae21cec5fae2) for key storage

## Call functions

```python3

import XForce

# Args: 1 - Term of search, 2 - API KEY

# Threat activity search return in string

XForce.threat_activities(Term, API_KEY)

# Malware analysis search return in string

XForce.malware_analysis(Term, API_KEY)

# Threat groups search return in string

XForce.threat_groups(Term, API_KEY)

# Industries search return in string

XForce.industries(Term, API_KEY)

# All categories search return in list with dict

XForce.industries(Term, API_KEY)

```

For see more details of consult, run:

```python3

from XForce import details

# Args: 1 - GUID, 2 - API KEY 

# IMPORTANT: all GUID are correspondent to category

# All function of details have:

# url → with x-force exchange panel

details.activity(Id, API_KEY)

details.group(Id, API_KEY)

details.malware(Id, API_KEY)

details.industry(Id, API_KEY)

```