| Name | acct JSON |
| Version |
8.6.2
JSON |
| download |
| home_page | https://saltstack.com |
| Summary | Simple, secure, account and credential management |
| upload_time | 2023-10-04 18:43:16 |
| maintainer | |
| docs_url | None |
| author | Thomas S Hatch |
| requires_python | >=3.6 |
| license | |
| keywords |
|
| VCS |
|
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
====
acct
====
.. image:: https://img.shields.io/badge/made%20with-pop-teal
:alt: Made with pop, a Python implementation of Plugin Oriented Programming
:target: https://pop.readthedocs.io/
.. image:: https://img.shields.io/badge/made%20with-python-yellow
:alt: Made with Python
:target: https://www.python.org/
Simple and secure account management
=====
USAGE
=====
Yaml files containing confidential information can be encrypted for use inside of `acct` base applications.
This is an example of what an `acct` credentials file might look like.
credentials.yml
.. code-block:: yaml
provider:
profile_name:
username: XXXXXXXXXXXX
password: XXXXXXXXXXXX
api_key: XXXXXXXXXXXXXXXXXXX
Next use the `acct` command to encrypt this file using the fernet algorithm:
.. code-block:: bash
$ acct encrypt credentials.yml
YeckEnWEGOjBDVxxytw13AsdLgquzhCtFHOs7kDsna8=
The `acct` command can also be used to decrypt the encrypted file:
.. code-block:: bash
$ acct decrypt credentials.yml.fernet --output=yaml --acct-key="YeckEnWEGOjBDVxxytw13AsdLgquzhCtFHOs7kDsna8="
The fernet plugin is the default for encryption, but other plugins may be added.
To use the AES plugin change the previous commands to:
.. code-block:: bash
$ acct encrypt --crypto-plugin aesgcm256 credentials.yml
YeckEnWEGOjBDVxxytw13AsdLgquzhCtFHOs7kDsna8=
$ acct decrypt --crypto-plugin aesgcm256 credentials.yml.aesgcm256 --output=yaml --acct-key="YeckEnWEGOjBDVxxytw13AsdLgquzhCtFHOs7kDsna8="
You can use the `acct` command to decrypt the acct file, open it in the default text editor, then overwrite the previous acct file:
The default editor from the "EDITOR" environment variable will be used if it is set, otherwise, "notepad" for windows and "vi" for unix systems.
It can also be specified directly with the "--editor" flag.
.. code-block:: bash
$ acct edit credentials.yml --acct-key="YeckEnWEGOjBDVxxytw13AsdLgquzhCtFHOs7kDsna8="
What is POP?
------------
This project is built with `pop <https://pop.readthedocs.io/>`__, a Python-based
implementation of *Plugin Oriented Programming (POP)*. POP seeks to bring
together concepts and wisdom from the history of computing in new ways to solve
modern computing problems.
For more information:
* `Intro to Plugin Oriented Programming (POP) <https://pop-book.readthedocs.io/en/latest/>`__
* `pop-awesome <https://gitlab.com/saltstack/pop/pop-awesome>`__
* `pop-create <https://gitlab.com/saltstack/pop/pop-create/>`__
Getting Started
===============
Prerequisites
-------------
* Python 3.6+
* git *(if installing from source, or contributing to the project)*
Installation
------------
.. note::
If wanting to contribute to the project, and setup your local development
environment, see the ``CONTRIBUTING.rst`` document in the source repository
for this project.
If wanting to use ``acct``, you can do so by either
installing from PyPI or from source.
Acknowledgements
================
* `Img Shields <https://shields.io>`__ for making repository badges easy.
Raw data
{
"_id": null,
"home_page": "https://saltstack.com",
"name": "acct",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": "",
"keywords": "",
"author": "Thomas S Hatch",
"author_email": "thatch@saltstack.com",
"download_url": "https://files.pythonhosted.org/packages/63/9d/4dc6f7e23353ea75cdbd5d1c20d46b7682f0ab9d0a054975a3b344dec5a9/acct-8.6.2.tar.gz",
"platform": null,
"description": "====\nacct\n====\n\n.. image:: https://img.shields.io/badge/made%20with-pop-teal\n :alt: Made with pop, a Python implementation of Plugin Oriented Programming\n :target: https://pop.readthedocs.io/\n\n.. image:: https://img.shields.io/badge/made%20with-python-yellow\n :alt: Made with Python\n :target: https://www.python.org/\n\nSimple and secure account management\n\n=====\nUSAGE\n=====\n\nYaml files containing confidential information can be encrypted for use inside of `acct` base applications.\nThis is an example of what an `acct` credentials file might look like.\n\ncredentials.yml\n\n.. code-block:: yaml\n\n provider:\n profile_name:\n username: XXXXXXXXXXXX\n password: XXXXXXXXXXXX\n api_key: XXXXXXXXXXXXXXXXXXX\n\nNext use the `acct` command to encrypt this file using the fernet algorithm:\n\n.. code-block:: bash\n\n $ acct encrypt credentials.yml\n YeckEnWEGOjBDVxxytw13AsdLgquzhCtFHOs7kDsna8=\n\nThe `acct` command can also be used to decrypt the encrypted file:\n\n.. code-block:: bash\n\n $ acct decrypt credentials.yml.fernet --output=yaml --acct-key=\"YeckEnWEGOjBDVxxytw13AsdLgquzhCtFHOs7kDsna8=\"\n\nThe fernet plugin is the default for encryption, but other plugins may be added.\nTo use the AES plugin change the previous commands to:\n\n.. code-block:: bash\n\n $ acct encrypt --crypto-plugin aesgcm256 credentials.yml\n YeckEnWEGOjBDVxxytw13AsdLgquzhCtFHOs7kDsna8=\n $ acct decrypt --crypto-plugin aesgcm256 credentials.yml.aesgcm256 --output=yaml --acct-key=\"YeckEnWEGOjBDVxxytw13AsdLgquzhCtFHOs7kDsna8=\"\n\nYou can use the `acct` command to decrypt the acct file, open it in the default text editor, then overwrite the previous acct file:\nThe default editor from the \"EDITOR\" environment variable will be used if it is set, otherwise, \"notepad\" for windows and \"vi\" for unix systems.\nIt can also be specified directly with the \"--editor\" flag.\n\n.. code-block:: bash\n\n $ acct edit credentials.yml --acct-key=\"YeckEnWEGOjBDVxxytw13AsdLgquzhCtFHOs7kDsna8=\"\n\n\nWhat is POP?\n------------\n\nThis project is built with `pop <https://pop.readthedocs.io/>`__, a Python-based\nimplementation of *Plugin Oriented Programming (POP)*. POP seeks to bring\ntogether concepts and wisdom from the history of computing in new ways to solve\nmodern computing problems.\n\nFor more information:\n\n* `Intro to Plugin Oriented Programming (POP) <https://pop-book.readthedocs.io/en/latest/>`__\n* `pop-awesome <https://gitlab.com/saltstack/pop/pop-awesome>`__\n* `pop-create <https://gitlab.com/saltstack/pop/pop-create/>`__\n\nGetting Started\n===============\n\nPrerequisites\n-------------\n\n* Python 3.6+\n* git *(if installing from source, or contributing to the project)*\n\nInstallation\n------------\n\n.. note::\n\n If wanting to contribute to the project, and setup your local development\n environment, see the ``CONTRIBUTING.rst`` document in the source repository\n for this project.\n\nIf wanting to use ``acct``, you can do so by either\ninstalling from PyPI or from source.\n\nAcknowledgements\n================\n\n* `Img Shields <https://shields.io>`__ for making repository badges easy.\n",
"bugtrack_url": null,
"license": "",
"summary": "Simple, secure, account and credential management",
"version": "8.6.2",
"project_urls": {
"Homepage": "https://saltstack.com"
},
"split_keywords": [],
"urls": [
{
"comment_text": "pypi",
"digests": {
"blake2b_256": "3da7b2eddfa96ac32ff1deff8d1a292309547cc6ed870d32dcf62ca5992ffe29",
"md5": "f12210a1d5c4c755c64742515518b0d3",
"sha256": "9c3b34260123aa5c4082248e08bba8d3c07fa66aec10ba0e8227375a3c5e8824"
},
"downloads": -1,
"filename": "acct-8.6.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "f12210a1d5c4c755c64742515518b0d3",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 16493,
"upload_time": "2023-10-04T18:43:14",
"upload_time_iso_8601": "2023-10-04T18:43:14.593456Z",
"url": "https://files.pythonhosted.org/packages/3d/a7/b2eddfa96ac32ff1deff8d1a292309547cc6ed870d32dcf62ca5992ffe29/acct-8.6.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "pypi",
"digests": {
"blake2b_256": "639d4dc6f7e23353ea75cdbd5d1c20d46b7682f0ab9d0a054975a3b344dec5a9",
"md5": "e909bac0025b1f001943f14354c04825",
"sha256": "a1e5ffef2fa877e9f567a00b8dbc70ac8c0e0d0e2939b44d12a6ba402730d21d"
},
"downloads": -1,
"filename": "acct-8.6.2.tar.gz",
"has_sig": false,
"md5_digest": "e909bac0025b1f001943f14354c04825",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 15721,
"upload_time": "2023-10-04T18:43:16",
"upload_time_iso_8601": "2023-10-04T18:43:16.494030Z",
"url": "https://files.pythonhosted.org/packages/63/9d/4dc6f7e23353ea75cdbd5d1c20d46b7682f0ab9d0a054975a3b344dec5a9/acct-8.6.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-10-04 18:43:16",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "acct"
}
