/pyark

CyberArk Enterprise Password Vault API CLI tool

Primary LanguagePythonGNU General Public License v3.0GPL-3.0

Pyark

Travis PyPi License

Pyark is a small python-based CLI tool, which allows you to interact with the CyberArk Enterprise Password Vault API.

Features

Currently the following functionalities are supported:

  • Get accounts
  • Create accounts
  • Delete accounts

Requirements

Make sure to have the following Python 3 dependencies installed before using the tool:

  • python-requests

Furthermore it's important to know which version of the CyberArk Password Vault is used as only the newest versions expose all API endpoints. Make sure to double check the API documentation, specific for your version, in case the tool fails to interact with the API.

Installation

Simply clone this repository and start using the script. You can also install it using setup.py or pip.

Examples

Get a list of available accounts:

$ pyark --base https://vault.example.com \
        --apiuser foobar                 \
        --apipassword supersecret42      \
        account get                      \
        --safe MySafe                    \
        --keywords bruce

Create a new account:

$ pyark --base https://vault.example.com \
        --apiuser foobar                 \
        --apipassword supersecret42      \
        account create                   \
        --safe MySafe                    \
        --platformid TestPlatform        \
        --accountname brucewayne         \
        --address batcave.example.com    \
        --username brucew                \
        --password d4rkkn1ght

Delete an existing account:

$ pyark --base https://vault.example.com \
        --apiuser foobar                 \
        --apipassword supersecret42      \
        account delete                   \
        --safe MySafe                    \
        --accountname brucewayne         \
        --keywords bruce

Contributions

Contributions are more than welcome! Please feel free to open new issues or pull requests.

License

GNU GENERAL PUBLIC LICENSE Version 3

See the LICENSE file.