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
1 maintainer
Metadata
1 maintainer
Release files for taegis-sdk-python 2.0.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| taegis_sdk_python-2.0.1.tar.gz | 261.8 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| taegis_sdk_python-2.0.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 717.0 kB
Release files / taegis_sdk_python-2.0.1.tar.gz
| Download URL | taegis_sdk_python-2.0.1.tar.gz |
|---|---|
| Size | 261.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
cc43d21d115fd1e3fe14301aca22ebb01aa6a2fc535567bfa52e84f7840c4a77
|
|
BLAKE2b-256 checksum How to use checksums |
95e404f27a24ad7da0f4f24e2341bfbf5aefccccc36625e29d1443fd24f72be6
|
| 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.1-py3-none-any.whl
| Download URL | taegis_sdk_python-2.0.1-py3-none-any.whl |
|---|---|
| Size | 455.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
94a3aa0ed073eb0edbd1dd7772aca99f4542a0824a379ed791e2b933d5bb3022
|
|
BLAKE2b-256 checksum How to use checksums |
a571c004f4c82250e130b42b92b88ae751716cfdbc6b5e8400d4645fb33d4724
|
| 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
|
