{ "info": { "author": "CyberArk Software, Inc", "author_email": "CyberArk Maintainers ", "bugtrack_url": null, "classifiers": [ "Development Status :: 3 - Alpha", "Intended Audience :: Developers", "License :: OSI Approved :: MIT License", "Natural Language :: English", "Operating System :: OS Independent", "Programming Language :: Python :: 3 :: Only", "Topic :: Office/Business", "Topic :: Security", "Topic :: Security :: Cryptography", "Topic :: Software Development", "Topic :: Software Development :: Libraries", "Topic :: Software Development :: Libraries :: Python Modules", "Topic :: System :: Systems Administration", "Topic :: System :: Systems Administration :: Authentication/Directory", "Topic :: Utilities" ], "description": "# conjur-api-python3\n\nPython3-based API SDK for [Conjur OSS](https://www.conjur.org/). The repo\nalso includes a self-contained CLI tool (`conjur-cli`) that wraps the API\nin a simple executable script/binary.\n\n---\n\n### **Status**: Alpha\n\n#### **Warning: Naming and APIs are still subject to breaking changes!**\n\n---\n\n\n## Installing the code\n\n### From PyPI\n\n```\n$ pip3 install conjur-client\n```\n\n### From source\n\n```\n$ pip3 install .\n```\n\nNote: On some machines, you have to use `pip` instead of `pip3` but in most cases,\nyou will want to use `pip3` if it's available for your platform.\n\n## Usage\n\n### CLI\n\nCLI can either be used with the included executable script:\n\n```shell\nconjur-cli --insecure -l https://myserver -a orgname -u admin -p secret \\\n variable get foo/bar\n```\n\nOr through the installed module:\n\n```shell\npython -m conjur --insecure -l https://myserver -a orgname -u admin -p secret list\n```\n\n### API\n\nMost usage is done by creating a Client instance and then invoking the API on it:\n\n#### With login ID and password\n\n```python3\n#!/usr/bin/env python3\n\nfrom conjur import Client\n\nclient = Client(url='https://conjur.myorg.com',\n account='default',\n login_id='admin',\n password='mypassword',\n ca_bundle='/path/to/my/ca/bundle')\n\nprint(\"Setting variable...\")\nclient.set('conjur/my/variable', 'new value')\n\nprint(\"Fetching variable...\")\nnew_value = client.get('conjur/my/variable')\n\nprint(\"Variable value is:\", new_value.decode('utf-8'))\n```\n\n#### With login Id and API key\n\nWrite the code same as in the first example but create the client with the following arguments:\n\n```python3\nclient = Client(url='https://conjur.myorg.com',\n account='default',\n login_id='admin',\n api_key='myapikey',\n ca_bundle='/path/to/my/ca/bundle')\n```\n\n#### With `.netrc` and `.conjurrc` settings\n\nWrite the code same as in the first example but create the client with the following arguments:\n\n```python3\nclient = Client()\n```\n\n## Currently supported client methods:\n\n#### `get(variable_id)`\n\nGets a variable value based on its ID. Variable is binary data\nthat should be decoded to your system's encoding (e.g.\n`get(variable_id).decode('utf-8')`.\n\n#### `get_many(variable_id[,variable_id...])`\n\nGets multiple variable values based on their IDs. Variables are\nreturned in a dictionary that maps the variable name to its value.\n\n#### `set(variable_id, value)`\n\nSets a variable to a specific value based on its ID.\n\nNote: Policy to create the variable must have been already loaded\notherwise you will get a 404 error during invocation.\n\n#### `apply_policy_file(policy_name, policy_file)`\n\nApplies a file-based YAML to a named policy. This method only\nsupports additive changes. Result is a dictionary object constructed\nfrom the returned JSON data.\n\n#### `replace_policy_file(policy_name, policy_file)`\n\nReplaces a named policy with one from the provided file. This is\nusually a destructive invocation. Result is a dictionary object\nconstructed from the returned JSON data.\n\n#### `list()`\n\nReturns a Python list of all the available resources for the current\naccount.\n\n\n## Contributing\n\nWe store instructions for development and guidelines for how to build and test this\nproject in the [CONTRIBUTING.md](CONTRIBUTING.md) - please refer to that document\nif you would like to contribute.\n\n## License\n\nThis project is [licensed under Apache License v2.0](LICENSE.md)\n\n\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/conjurinc/conjur-api-python3", "keywords": "conjur,cyberark,microservicesprivileged access,security,vault", "license": "MIT", "maintainer": "", "maintainer_email": "", "name": "conjur-client", "package_url": "https://pypi.org/project/conjur-client/", "platform": "", "project_url": "https://pypi.org/project/conjur-client/", "project_urls": { "Homepage": "https://github.com/conjurinc/conjur-api-python3" }, "release_url": "https://pypi.org/project/conjur-client/0.0.3/", "requires_dist": [ "nose2 (>=0.8.0)", "requests (>=2.21.0)", "PyYAML (>=3.13)" ], "requires_python": ">=3.5", "summary": "APIs for interacting with the Conjur v5 appliance", "version": "0.0.3" }, "last_serial": 5704878, "releases": { "0.0.2": [ { "comment_text": "", "digests": { "md5": "5106e1e1919e150d8e2a736e2a0d585f", "sha256": "ed6c9e063fe777386db1267856606516df047eb9056de58d560f8ebc0b611817" }, "downloads": -1, "filename": "conjur_client-0.0.2-py3-none-any.whl", "has_sig": false, "md5_digest": "5106e1e1919e150d8e2a736e2a0d585f", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.5", "size": 29315, "upload_time": "2019-07-12T17:14:21", "url": "https://files.pythonhosted.org/packages/42/b5/94748aef6f33a35022eabd022317a1e13f8d0252f0a1df0d3c17b7c2aa0c/conjur_client-0.0.2-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "383c08086ab3a9ba68c43e9ad14ff6e5", "sha256": "b60167adc43767471be765160c31cb5a41c6d1884e342adf9760e2abb16d9e0d" }, "downloads": -1, "filename": "conjur-client-0.0.2.tar.gz", "has_sig": false, "md5_digest": "383c08086ab3a9ba68c43e9ad14ff6e5", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.5", "size": 21142, "upload_time": "2019-07-12T17:14:24", "url": "https://files.pythonhosted.org/packages/2c/c0/9fb52d6570ce9f415305a26e8dccc630359d5c80b3079e27cc9b62232237/conjur-client-0.0.2.tar.gz" } ], "0.0.3": [ { "comment_text": "", "digests": { "md5": "44d45034313c5a504e59d30efc466067", "sha256": "c3197eefdb321d4433331f25963a20d1133e63228f0ec8be1fba8eb94832b84f" }, "downloads": -1, "filename": "conjur_client-0.0.3-py3-none-any.whl", "has_sig": false, "md5_digest": "44d45034313c5a504e59d30efc466067", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.5", "size": 29444, "upload_time": "2019-08-20T18:18:40", "url": "https://files.pythonhosted.org/packages/ff/6b/216ba702bf4894b646afa1ab40b50c9c812c8f426432dc422073d9986f75/conjur_client-0.0.3-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "2a4f327b5d98e49f403d55e65314f0ed", "sha256": "e07b4e7344543baa2f9cad77666dd39c3fe883b260574beee73e5596b4e0a98f" }, "downloads": -1, "filename": "conjur-client-0.0.3.tar.gz", "has_sig": false, "md5_digest": "2a4f327b5d98e49f403d55e65314f0ed", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.5", "size": 21231, "upload_time": "2019-08-20T18:18:41", "url": "https://files.pythonhosted.org/packages/17/71/fc7fa70a9b678440fbee106f22872f07adf9aea6dc3b18537dfc42cde867/conjur-client-0.0.3.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "44d45034313c5a504e59d30efc466067", "sha256": "c3197eefdb321d4433331f25963a20d1133e63228f0ec8be1fba8eb94832b84f" }, "downloads": -1, "filename": "conjur_client-0.0.3-py3-none-any.whl", "has_sig": false, "md5_digest": "44d45034313c5a504e59d30efc466067", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.5", "size": 29444, "upload_time": "2019-08-20T18:18:40", "url": "https://files.pythonhosted.org/packages/ff/6b/216ba702bf4894b646afa1ab40b50c9c812c8f426432dc422073d9986f75/conjur_client-0.0.3-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "2a4f327b5d98e49f403d55e65314f0ed", "sha256": "e07b4e7344543baa2f9cad77666dd39c3fe883b260574beee73e5596b4e0a98f" }, "downloads": -1, "filename": "conjur-client-0.0.3.tar.gz", "has_sig": false, "md5_digest": "2a4f327b5d98e49f403d55e65314f0ed", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.5", "size": 21231, "upload_time": "2019-08-20T18:18:41", "url": "https://files.pythonhosted.org/packages/17/71/fc7fa70a9b678440fbee106f22872f07adf9aea6dc3b18537dfc42cde867/conjur-client-0.0.3.tar.gz" } ] }