Taegis SDK for Python
The Taegis SDK is a Python library for interfacing with the GraphQL APIs in Taegis.
Prerequisites
- Python 3.8 or higher.
Authentication
- Set
CLIENT_IDandCLIENT_SECRETenvironment variables as described in the Taegis XDR Documenation.
OR
- Login using username/password with mfa upon service creation
OR
- Device Code SSO
Installation
python -m pip install taegis-sdk-python
Using the SDK
To use the SDK, you must first import the GraphQLService
from taegis_sdk_python import GraphQLService
from pprint import pprint as pp
service = GraphQLService()
Now that you have the GraphQLService, you can make requests and process responses for Taegis XDR Services. The following example uses the Investigations Service to send a query to get all available investigations
result = service.investigations.query.investigations_search(
page=1, per_page=3, query="WHERE deleted_at IS NOT NULL EARLIEST=-90d"
)
pp(result)
result = service.tenants.query.tenants(
tenants_query=TenantsQuery(
max_results=10,
page_num=1,
)
)
pp(result)
results = service.events.subscription.event_query(
query="FROM process EARLIEST=-1d",
options=EventQueryOptions(
max_rows=20,
page_size=10,
skip_cache=True,
),
)
pp(results)
print()
try:
next_page = next(iter({result.next for result in results if result.next}))
except StopIteration:
next_page = None
if next_page:
results = service.events.subscription.event_page(page_id=next_page)
pp(results)
Getting Started Exploring the Schema
from taegis_sdk_python import GraphQLService
service = GraphQLService()
schema = service.core.get_sync_schema()
For more in depth analysis see: Exploring the Schema
For more information see the Getting Started
Metadata
Release files for taegis-sdk-python 2.0.4
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| taegis_sdk_python-2.0.4.tar.gz | 265.0 kB | Without provenance | Details for taegis_sdk_python-2.0.4.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| taegis_sdk_python-2.0.4-py3-none-any.whl | Python 3 | none | any | Details for taegis_sdk_python-2.0.4-py3-none-any.whl |
Total release size: 722.7 kB
Release files / taegis_sdk_python-2.0.4.tar.gz
| Download URL | taegis_sdk_python-2.0.4.tar.gz |
|---|---|
| Size | 265.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
d75120c465de677807e9cbf6eaddd64c1523f0010f838eb7cf2273caa5500f38
|
|
BLAKE2b-256 checksum How to use checksums |
07649d20bee4093c2d28fabee3f1560a5906acbb2affa1719fd25e71edd030ab
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
Hatch/1.16.4 cpython/3.11.9 HTTPX/0.28.1
|
Release files / taegis_sdk_python-2.0.4-py3-none-any.whl
| Download URL | taegis_sdk_python-2.0.4-py3-none-any.whl |
|---|---|
| Size | 457.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
309490df80b6df712b71dfef4f1e6fa490dcb0a7d81406883fc51273c4644d60
|
|
BLAKE2b-256 checksum How to use checksums |
89f561764505478c3b47032397b51bc1e34a38898eb24646e87472fe465d553c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
Hatch/1.16.4 cpython/3.11.9 HTTPX/0.28.1
|
Security for taegis-sdk-python 2.0.4
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.