quokkaio 0.2.4

API wrapper for the Quokka security software

Quokka.io

This project provides a Python client for interacting with the Quokka API. The client allows users to perform various operations such as uploading files for scanning, retrieving scan results, downloading reports, and managing subgroups.

https://www.quokka.io/

Table of Contents

• Installation
• Usage
  • Initialization
  • Push Scan
  • Get Subgroups
  • Wait for Scan Completion
  • Download PDF Report
  • Get App Issues
  • Get Results
  • Get Submitted Apps
• Logging
• Contributing
• License

Installing

To install the Quokka API Client, use pip:

pip install quokkaio

Usage

Initialization

First, import the Quokka class and create an instance with your API key:

from quokka import Quokka

api_key = "YOUR_API_KEY"
quokka = Quokka(api_key)

Push Scan

Upload an APK or IPA file for scanning:

the_file = "path/to/your/app.apk"
subgroup_ids = ["subgroup1", "subgroup2"]
response_data, platform = quokka.push_scan(the_file, subgroup_ids)
print(response_data, platform)

Get Subgroups

Retrieve a list of subgroups:

quokka.get_sub_groups()

Retrieve a specific subgroup ID by name:

subgroup_id = quokka.get_sub_groups(the_group="specific_group_name")
print(subgroup_id)

Wait for Scan Completion

Wait for a scan to complete:

uuid = "scan_uuid"
quokka.wait_for_scan_complete(uuid, maxWaitTime=30)  # maxWaitTime in minutes

Download PDF Report

Download the scan results as a PDF file:

uuid = "scan_uuid"
quokka.download_pdf(uuid)

Get App Issues

Retrieve app issues in JSON format:

uuid = "scan_uuid"
issues = quokka.get_app_issue(uuid)
print(issues)

Get Results

Retrieve specified results in JSON format from a start date:

from datetime import datetime

start_date = datetime(2023, 1, 1)
results = quokka.get_results(start_date)
print(results)

Get Submitted Apps

Retrieve submitted apps within a date range:

from datetime import datetime

start_date = datetime(2023, 1, 1)
end_date = datetime(2023, 6, 1)
apps = quokka.get_apps(start_date, end_date)
print(apps)

Get Users

Retrieve the Group User data in either CSV or compressed file format:

is_compressed = False  
quokka.get_users(isCompressed=is_compressed)

isCompressed is optional and defaults to False

Get Audit Logs

Request the Audit Log CSV which will be processed in the background. Users can request that the file is sent as either a CSV or as a compressed file. The request also allows users to select a specific date range for the audit log data. When the file is ready, the requesting user will receive an email with a download link.

start_date = "2023-01-01"
end_date = "2023-06-01"
is_compressed = False  # Set to True if you want the file to be compressed
result = quokka.get_auditLogs(startDate=start_date, endDate=end_date, isCompressed=is_compressed)

• startDate (str): The start date for retrieving results in the format “YYYY-MM-DD”.
• endDate (str): The end date for retrieving results in the format “YYYY-MM-DD”.
• isCompressed (bool): Determines whether to send a compressed file. Default is False.
• pageType (str): The type of CSV requested. For audit log data, users should request “audit”. Default is "audit".

Logging

This client uses Python's built-in logging module to provide debug information. By default, logging is set to the DEBUG level. You can configure the logging level and format as needed.

Contributing

If you want to contribute to this project, please fork the repository and create a pull request with your changes. Make sure to write tests and documentation for new features or modifications.

License

This project is licensed under the Apache-2.0 License. See the LICENSE file for details.