# strongDM SDK for Python
This is the official [strongDM](https://www.strongdm.com/) SDK for the Python
programming language.
Learn more with our [đź“šstrongDM API docs](https://www.strongdm.com/docs/api/) or
[đź““browse the SDK
reference](https://strongdm.github.io/strongdm-sdk-python-docs/).
## Installation
```bash
$ pip install strongdm
```
strongDM uses [semantic versioning](https://semver.org/). We do not guarantee
compatibility between major versions. Be sure to use version constraints to pin
your dependency to the desired major version of the strongDM SDK.
## Authentication
If you don't already have them you will need to generate a set of API keys,
instructions are here: [API
Credentials](https://www.strongdm.com/docs/admin-guide/api-credentials/)
Add the keys as environment variables; the SDK will need to access these keys
for every request.
```bash
$ export SDM_API_ACCESS_KEY=<YOUR ACCESS KEY>
$ export SDM_API_SECRET_KEY=<YOUR SECRET KEY>
```
## List Users
The following code lists all registered users:
```python
import os
import strongdm
def main():
client = strongdm.Client(os.getenv("SDM_API_ACCESS_KEY"),
os.getenv("SDM_API_SECRET_KEY"))
users = client.accounts.list('')
for user in users:
print(user)
if __name__ == "__main__":
main()
```
## Useful Links
- Documentation: [strongdm package](https://strongdm.github.io/strongdm-sdk-python-docs/)
- [Migrating from v2 to v3](https://github.com/strongdm/strongdm-sdk-python/releases/tag/v3.0.0)
- [Migrating from Role Grants to Access Rules](https://github.com/strongdm/strongdm-sdk-python/wiki/Migrating-from-Role-Grants-to-Access-Rules)
- Examples: [GitHub - strongdm/strongdm-sdk-python-examples](https://github.com/strongdm/strongdm-sdk-python-examples)
1. [Managing Resources](https://github.com/strongdm/strongdm-sdk-python-examples/tree/master/1_managing_resources)
2. [Managing Accounts](https://github.com/strongdm/strongdm-sdk-python-examples/tree/master/2_managing_accounts)
3. [Managing Roles](https://github.com/strongdm/strongdm-sdk-python-examples/tree/master/3_managing_roles)
4. [Managing Gateways](https://github.com/strongdm/strongdm-sdk-python-examples/tree/master/4_managing_gateways)
5. [Auditing](https://github.com/strongdm/strongdm-sdk-python-examples/tree/master/5_auditing)
6. [Managing Access Workflows](https://github.com/strongdm/strongdm-sdk-python-examples/tree/master/6_managing_workflows)
## License
[Apache 2](https://github.com/strongdm/strongdm-sdk-python/blob/master/LICENSE)
## Contributing
Currently, we are not accepting pull requests directly to this repository, but
our users are some of the most resourceful and ambitious folks out there. So, if
you have something to contribute, find a bug, or just want to give us some
feedback, please email <support@strongdm.com>.
Raw data
{
"_id": null,
"home_page": "https://github.com/strongdm/strongdm-sdk-python",
"name": "strongdm",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "strongDM, sdm, api, automation, security, audit, database, server, ssh, rdp",
"author": "strongDM Team",
"author_email": "sdk-feedback@strongdm.com",
"download_url": "https://files.pythonhosted.org/packages/40/7a/06538f8ee62a21c594efcdc2b914baeb1ae175d256939efbdf421996a210/strongdm-8.0.0.zip",
"platform": null,
"description": "# strongDM SDK for Python\n\nThis is the official [strongDM](https://www.strongdm.com/) SDK for the Python\nprogramming language.\n\nLearn more with our [\ud83d\udcdastrongDM API docs](https://www.strongdm.com/docs/api/) or\n[\ud83d\udcd3browse the SDK\nreference](https://strongdm.github.io/strongdm-sdk-python-docs/).\n\n## Installation\n\n```bash\n$ pip install strongdm\n```\n\nstrongDM uses [semantic versioning](https://semver.org/). We do not guarantee\ncompatibility between major versions. Be sure to use version constraints to pin\nyour dependency to the desired major version of the strongDM SDK.\n\n## Authentication\n\nIf you don't already have them you will need to generate a set of API keys,\ninstructions are here: [API\nCredentials](https://www.strongdm.com/docs/admin-guide/api-credentials/)\n\nAdd the keys as environment variables; the SDK will need to access these keys\nfor every request.\n\n```bash\n$ export SDM_API_ACCESS_KEY=<YOUR ACCESS KEY>\n$ export SDM_API_SECRET_KEY=<YOUR SECRET KEY>\n```\n\n## List Users\n\nThe following code lists all registered users:\n\n```python\nimport os\nimport strongdm\n\ndef main():\n client = strongdm.Client(os.getenv(\"SDM_API_ACCESS_KEY\"),\n os.getenv(\"SDM_API_SECRET_KEY\"))\n\n users = client.accounts.list('')\n for user in users:\n print(user)\n\nif __name__ == \"__main__\":\n main()\n```\n\n## Useful Links\n\n- Documentation: [strongdm package](https://strongdm.github.io/strongdm-sdk-python-docs/)\n- [Migrating from v2 to v3](https://github.com/strongdm/strongdm-sdk-python/releases/tag/v3.0.0)\n- [Migrating from Role Grants to Access Rules](https://github.com/strongdm/strongdm-sdk-python/wiki/Migrating-from-Role-Grants-to-Access-Rules)\n- Examples: [GitHub - strongdm/strongdm-sdk-python-examples](https://github.com/strongdm/strongdm-sdk-python-examples)\n 1. [Managing Resources](https://github.com/strongdm/strongdm-sdk-python-examples/tree/master/1_managing_resources)\n 2. [Managing Accounts](https://github.com/strongdm/strongdm-sdk-python-examples/tree/master/2_managing_accounts)\n 3. [Managing Roles](https://github.com/strongdm/strongdm-sdk-python-examples/tree/master/3_managing_roles)\n 4. [Managing Gateways](https://github.com/strongdm/strongdm-sdk-python-examples/tree/master/4_managing_gateways)\n 5. [Auditing](https://github.com/strongdm/strongdm-sdk-python-examples/tree/master/5_auditing)\n 6. [Managing Access Workflows](https://github.com/strongdm/strongdm-sdk-python-examples/tree/master/6_managing_workflows)\n\n## License\n\n[Apache 2](https://github.com/strongdm/strongdm-sdk-python/blob/master/LICENSE)\n\n## Contributing\n\nCurrently, we are not accepting pull requests directly to this repository, but\nour users are some of the most resourceful and ambitious folks out there. So, if\nyou have something to contribute, find a bug, or just want to give us some\nfeedback, please email <support@strongdm.com>.\n\n\n",
"bugtrack_url": null,
"license": "apache-2.0",
"summary": "strongDM SDK for the Python programming language.",
"version": "8.0.0",
"project_urls": {
"Download": "https://github.com/strongdm/strongdm-sdk-python/archive/v8.0.0.tar.gz",
"Homepage": "https://github.com/strongdm/strongdm-sdk-python"
},
"split_keywords": [
"strongdm",
" sdm",
" api",
" automation",
" security",
" audit",
" database",
" server",
" ssh",
" rdp"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "407a06538f8ee62a21c594efcdc2b914baeb1ae175d256939efbdf421996a210",
"md5": "f6abc88889a4b525c8388a674d70ea89",
"sha256": "50a1011f471a386a8f4c4e845aef579a58657c58a5543f2b7f108d9fb6b1be6c"
},
"downloads": -1,
"filename": "strongdm-8.0.0.zip",
"has_sig": false,
"md5_digest": "f6abc88889a4b525c8388a674d70ea89",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 376498,
"upload_time": "2024-04-09T19:47:05",
"upload_time_iso_8601": "2024-04-09T19:47:05.500970Z",
"url": "https://files.pythonhosted.org/packages/40/7a/06538f8ee62a21c594efcdc2b914baeb1ae175d256939efbdf421996a210/strongdm-8.0.0.zip",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-04-09 19:47:05",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "strongdm",
"github_project": "strongdm-sdk-python",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "strongdm"
}
JSON
