kryptoxin


Namekryptoxin JSON
Version 0.9.9 PyPI version JSON
download
home_pagehttps://github.com/e3prom/kryptoxin
SummaryA security-oriented payload encryption tool written in Python.
upload_time2023-05-03 08:03:54
maintainer
docs_urlNone
authorNicolas Chabbey
requires_python>=3.7
licenseGNU Affero General Public License v3
keywords security encryption
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # Kryptoxin

[![Latest Release](https://img.shields.io/github/release/e3prom/Kryptoxin.svg?style=for-the-badge)](https://github.com/e3prom/Kryptoxin/releases)
[![GitHub issues](https://img.shields.io/github/issues-raw/e3prom/kryptoxin?style=for-the-badge)](https://github.com/e3prom/kryptoxin/issues)
[![GitHub Workflow - Docs](https://img.shields.io/github/actions/workflow/status/e3prom/kryptoxin/docs-deploy.yml?label=docs&style=for-the-badge)](https://e3prom.github.io/kryptoxin/)
[![GitHub Workflow - Tests](https://img.shields.io/github/actions/workflow/status/e3prom/kryptoxin/python-unittest.yml?label=Tests&style=for-the-badge)](https://github.com/e3prom/kryptoxin/actions/workflows/python-unittest.yml)
[![License](https://img.shields.io/github/license/e3prom/kryptoxin?style=for-the-badge)](https://raw.githubusercontent.com/e3prom/kryptoxin/master/LICENSE)

- [Kryptoxin](#kryptoxin)
  - [Description](#description)
  - [Features](#features)
  - [Installation](#installation)
    - [With pip (latest release)](#with-pip-latest-release)
    - [With git (v0.9.9)](#with-git-v099)
  - [Usages examples](#usages-examples)
    - [Read, encrypt and decrypt, all from stdin](#read-encrypt-and-decrypt-all-from-stdin)
    - [Encrypt using AES-128-CFB](#encrypt-using-aes-128-cfb)
    - [Uses the PowerShell `load-asm` script template](#uses-the-powershell-load-asm-script-template)
  - [Documentation](#documentation)
  - [Disclaimer](#disclaimer)
  - [License](#license)

## Description

Kryptoxin is a Python tool allowing you to generate encrypted payloads effortlessly. This software is primarily intended for use in the security field for storing encrypted objects on target hosts. It can also be used for concealing scripts and binary objects from scrutiny.

The name `Kryptoxin` comes from the contraction of `Kryptos` (meaning `conceal`, `hidden` or `secret` in Greek) and the word `Toxin` (meaning `poison`). As the name implies, the intended goal of this project is to provide a fast and efficient way of concealing or hiding payloads, thus saving you a lot of time and effort. Most of our templates are "living off the land", using system libraries and encryption routines commonly found in base operating systems installations.

## Features

The below features are supported:

- Provides block-cipher encryption algorithms such as the `Advanced Encryption Standard` or `AES`.
- Implements basic encryption ciphers such as a derivative of the [`Caesar Cipher`](https://en.wikipedia.org/wiki/Caesar_cipher).
- Supports user-specifiable key sizes and block-cipher modes of operations, such as `AES256-CBC`.
- Generate random cryptographic parameters such as `Initialization Vector` and `Salt`.
- Encodes and properly formats variables for fast and streamlined copy/paste operations.
- Handles `Text Files`, `Scripts`, `Portable Executables (PE)`, `Dynamic Link Libraries (DLLs)`, and `shellcodes` objects.
- Generates compact, portable scripts or source codes as outputs for the below programming languages:
  - [x] PowerShell
  - [x] VBA Macro
  - [x] C#
  - [ ] C++
  - [ ] C
- Implement key derivation functions, such as `PBKDF2`.
- Supports out-of-band key storage, with conditional trigger mechanisms (not yet available).
- Includes scripts and source code templates to be used for security-related tasks and experimentation.

## Installation

### With pip (latest release)

``` sh
pip install kryptoxin
```

### With git (v0.9.9)

``` sh
git clone https://github.com/e3prom/kryptoxin
cd kryptoxin
git checkout tags/0.9.9
sudo make install
```

## Usages examples

### Read, encrypt and decrypt, all from stdin

``` {sh .no-copy}
$ echo -n 'test' | python -m kryptoxin encrypt -k 12345
5bP32GKoJa57IcKL4sWeUQ==

$ echo -n '5bP32GKoJa57IcKL4sWeUQ==' | python -m kryptoxin decrypt -k 12345
test
```

### Encrypt using AES-128-CFB

``` {sh .no-copy}
$ echo -n 'test' | python -m kryptoxin encrypt -k 12345 --alg aes --key_size 128 --mode CFB
E1ZdkFX+N4SjHtcsSi5m2g==
```

### Uses the PowerShell `load-asm` script template

``` {sh .no-copy}
$ python -m kryptoxin encrypt -k 123456 --random-iv --random-salt \
--lang powershell --action load_asm --in TestLibrary.dll \
--type=TestLibraryClass.Class1 --method=run
2023-03-04 17:33:42,287 - INFO - The Initialization Vector (IV) is: c15c8447204e9025a8ef1e4dd2ea80da
2023-03-04 17:33:42,287 - INFO - The PBKDF2 Salt is: 85858c9115145be223d36750464b8026

$base64EncData = "3Ud7pHQPm/qWOjgtuNOXP2WclPMxz6VuhfRTnwNXDyg="
[...]
```

## Documentation

You can directly visit the [online documentation](https://e3prom.github.io/kryptoxin/) or build it locally using the `make docs` command.

## Disclaimer

This program is distributed "AS IS" without any warranty or conditions of any kind. Under no circumstances can the developers, maintainers, or contributors be held responsible for the improper use of this software. Any damages or consequences resulting from the direct or indirect operation of this software cannot be attributed to the above-mentioned individuals or organizations. All opinions and knowledge expressed in the source codes, documentation, templates and examples are provided for educational and demonstration purposes only. By using this software you agree to the terms expressed therein.

## License

Kryptoxin is released under the AGPL-3 license. See [LICENSE](LICENSE) for more detail.

            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/e3prom/kryptoxin",
    "name": "kryptoxin",
    "maintainer": "",
    "docs_url": null,
    "requires_python": ">=3.7",
    "maintainer_email": "",
    "keywords": "security,encryption",
    "author": "Nicolas Chabbey",
    "author_email": "eprom@toor.si",
    "download_url": "https://files.pythonhosted.org/packages/6b/6a/5b24963ccbb5f4e5ee02d17d9c05dc3faa0f40db7f185b4145d548fffb3f/kryptoxin-0.9.9.tar.gz",
    "platform": null,
    "description": "# Kryptoxin\n\n[![Latest Release](https://img.shields.io/github/release/e3prom/Kryptoxin.svg?style=for-the-badge)](https://github.com/e3prom/Kryptoxin/releases)\n[![GitHub issues](https://img.shields.io/github/issues-raw/e3prom/kryptoxin?style=for-the-badge)](https://github.com/e3prom/kryptoxin/issues)\n[![GitHub Workflow - Docs](https://img.shields.io/github/actions/workflow/status/e3prom/kryptoxin/docs-deploy.yml?label=docs&style=for-the-badge)](https://e3prom.github.io/kryptoxin/)\n[![GitHub Workflow - Tests](https://img.shields.io/github/actions/workflow/status/e3prom/kryptoxin/python-unittest.yml?label=Tests&style=for-the-badge)](https://github.com/e3prom/kryptoxin/actions/workflows/python-unittest.yml)\n[![License](https://img.shields.io/github/license/e3prom/kryptoxin?style=for-the-badge)](https://raw.githubusercontent.com/e3prom/kryptoxin/master/LICENSE)\n\n- [Kryptoxin](#kryptoxin)\n  - [Description](#description)\n  - [Features](#features)\n  - [Installation](#installation)\n    - [With pip (latest release)](#with-pip-latest-release)\n    - [With git (v0.9.9)](#with-git-v099)\n  - [Usages examples](#usages-examples)\n    - [Read, encrypt and decrypt, all from stdin](#read-encrypt-and-decrypt-all-from-stdin)\n    - [Encrypt using AES-128-CFB](#encrypt-using-aes-128-cfb)\n    - [Uses the PowerShell `load-asm` script template](#uses-the-powershell-load-asm-script-template)\n  - [Documentation](#documentation)\n  - [Disclaimer](#disclaimer)\n  - [License](#license)\n\n## Description\n\nKryptoxin is a Python tool allowing you to generate encrypted payloads effortlessly. This software is primarily intended for use in the security field for storing encrypted objects on target hosts. It can also be used for concealing scripts and binary objects from scrutiny.\n\nThe name `Kryptoxin` comes from the contraction of `Kryptos` (meaning `conceal`, `hidden` or `secret` in Greek) and the word `Toxin` (meaning `poison`). As the name implies, the intended goal of this project is to provide a fast and efficient way of concealing or hiding payloads, thus saving you a lot of time and effort. Most of our templates are \"living off the land\", using system libraries and encryption routines commonly found in base operating systems installations.\n\n## Features\n\nThe below features are supported:\n\n- Provides block-cipher encryption algorithms such as the `Advanced Encryption Standard` or `AES`.\n- Implements basic encryption ciphers such as a derivative of the [`Caesar Cipher`](https://en.wikipedia.org/wiki/Caesar_cipher).\n- Supports user-specifiable key sizes and block-cipher modes of operations, such as `AES256-CBC`.\n- Generate random cryptographic parameters such as `Initialization Vector` and `Salt`.\n- Encodes and properly formats variables for fast and streamlined copy/paste operations.\n- Handles `Text Files`, `Scripts`, `Portable Executables (PE)`, `Dynamic Link Libraries (DLLs)`, and `shellcodes` objects.\n- Generates compact, portable scripts or source codes as outputs for the below programming languages:\n  - [x] PowerShell\n  - [x] VBA Macro\n  - [x] C#\n  - [ ] C++\n  - [ ] C\n- Implement key derivation functions, such as `PBKDF2`.\n- Supports out-of-band key storage, with conditional trigger mechanisms (not yet available).\n- Includes scripts and source code templates to be used for security-related tasks and experimentation.\n\n## Installation\n\n### With pip (latest release)\n\n``` sh\npip install kryptoxin\n```\n\n### With git (v0.9.9)\n\n``` sh\ngit clone https://github.com/e3prom/kryptoxin\ncd kryptoxin\ngit checkout tags/0.9.9\nsudo make install\n```\n\n## Usages examples\n\n### Read, encrypt and decrypt, all from stdin\n\n``` {sh .no-copy}\n$ echo -n 'test' | python -m kryptoxin encrypt -k 12345\n5bP32GKoJa57IcKL4sWeUQ==\n\n$ echo -n '5bP32GKoJa57IcKL4sWeUQ==' | python -m kryptoxin decrypt -k 12345\ntest\n```\n\n### Encrypt using AES-128-CFB\n\n``` {sh .no-copy}\n$ echo -n 'test' | python -m kryptoxin encrypt -k 12345 --alg aes --key_size 128 --mode CFB\nE1ZdkFX+N4SjHtcsSi5m2g==\n```\n\n### Uses the PowerShell `load-asm` script template\n\n``` {sh .no-copy}\n$ python -m kryptoxin encrypt -k 123456 --random-iv --random-salt \\\n--lang powershell --action load_asm --in TestLibrary.dll \\\n--type=TestLibraryClass.Class1 --method=run\n2023-03-04 17:33:42,287 - INFO - The Initialization Vector (IV) is: c15c8447204e9025a8ef1e4dd2ea80da\n2023-03-04 17:33:42,287 - INFO - The PBKDF2 Salt is: 85858c9115145be223d36750464b8026\n\n$base64EncData = \"3Ud7pHQPm/qWOjgtuNOXP2WclPMxz6VuhfRTnwNXDyg=\"\n[...]\n```\n\n## Documentation\n\nYou can directly visit the [online documentation](https://e3prom.github.io/kryptoxin/) or build it locally using the `make docs` command.\n\n## Disclaimer\n\nThis program is distributed \"AS IS\" without any warranty or conditions of any kind. Under no circumstances can the developers, maintainers, or contributors be held responsible for the improper use of this software. Any damages or consequences resulting from the direct or indirect operation of this software cannot be attributed to the above-mentioned individuals or organizations. All opinions and knowledge expressed in the source codes, documentation, templates and examples are provided for educational and demonstration purposes only. By using this software you agree to the terms expressed therein.\n\n## License\n\nKryptoxin is released under the AGPL-3 license. See [LICENSE](LICENSE) for more detail.\n",
    "bugtrack_url": null,
    "license": "GNU Affero General Public License v3",
    "summary": "A security-oriented payload encryption tool written in Python.",
    "version": "0.9.9",
    "project_urls": {
        "Homepage": "https://github.com/e3prom/kryptoxin"
    },
    "split_keywords": [
        "security",
        "encryption"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "b3243196c79dea80f15f32d6b19642effd3cca39bcc4e5874e5ab33fc95e7796",
                "md5": "21cb02b58b3c86844f9031626aca5c32",
                "sha256": "adb31dcac9ba3e51ed3efab0d457c6ca0c906e063b04f511a69bf37ce7dc8a3b"
            },
            "downloads": -1,
            "filename": "kryptoxin-0.9.9-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "21cb02b58b3c86844f9031626aca5c32",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.7",
            "size": 40591,
            "upload_time": "2023-05-03T08:03:51",
            "upload_time_iso_8601": "2023-05-03T08:03:51.699132Z",
            "url": "https://files.pythonhosted.org/packages/b3/24/3196c79dea80f15f32d6b19642effd3cca39bcc4e5874e5ab33fc95e7796/kryptoxin-0.9.9-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "6b6a5b24963ccbb5f4e5ee02d17d9c05dc3faa0f40db7f185b4145d548fffb3f",
                "md5": "bf2f42d6f35cac30c49c1dfcc025ea3c",
                "sha256": "634efb7f94e264c67afc69cff87d1c4422a25f776e54b00d0a8b3710aad57bcf"
            },
            "downloads": -1,
            "filename": "kryptoxin-0.9.9.tar.gz",
            "has_sig": false,
            "md5_digest": "bf2f42d6f35cac30c49c1dfcc025ea3c",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.7",
            "size": 33657,
            "upload_time": "2023-05-03T08:03:54",
            "upload_time_iso_8601": "2023-05-03T08:03:54.875352Z",
            "url": "https://files.pythonhosted.org/packages/6b/6a/5b24963ccbb5f4e5ee02d17d9c05dc3faa0f40db7f185b4145d548fffb3f/kryptoxin-0.9.9.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2023-05-03 08:03:54",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "e3prom",
    "github_project": "kryptoxin",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "requirements": [],
    "lcname": "kryptoxin"
}
        
Elapsed time: 0.07021s