Atakama Python SDK

Overview

This is a library for programmatically interacting and enhancing the Atakama encrypted file system.

However, the best way to interact with Atakama is to use the filesystem itself.

It is not necessary to use this SDK for most development efforts, it is provided solely for efficiency and convenience.

autodoc documentation

For example:

In order to integrate with ssh, so that you have to approve a login on your phone, the easiest thing to do is create an identity file, secure it with Atakama, and then put a soft link to it.

That way when you go to ssh in somewhere, the identity file is unlocked, and you are prompted on your mobile device.

Using the atakama command-line or SDK would not be recommended in this case.

Plugin System:

Atakama supports plugins. This is largely done so that we can have multiple release cycles for 3rd party vendor integrations.

Detector Plugins:

Atakama runs a file monitoring system. This system will automatically-encrypt files as files are modified. For efficiency, especially on large systems, it may be desirable to alter the rules used to detect and encrypt files.

Example of a detector plugin:

This plugin will cause any file with the word "secret" in the name to be encrypted.

from atakama import DetectorPlugin

class ExampleDetector(DetectorPlugin):
    @staticmethod
    def name():
        return "example-detector"

    def needs_encryption(self, full_path):
        return "secret" in full_path:

Dependencies:

Detector plugins run inside a protected namespace within Atakama. Not all imports are available.

Python code is version 3
All __builtins__ are guaranteed to be available
In particular, subprocess, sys, requests, os, zipfile and atakama are explicitly available.
If you're concerned about specific package versions and other dependencies, please package your plugin as a subprocess call (or DLL) with its own deps included
Atakama will endeavor to update the ATAKAMA_SDK_VERSION if we ship libraries that have major version changes, or backward breaking python-version changes

Metadata

Release files for atakama 1.9.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distribution (wheel)

Table of built distributions (wheels) for atakama 1.9.3
File	Interpreter	ABI	Platform	Reset
atakama-1.9.3-py3-none-any.whl 15.3 kB Nov 17, 2022	Python 3	none	any	Details

Release files / atakama-1.9.3-py3-none-any.whl

Download URL	atakama-1.9.3-py3-none-any.whl
Size	15.3 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`d4d3e6e0ede4c4743345c5f78d7c3f16824b24595c6de91101917487e30bc2c8`
BLAKE2b-256 checksum How to use checksums	`7becc14c0cb0c67d51c0bd5e853ab1027d60fe847167258ff22c6395df04ac72`
Upload date	Nov 17, 2022
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/4.0.1 CPython/3.9.6`