Skip to main content

A Python client for OAuth2 authentication with the Cymulate API. This library simplifies the process of authenticating with the Cymulate API using OAuth2, managing tokens, and making secure requests effortlessly.

Project description

Cymulate OAuth2 Client

A Python client for OAuth2 authentication with the Cymulate API. This library simplifies the process of authenticating with the Cymulate API using OAuth2, managing tokens, and making secure requests effortlessly.

Installation

To install the package, use pip:

pip install cymulate-oauth2-client 

Requirements

  • Python Version: This client supports Python 3.12 and above. Ensure you have Python 3.12 or a later version installed to use this package.

Usage

Below are examples of how to use the CymulateOAuth2Client class to authenticate with the Cymulate API, make secure requests, and manage tokens. Both synchronous and asynchronous examples are provided.

Synchronous Example

import json
from cymulate_oauth2_client import CymulateOAuth2Client
from requests.exceptions import HTTPError

def main():
    # Initialize the OAuth2 client with your credentials and base URL
    client = CymulateOAuth2Client(
        client_id='your_client_id',         # Your Cymulate OAuth2 client_id
        client_secret='your_client_secret', # Your Cymulate OAuth2 client_secret
        base_url='https://api.cymulate.com' # The Cymulate API base URL (adjust based on your region)
    )

    try:
        # Example 1: Make a GET request to a secure resource
        response = client.get(path='/v1/browsing/templates')
        print("GET response:", json.dumps(response, indent=2))

        # Example 2: Make a POST request to a secure resource
        # data = {'key': 'value'}
        # response = client.post(path='/msfinding/api/v2/filters', json=data)
        # print("POST response:", json.dumps(response, indent=2))

    except HTTPError as e:
        # Handle HTTP errors separately
        try:
            error_message = e.response.json()
        except ValueError:
            # Response is not JSON formatted
            error_message = e.response.text
        print(f"HTTP error occurred: {e}")
        print(f"Response content: {json.dumps(error_message, indent=2)}")
    except Exception as e:
        # Handle all other exceptions
        print(f"An error occurred: {str(e)}")

if __name__ == "__main__":
    main()

Asynchronous Example

For environments that support asynchronous programming, you can use the asynchronous methods provided by CymulateOAuth2Client.

import json
import asyncio
from cymulate_oauth2_client import CymulateOAuth2Client
from requests.exceptions import HTTPError

async def async_main():
    # Initialize the OAuth2 client with your credentials and base URL
    client = CymulateOAuth2Client(
        client_id='your_client_id',         # Your Cymulate OAuth2 client_id
        client_secret='your_client_secret', # Your Cymulate OAuth2 client_secret
        base_url='https://api.cymulate.com' # The Cymulate API base URL (adjust based on your region)
    )

    try:
        # Example 1: Make a GET request to a secure resource asynchronously
        async_response = await client.aget(path='/v1/browsing/templates')
        print("Async GET response:", json.dumps(async_response, indent=2))

        # Example 2: Make a POST request to a secure resource asynchronously
        # async_data = {'key': 'value'}
        # async_response = await client.apost(path='/msfinding/api/v2/filters', json=async_data)
        # print("Async POST response:", json.dumps(async_response, indent=2))

    except HTTPError as e:
        # Handle HTTP errors separately
        try:
            error_message = e.response.json()
        except ValueError:
            # Response is not JSON formatted
            error_message = e.response.text
        print(f"HTTP error occurred: {e}")
        print(f"Response content: {json.dumps(error_message, indent=2)}")
    except Exception as e:
        # Handle all other exceptions
        print(f"An error occurred: {str(e)}")

if __name__ == "__main__":
    # Run asynchronous example
    asyncio.run(async_main())

API URL Configuration

Cymulate provides different API endpoints depending on your region. Ensure you use the correct base URL for your environment:

  • US: https://us-api.cymulate.com
  • EU: https://api.cymulate.com

For detailed API documentation, refer to the appropriate link based on your region:

Key Methods

  • get(url, **kwargs): Sends a GET request to a secure resource.
  • post(url, data=None, json=None, **kwargs): Sends a POST request to a secure resource.
  • put(url, data=None, **kwargs): Sends a PUT request to a secure resource.
  • delete(url, **kwargs): Sends a DELETE request to a secure resource.
  • aget(url, **kwargs): Asynchronously sends a GET request.
  • apost(url, data=None, json=None, **kwargs): Asynchronously sends a POST request.
  • aput(url, data=None, **kwargs): Asynchronously sends a PUT request.
  • adelete(url, **kwargs): Asynchronously sends a DELETE request.

Exception Handling

This client handles common HTTP exceptions such as connection errors, timeouts, and authentication errors. It also automatically refreshes or obtains a new token if the current token is expired or invalid, retrying the request up to the configured number of retries.

Logging

The client leverages Python’s built-in logging module to log important events, such as token refreshes, errors, and warnings. Logs can be configured to suit your needs.

License

This project is licensed under the MIT License. For more information, see the LICENSE file.

Contributing

Contributions are welcome! If you have suggestions, find a bug, or want to improve the code, please open an issue or submit a pull request.

Contact

For any inquiries or support, please contact Cymulate at support@cymulate.com.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

cymulate_oauth2_client-1.0.18.tar.gz (14.9 kB view details)

Uploaded Source

Built Distribution

cymulate_oauth2_client-1.0.18-py3-none-any.whl (14.3 kB view details)

Uploaded Python 3

File details

Details for the file cymulate_oauth2_client-1.0.18.tar.gz.

File metadata

File hashes

Hashes for cymulate_oauth2_client-1.0.18.tar.gz
Algorithm Hash digest
SHA256 1a1d8bf1f6ff86b5e7f4017163b7573d5b76911b50f0ed3ccd129372c6e592ca
MD5 b8579babb080947874506648fa318cca
BLAKE2b-256 3688dd596441f27404723e3a1a323b09a08ae5ada39bc83bf31c45371a07fb4d

See more details on using hashes here.

File details

Details for the file cymulate_oauth2_client-1.0.18-py3-none-any.whl.

File metadata

File hashes

Hashes for cymulate_oauth2_client-1.0.18-py3-none-any.whl
Algorithm Hash digest
SHA256 41ceb6ae819839169e45cb62c3720024047bc0a6ff0e498d51b5ee75895c0245
MD5 4eae15448f9903c24ca7d6c5cfa47dd8
BLAKE2b-256 11374aa05096869ed43ed0a88752ccb897139419743b8e36000bd8195b5bb401

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page