{
    "info": {
        "author": "",
        "author_email": "",
        "bugtrack_url": null,
        "classifiers": [],
        "description": "# aws-ssm-commander\n\n[![Build Status](https://travis-ci.org/djcrabhat/aws-ssm-commander.svg?branch=master)](https://travis-ci.org/djcrabhat/aws-ssm-commander)\n\nInspired by [aws-ssm-tree](https://github.com/brunorubin/aws-ssm-tree)\n\n## Install\n```\npip install aws-ssm-commander\n```\n\n## Usage\n```\nOptions:\n  --debug\n  --help   Show this message and exit.\n\nCommands:\n  dump   Dump the values in ssm to a param file, for backup or inspection.\n  tree   Print out a tree of your SSM parameters\n  write  take a yaml file, put it in to SSM\n```\n\n### dump\nDumps the params on a path to a json or yaml output\n```\n~> aws-ssm-commander dump /abc/123\nsection_a:\n  username: abc123\nsection_b:\n  password: blah\n  username: foobar\n```\n    \n### tree\nSee a visual representation of params on a path.  Useful for making sure your params out in SSM are structured as \nexpected\n```\n~> aws-ssm-commander tree /abc/123/\nabc\n\u00e2\u201d\u201d\u00e2\u201d\u20ac\u00e2\u201d\u20ac 123\n    \u00e2\u201d\u0153\u00e2\u201d\u20ac\u00e2\u201d\u20ac section_a\n    \u00e2\u201d\u201a   \u00e2\u201d\u201d\u00e2\u201d\u20ac\u00e2\u201d\u20ac username\n    \u00e2\u201d\u0153\u00e2\u201d\u20ac\u00e2\u201d\u20ac section_b\n    \u00e2\u201d\u201a   \u00e2\u201d\u0153\u00e2\u201d\u20ac\u00e2\u201d\u20ac password\n    \u00e2\u201d\u201a   \u00e2\u201d\u201d\u00e2\u201d\u20ac\u00e2\u201d\u20ac username\n```\n\n### write\nTakes a yaml input file and a path prefix, and writes params to SSM.\n\n```\n~> aws-ssm-commander write /abc/123/ my_file.yml\n```\n\n### Saving secrets\n\nThere are two ways of saving secrets. First is by supplying a KMS key ID along with the value to encrypt. The second is to use custom KMS to store kms blobs. The former is less secure than the latter.\n\n#### Supplying a KMS key ID along with the value to encrypt\nA KMS key ID can be supplied:\n\npassword:\n  kms_key_id: f0e79e90-5672-431d-b100b-84b8ac8f1525\n  value: supersecretpassword\n\nKeep in mind that if the params file is in git, the secret will be exposed in plain text!\n\n#### Using custom KMS keys to store kms blobs in the yaml file\nA lot of the stuff you want to put in Param Store are secrets, and you don't store plaintext secrets in git!  Now you could encrypt and decrypt these files on your own, but aws-ssm-commander supports putting a KMS blob in a config file. To use this method, you **must** use a Customer Managed KMS key.\n\nYou can put a KMS secret in your config files by prefixing a value with a `!kms` tag\n\nTo get a kms blob, \n```bash\n\nKEY_ID=1234abcd-12ab-34cd-56ef-1234567890ab\naws kms encrypt --key-id $KEY_ID --plaintext \"MY_SECRET\" --output text --query CiphertextBlob \n```\n\ntake that output, then drop it in a value in a yaml file like so:\n\n```yaml\nmy_thing:\n  username: foobar\n  password: !kms WW05aWJHRjNZbXh2WWc9PQ==\n```",
        "description_content_type": "text/markdown",
        "docs_url": null,
        "download_url": "",
        "downloads": {
            "last_day": -1,
            "last_month": -1,
            "last_week": -1
        },
        "home_page": "https://github.com/djcrabhat/aws-ssm-commander",
        "keywords": "",
        "license": "",
        "maintainer": "",
        "maintainer_email": "",
        "name": "aws-ssm-commander",
        "package_url": "https://pypi.org/project/aws-ssm-commander/",
        "platform": "",
        "project_url": "https://pypi.org/project/aws-ssm-commander/",
        "project_urls": {
            "Homepage": "https://github.com/djcrabhat/aws-ssm-commander"
        },
        "release_url": "https://pypi.org/project/aws-ssm-commander/0.0.3/",
        "requires_dist": null,
        "requires_python": "",
        "summary": "A utility for dealing with AWS SSM Parameter Store",
        "version": "0.0.3"
    },
    "last_serial": 5401572,
    "releases": {
        "0.0.1": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "1594bbf6be31e2eb3a3b978102c699d6",
                    "sha256": "667e447ac92372b1c7f677c1d20d0a17c20d543cf621dcfa0caf4259ea5e4fb7"
                },
                "downloads": -1,
                "filename": "aws_ssm_commander-0.0.1-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "1594bbf6be31e2eb3a3b978102c699d6",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": null,
                "size": 6107,
                "upload_time": "2019-04-07T22:33:32",
                "url": "https://files.pythonhosted.org/packages/9f/1c/073c8d39b7124f203636b5732c3dd55b510fae9a7b487b3e9026165e198a/aws_ssm_commander-0.0.1-py3-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "49935d23344fd063d2796231e30db880",
                    "sha256": "51158e6c08404184a0e300b32d9324939390fcef493bfedc45c1c8eb9753d99d"
                },
                "downloads": -1,
                "filename": "aws-ssm-commander-0.0.1.tar.gz",
                "has_sig": false,
                "md5_digest": "49935d23344fd063d2796231e30db880",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 4027,
                "upload_time": "2019-04-07T22:33:34",
                "url": "https://files.pythonhosted.org/packages/70/4b/ca0f853d8f7c121089770d671991b0f15ad4b0b8439bcabfdc9f2a53d6dd/aws-ssm-commander-0.0.1.tar.gz"
            }
        ],
        "0.0.2": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "5305fc1184ca291e95cd01f8b50b6b6c",
                    "sha256": "0cf658aa66ecab54fb6e6a1d1bc56d9a0dd43c20f0ff7827a3554473f353e382"
                },
                "downloads": -1,
                "filename": "aws-ssm-commander-0.0.2.tar.gz",
                "has_sig": false,
                "md5_digest": "5305fc1184ca291e95cd01f8b50b6b6c",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 5151,
                "upload_time": "2019-05-29T04:52:17",
                "url": "https://files.pythonhosted.org/packages/fd/c7/e70e6ba815cd69df1fbd1b667e726671ade3b69d994ce14f8eb631d28d04/aws-ssm-commander-0.0.2.tar.gz"
            }
        ],
        "0.0.3": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "88c076a0fee7c14fb7b61720a2e9d59d",
                    "sha256": "7ef531db264cfafab662598615906fef148c5bbf9d2ea996a70d8e97193ad9bc"
                },
                "downloads": -1,
                "filename": "aws-ssm-commander-0.0.3.tar.gz",
                "has_sig": false,
                "md5_digest": "88c076a0fee7c14fb7b61720a2e9d59d",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 5501,
                "upload_time": "2019-06-14T17:58:06",
                "url": "https://files.pythonhosted.org/packages/e6/cc/2fb9fad5e5dd5c5f22d08b108669a2849df15f18aa0998fb62dfa1e4c264/aws-ssm-commander-0.0.3.tar.gz"
            }
        ]
    },
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "md5": "88c076a0fee7c14fb7b61720a2e9d59d",
                "sha256": "7ef531db264cfafab662598615906fef148c5bbf9d2ea996a70d8e97193ad9bc"
            },
            "downloads": -1,
            "filename": "aws-ssm-commander-0.0.3.tar.gz",
            "has_sig": false,
            "md5_digest": "88c076a0fee7c14fb7b61720a2e9d59d",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 5501,
            "upload_time": "2019-06-14T17:58:06",
            "url": "https://files.pythonhosted.org/packages/e6/cc/2fb9fad5e5dd5c5f22d08b108669a2849df15f18aa0998fb62dfa1e4c264/aws-ssm-commander-0.0.3.tar.gz"
        }
    ]
}