| Name | beyondtrust-bips-cli JSON |
| Version |
0.10.0
JSON |
| download |
| home_page | None |
| Summary | PS CLI is a CLI tool designed to allow the execution of BeyondInsight and Password Safe API calls |
| upload_time | 2025-10-17 20:33:30 |
| maintainer | None |
| docs_url | None |
| author | BeyondTrust Corporation |
| requires_python | <3.14,>=3.12 |
| license | None |
| keywords |
|
| VCS |
|
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
[](https://docs.jfrog-applications.jfrog.io/jfrog-applications/frogbot)
# ps-cli
The Password Safe CLI Application is an efficient Command Line Interface (CLI) tool specifically crafted to interface with the Beyond Insight and Password Safe APIs (version 24.3). This application allows users to access various API resources, including safes, folders, secrets, managed accounts, and more. It offers a user-friendly interface that simplifies command parsing, ensures input validation, and delivers detailed output.
# Available environment variables
## Required:
- **PSCLI_API_URL**: Beyond Insight and Password Safe API URL. This can also be set in the settings file.
- **PSCLI_CLIENT_ID**: Client ID to use when requesting data from the API. This can also be set in the settings file.
- **PSCLI_CLIENT_SECRET**: Client secret to use when requesting data from the API. This can also be set in the settings file.
## Optional:
- **PSCLI_SETTINGS_PATH**: Custom settings path to use for `ps-cli`. By default, the settings file is created in the user's home directory (~).
- **PSCLI_AUTH_RETRIES**: The number of times `ps-cli` should attempt to authenticate in case of an error.
- **PSCLI_TIMEOUT_CONNECTION**: How long to wait for the server to connect and send data before giving up. Integer value defined in seconds, by default 30 seconds.
- **PSCLI_TIMEOUT_REQUEST**: How long to wait for each request made to the API. Defined in seconds, by default 30 seconds.
# Prerequisites
- Python 3.12+
- Password Safe version 24.3
# Getting started
- Install `ps-cli` (package name: `beyondtrust-bips-cli`)
```sh
pip install beyondtrust-bips-cli
```
- Check that `ps-cli` is properly installed:
```sh
ps-cli -h
# Output usage instructions:
usage: ps-cli [-h] [-v] [-l {DEBUG,INFO,WARNING,ERROR,CRITICAL}] [--format {json,csv,tsv}] [--delimiter {,,;, ,|, }]
[-av {3.0,3.1}]
{safes,folders,secrets,settings} ...
```
- Create the settings file using:
By default, the settings file is created in the user's home directory (~). If you would like to specify a custom path for the settings, you can achieve this by setting the **PSCLI_SETTINGS_PATH** environment variable. If you're using the custom settings path (PSCLI_SETTINGS_PATH), set it before running the settings initialization command:
```sh
ps-cli settings initialize-settings
```
After creating the settings file, proceed to edit it and configure the **api_url**, **client_id**, and **client_secret**, in case you did not define this configuration using the available environment variables (PSCLI_API_URL, PSCLI_CLIENT_ID and PSCLI_CLIENT_SECRET).
You can find more details on `ps-cli` official [documentation](https://docs.beyondtrust.com/).
Raw data
{
"_id": null,
"home_page": null,
"name": "beyondtrust-bips-cli",
"maintainer": null,
"docs_url": null,
"requires_python": "<3.14,>=3.12",
"maintainer_email": null,
"keywords": null,
"author": "BeyondTrust Corporation",
"author_email": "support@beyondtrust.com",
"download_url": "https://files.pythonhosted.org/packages/bf/58/d5b28bc71a717bda8f843248f922e9608e24a809d5994747832e9228f440/beyondtrust_bips_cli-0.10.0.tar.gz",
"platform": null,
"description": "[](https://docs.jfrog-applications.jfrog.io/jfrog-applications/frogbot)\n\n# ps-cli\nThe Password Safe CLI Application is an efficient Command Line Interface (CLI) tool specifically crafted to interface with the Beyond Insight and Password Safe APIs (version 24.3). This application allows users to access various API resources, including safes, folders, secrets, managed accounts, and more. It offers a user-friendly interface that simplifies command parsing, ensures input validation, and delivers detailed output.\n\n\n# Available environment variables\n\n## Required:\n- **PSCLI_API_URL**: Beyond Insight and Password Safe API URL. This can also be set in the settings file.\n- **PSCLI_CLIENT_ID**: Client ID to use when requesting data from the API. This can also be set in the settings file.\n- **PSCLI_CLIENT_SECRET**: Client secret to use when requesting data from the API. This can also be set in the settings file.\n\n## Optional:\n- **PSCLI_SETTINGS_PATH**: Custom settings path to use for `ps-cli`. By default, the settings file is created in the user's home directory (~).\n- **PSCLI_AUTH_RETRIES**: The number of times `ps-cli` should attempt to authenticate in case of an error.\n- **PSCLI_TIMEOUT_CONNECTION**: How long to wait for the server to connect and send data before giving up. Integer value defined in seconds, by default 30 seconds.\n- **PSCLI_TIMEOUT_REQUEST**: How long to wait for each request made to the API. Defined in seconds, by default 30 seconds.\n\n\n# Prerequisites\n\n- Python 3.12+\n- Password Safe version 24.3\n\n\n# Getting started\n\n- Install `ps-cli` (package name: `beyondtrust-bips-cli`)\n\n```sh\npip install beyondtrust-bips-cli\n```\n\n- Check that `ps-cli` is properly installed:\n\n```sh\nps-cli -h\n# Output usage instructions:\nusage: ps-cli [-h] [-v] [-l {DEBUG,INFO,WARNING,ERROR,CRITICAL}] [--format {json,csv,tsv}] [--delimiter {,,;, ,|, }]\n [-av {3.0,3.1}]\n {safes,folders,secrets,settings} ...\n```\n\n\n- Create the settings file using:\n\nBy default, the settings file is created in the user's home directory (~). If you would like to specify a custom path for the settings, you can achieve this by setting the **PSCLI_SETTINGS_PATH** environment variable. If you're using the custom settings path (PSCLI_SETTINGS_PATH), set it before running the settings initialization command:\n\n```sh\nps-cli settings initialize-settings\n```\n\nAfter creating the settings file, proceed to edit it and configure the **api_url**, **client_id**, and **client_secret**, in case you did not define this configuration using the available environment variables (PSCLI_API_URL, PSCLI_CLIENT_ID and PSCLI_CLIENT_SECRET).\n\n\nYou can find more details on `ps-cli` official [documentation](https://docs.beyondtrust.com/).\n\n",
"bugtrack_url": null,
"license": null,
"summary": "PS CLI is a CLI tool designed to allow the execution of BeyondInsight and Password Safe API calls",
"version": "0.10.0",
"project_urls": null,
"split_keywords": [],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "dcea71f2ca72a7fd1bc3f90c37f60ae09eedb0b418ce2bb2c72919b617645453",
"md5": "9069b0cf8cf2045ca664aa71488a48e3",
"sha256": "98d05f6ba7da2e4daf5a49bfd95c1e2c4928cde215d332290a6c746240fcbed5"
},
"downloads": -1,
"filename": "beyondtrust_bips_cli-0.10.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "9069b0cf8cf2045ca664aa71488a48e3",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<3.14,>=3.12",
"size": 98249,
"upload_time": "2025-10-17T20:33:29",
"upload_time_iso_8601": "2025-10-17T20:33:29.166723Z",
"url": "https://files.pythonhosted.org/packages/dc/ea/71f2ca72a7fd1bc3f90c37f60ae09eedb0b418ce2bb2c72919b617645453/beyondtrust_bips_cli-0.10.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "bf58d5b28bc71a717bda8f843248f922e9608e24a809d5994747832e9228f440",
"md5": "653504ad21148ad0d4ecf8329c0edb96",
"sha256": "d1346ae787ec896f6118c2041ea478e6a4a5d34984b0d6dadc197e0c9f818c4a"
},
"downloads": -1,
"filename": "beyondtrust_bips_cli-0.10.0.tar.gz",
"has_sig": false,
"md5_digest": "653504ad21148ad0d4ecf8329c0edb96",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<3.14,>=3.12",
"size": 59748,
"upload_time": "2025-10-17T20:33:30",
"upload_time_iso_8601": "2025-10-17T20:33:30.466219Z",
"url": "https://files.pythonhosted.org/packages/bf/58/d5b28bc71a717bda8f843248f922e9608e24a809d5994747832e9228f440/beyondtrust_bips_cli-0.10.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-10-17 20:33:30",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "beyondtrust-bips-cli"
}
