This Python SDK is designed to help developers easily integrate Onqlave `Encryption As A Service` into their python backend.
[](https://github.com/onqlavelabs/onqlave-python/actions)
[](https://github.com/onqlavelabs/onqlave-python/releases)
[](https://github.com/onqlavelabs/onqlave-python/blob/main/LICENSE)
# Table of Contents
- [Description](#description)
- [Table of Contents](#table-of-contents)
- [Features](#features)
- [Installation](#installation)
- [Requirements](#requirements)
- [Configuration](#configuration)
- [Usage](#usage)
- [Encrypt](#encrypt)
- [Decrypt](#decrypt)
- [Encrypt Stream](#encrypt-stream)
- [Decrypt Stream](#decrypt-stream)
- [Reporting a Vulnerability](#reporting-a-vulnerability)
## Features
- Encrypt/decrypt pieces of information
- Encrypt/decrypt stream of data
## Installation
### Requirements
- Python 3.8 and above
### Configuration
To install, simply using this command:
```bash
pip install onqlave-python-sdk-pilot
```
You can also check the [package detail on PyPI](https://pypi.org/project/onqlave-python)
## Usage
To use this SDK, you firstly need to obtain credentials to access an Onqlave Arx by signing up to [Onqlave](https://onqlave.com) and following instruction to create your first Onqlave Arx. Documentation can be found at [Onqlave Technical Documentation](https://docs.onqlave.com).
The [Onqlave Python](https://github.com/onqlavelabs/onqlave-python) module is used to perform operations on the configured Arx such as encrypting and decryptin for an Onqlave Arx.
To use this module, an Onqlave client should be initialized as follows.
(Please note that there are 3 ways of loading configurations specified in the **examples/** directory.)
```python
from onqlave.encryption import options
from onqlave.encryption.encryption import Encryption
from onqlave.credentials.credentials import Credential
from onqlave.connection.client import RetrySettings
cred_file_path = "credentials.json"
arx_option = options.ArxOption()
credential_option = Credential()
arx_option.load_arx_url_from_json(cred_file_path)
credential_option.load_config_from_json(cred_file_path)
retry_option = RetrySettings(count=1,wait_time=1,max_wait_time=2)
encryption_engine = Encryption(
debug_option=debug_option,
arx_option=arx_option,
credential_option=credential_option,
retry_setting=retry_option
)
```
### Encrypt
To encrypt data, use the **encrypt(plaintext: bytearray, associated_data: bytearray)** method of the `Encryption` service. The **plaintext** parameter is the `bytearray` representation of data you are wishing to encrypt. The **associated_data** parameter the `bytearray` representation of associated data which can be used to improve the authenticity of the data (it is not mandatory), as shown below.
```python
plaintext = "hello world" # your data goes here
associated_data = "auth" # your authentication data goes here
cipher_text = encryption_engine.encrypt(plaintext.encode(), associated_data.encode())
```
### Decrypt
To decrypt data, use the **decrypt(cipher_data: bytearray, associated_data: bytearray)** method of the `Encryption` service. The **cipher_data** parameter is the `bytearray` representation of data you are wishing to decrypt (previousely encrypted). The **associated_data** parameter the `bytearray` representation of associated data which can be used to improve the authenticity of the data (it is not mandatory), as shown below.
```python
decrypted_ciphertext = encryption_engine.decrypt(cipher_text,associated_data.encode())
```
### Encrypt Stream
To encrypt stream of data, use the **encrypt_stream(plain_stream io.Reader, cipher_stream io.Writer, associated_data bytearray)** method of the `Encryption` service. The **plain_stream** parameter is the `io.Reader` stream of data you are wishing to encrypt. The **cipher_stream** parameter is the `io.Write` stream you are wishing to write the cipher data to. The **associated_data** parameter the `bytearray` representation of associated data which can be used to improve the authenticity of the data (it is not mandatory), as shown below.
```python
plain_file_stream = open("path to your plaintext file","rb")
plain_stream = io.BytesIO(plain_file_stream.read())
cipher_stream = io.BytesIO()
encryption_engine.encrypt_stream(plain_stream,cipher_stream,associated_data.encode())
cipher_stream.seek(0)
```
### Decrypt Stream
To decrypt data, use the **decrypt_stream(cipher_stream io.io.BytesIO, plain_stream io.BytesIO, associated_data []byte)** method of the `Encryption` service. The **cipher_stream** parameter is the `io.BytesIO()` stream of data you are wishing to decrypt and it was originally encrypted using [encrypt_stream](#encrypt-stream). The **plain_stream** parameter is the `io.BytesIO()` stream you are wishing to write the plain data back to. The **associated_data** parameter the `bytearray` representation of associated data which can be used to improve the authenticity of the data (it is not mandatory), as shown below.
```python
decrypted_stream = io.BytesIO()
encryption_engine.decrypt_stream(
cipher_stream=cipher_stream,
plain_stream=decrypted_stream,
associated_data=associated_data.encode()
)
decrypted_stream.seek(0)
with open(
"path to your decrypted file",
"wb"
) as result:
result.write(decrypted_stream.read())
```
## Reporting a Vulnerability
If you discover a potential security issue in this project, please reach out to us at security@onqlave.com. Please do not create public GitHub issues or Pull Requests, as malicious actors could potentially view them.
Raw data
{
"_id": null,
"home_page": "https://github.com/onqlavelabs/onqlave-python/",
"name": "onqlave-python-dev",
"maintainer": "DC",
"docs_url": null,
"requires_python": "",
"maintainer_email": "dc@onqlave.com",
"keywords": "encryption,privacy,sdk",
"author": "Onqlave Pty",
"author_email": "product@onqlave.com",
"download_url": "https://files.pythonhosted.org/packages/ba/bb/95925858bf75a802c99dc0eae8775d31bde1d2aa8c5086f51701039ab189/onqlave-python-dev-0.1.0.tar.gz",
"platform": null,
"description": "This Python SDK is designed to help developers easily integrate Onqlave `Encryption As A Service` into their python backend.\n\n[](https://github.com/onqlavelabs/onqlave-python/actions)\n[](https://github.com/onqlavelabs/onqlave-python/releases)\n[](https://github.com/onqlavelabs/onqlave-python/blob/main/LICENSE)\n\n\n# Table of Contents\n\n- [Description](#description)\n- [Table of Contents](#table-of-contents)\n\t- [Features](#features)\n\t- [Installation](#installation)\n\t\t- [Requirements](#requirements)\n\t\t- [Configuration](#configuration)\n\t\t- [Usage](#usage)\n\t\t- [Encrypt](#encrypt)\n\t\t- [Decrypt](#decrypt)\n\t\t- [Encrypt Stream](#encrypt-stream)\n\t\t- [Decrypt Stream](#decrypt-stream)\n\t- [Reporting a Vulnerability](#reporting-a-vulnerability)\n\n## Features\n- Encrypt/decrypt pieces of information\n- Encrypt/decrypt stream of data\n\n## Installation\n\n### Requirements\n\n- Python 3.8 and above\n\n### Configuration\nTo install, simply using this command:\n\n```bash\npip install onqlave-python-sdk-pilot\n```\nYou can also check the [package detail on PyPI](https://pypi.org/project/onqlave-python)\n\n## Usage\nTo use this SDK, you firstly need to obtain credentials to access an Onqlave Arx by signing up to [Onqlave](https://onqlave.com) and following instruction to create your first Onqlave Arx. Documentation can be found at [Onqlave Technical Documentation](https://docs.onqlave.com).\n\nThe [Onqlave Python](https://github.com/onqlavelabs/onqlave-python) module is used to perform operations on the configured Arx such as encrypting and decryptin for an Onqlave Arx. \n\nTo use this module, an Onqlave client should be initialized as follows.\n(Please note that there are 3 ways of loading configurations specified in the **examples/** directory.)\n\n```python\nfrom onqlave.encryption import options\nfrom onqlave.encryption.encryption import Encryption\nfrom onqlave.credentials.credentials import Credential\nfrom onqlave.connection.client import RetrySettings\n\ncred_file_path = \"credentials.json\"\n\narx_option = options.ArxOption()\ncredential_option = Credential()\n\narx_option.load_arx_url_from_json(cred_file_path)\ncredential_option.load_config_from_json(cred_file_path)\n\nretry_option = RetrySettings(count=1,wait_time=1,max_wait_time=2) \n\nencryption_engine = Encryption(\n debug_option=debug_option,\n arx_option=arx_option,\n credential_option=credential_option,\n retry_setting=retry_option\n)\n```\n\n\n### Encrypt\n\nTo encrypt data, use the **encrypt(plaintext: bytearray, associated_data: bytearray)** method of the `Encryption` service. The **plaintext** parameter is the `bytearray` representation of data you are wishing to encrypt. The **associated_data** parameter the `bytearray` representation of associated data which can be used to improve the authenticity of the data (it is not mandatory), as shown below.\n\n```python\nplaintext = \"hello world\" # your data goes here\nassociated_data = \"auth\" # your authentication data goes here\ncipher_text = encryption_engine.encrypt(plaintext.encode(), associated_data.encode())\n```\n\n### Decrypt\n\nTo decrypt data, use the **decrypt(cipher_data: bytearray, associated_data: bytearray)** method of the `Encryption` service. The **cipher_data** parameter is the `bytearray` representation of data you are wishing to decrypt (previousely encrypted). The **associated_data** parameter the `bytearray` representation of associated data which can be used to improve the authenticity of the data (it is not mandatory), as shown below.\n\n```python\ndecrypted_ciphertext = encryption_engine.decrypt(cipher_text,associated_data.encode())\n```\n\n### Encrypt Stream\nTo encrypt stream of data, use the **encrypt_stream(plain_stream io.Reader, cipher_stream io.Writer, associated_data bytearray)** method of the `Encryption` service. The **plain_stream** parameter is the `io.Reader` stream of data you are wishing to encrypt. The **cipher_stream** parameter is the `io.Write` stream you are wishing to write the cipher data to. The **associated_data** parameter the `bytearray` representation of associated data which can be used to improve the authenticity of the data (it is not mandatory), as shown below.\n\n```python\nplain_file_stream = open(\"path to your plaintext file\",\"rb\")\nplain_stream = io.BytesIO(plain_file_stream.read())\ncipher_stream = io.BytesIO()\n \nencryption_engine.encrypt_stream(plain_stream,cipher_stream,associated_data.encode())\ncipher_stream.seek(0)\n```\n\n### Decrypt Stream\nTo decrypt data, use the **decrypt_stream(cipher_stream io.io.BytesIO, plain_stream io.BytesIO, associated_data []byte)** method of the `Encryption` service. The **cipher_stream** parameter is the `io.BytesIO()` stream of data you are wishing to decrypt and it was originally encrypted using [encrypt_stream](#encrypt-stream). The **plain_stream** parameter is the `io.BytesIO()` stream you are wishing to write the plain data back to. The **associated_data** parameter the `bytearray` representation of associated data which can be used to improve the authenticity of the data (it is not mandatory), as shown below.\n\n```python\ndecrypted_stream = io.BytesIO()\nencryption_engine.decrypt_stream(\n cipher_stream=cipher_stream,\n plain_stream=decrypted_stream,\n associated_data=associated_data.encode()\n)\ndecrypted_stream.seek(0)\n\nwith open(\n \"path to your decrypted file\",\n \"wb\"\n) as result:\n result.write(decrypted_stream.read())\n```\n\n## Reporting a Vulnerability\n\nIf you discover a potential security issue in this project, please reach out to us at security@onqlave.com. Please do not create public GitHub issues or Pull Requests, as malicious actors could potentially view them.\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "This Python SDK is designed to help developers easily integrate Onqlave Encryption As A Service into their python backend.",
"version": "0.1.0",
"project_urls": {
"Download": "https://pypi.org/project/onqlave-python-dev/#history",
"Home Page": "https://www.onqlave.com/",
"Homepage": "https://github.com/onqlavelabs/onqlave-python/",
"Issue Tracker": "https://github.com/onqlavelabs/onqlave-python/issues",
"Source Code": "https://github.com/onqlavelabs/onqlave-python/"
},
"split_keywords": [
"encryption",
"privacy",
"sdk"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "6569617ccf9f3ca7e3e3831181e1f016eb73a99563202af6cd30ef830880fa74",
"md5": "5c667e5289d4812c03e88d55d0ad788f",
"sha256": "60af7a01a52ed9aa79bc207af69a3d778dc278bb19a82664824865aefaa12f46"
},
"downloads": -1,
"filename": "onqlave_python_dev-0.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "5c667e5289d4812c03e88d55d0ad788f",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 35164,
"upload_time": "2023-08-04T06:45:29",
"upload_time_iso_8601": "2023-08-04T06:45:29.427324Z",
"url": "https://files.pythonhosted.org/packages/65/69/617ccf9f3ca7e3e3831181e1f016eb73a99563202af6cd30ef830880fa74/onqlave_python_dev-0.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "babb95925858bf75a802c99dc0eae8775d31bde1d2aa8c5086f51701039ab189",
"md5": "544e8240f7dcc54d5d833207d888c0f1",
"sha256": "e970d94915f5605fc86b533e193c4b5f097332e6e3442bc7f1cb40bbb946c4dc"
},
"downloads": -1,
"filename": "onqlave-python-dev-0.1.0.tar.gz",
"has_sig": false,
"md5_digest": "544e8240f7dcc54d5d833207d888c0f1",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 24735,
"upload_time": "2023-08-04T06:45:30",
"upload_time_iso_8601": "2023-08-04T06:45:30.441628Z",
"url": "https://files.pythonhosted.org/packages/ba/bb/95925858bf75a802c99dc0eae8775d31bde1d2aa8c5086f51701039ab189/onqlave-python-dev-0.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-08-04 06:45:30",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "onqlavelabs",
"github_project": "onqlave-python",
"github_not_found": true,
"lcname": "onqlave-python-dev"
}
JSON
