Warning
This tool is no longer actively maintained.
Warning
We primarily use and test with SSO; basic and MFA authentication may still work, but we no longer use or test them.
The Apigee Edge command-line interface is an unofficial Python command-line tool built to simplify and automate Apigee Edge API usage, with support for SSO, MFA, and basic authentication.
While the official Apigee CLI is powerful, this tool was created to better support Darumatic clients’ CI/CD and self-service workflows that were difficult to manage with the official tool, using simple and easily editable code to demonstrate how to leverage the Apigee Admin APIs.
The easiest way to install apigee-cli is to use pip in a virtualenv:
$ pip install apigeecli
or, if you are not installing in a virtualenv, to install globally:
$ sudo pip install apigeecli
or for your user:
$ pip install --user apigeecli
If you have the apigee-cli installed and want to upgrade to the latest version you can run:
$ pip install --upgrade apigeecli
Before using apigee-cli, you need to tell it about your Apigee Edge credentials. You can do this in three ways:
- Environment variables
- Config file
- Command-line arguments
The steps below show how to use command-line arguments to configure your Apigee Edge credentials.
$ apigee configure -P default -u MY_EMAIL -p MY_PASS -o MY_ORG -mfa '' -z '' --no-token --prefix ''
$ apigee configure -P default -u MY_EMAIL -p MY_PASS -o MY_ORG -mfa MY_KEY -z '' --no-token --prefix ''
$ apigee configure -P default -u MY_EMAIL -p none -o MY_ORG -mfa '' -z MY_ZONENAME --no-token --prefix ''
If you are not currently signed in by your identity provider, you will be prompted to sign in:
$ apigee apis list
SSO authorization page has automatically been opened in your default browser.
Follow the instructions in the browser to complete this authorization request.
If your browser did not automatically open, go to the following URL and sign in:
https://{zoneName}.login.apigee.com/passcode
then copy the Temporary Authentication Code.
Please enter the Temporary Authentication Code:
zoneName will be the Identity zone name you previously configured.
Refer to the official Apigee documentation to learn more about how to Access the Edge API with SAML.
Run the following command to get a list of API proxies in your default Apigee organization:
$ apigee apis list ["helloworld", "oauth"]
If you encounter issues with commands, check the log file for detailed debug information and error messages:
~/.apigee/exceptions.log
This file can help diagnose installation problems, missing dependencies, or errors related to Apigee Edge.
You can also use the verbose flags -v or -vv with commands to see more detailed request information.
This project uses unittest for testing its codebase. In order to run the tests, you will need to install the coverage.py tool. You can install it using pip:
pip3 install coverageOnce coverage.py is installed, you can run the tests using the runtests script:
./runtestsThis script will run all the tests in the tests directory and generate a coverage report.
For further questions, feel free to contact us at hello@darumatic.com.
This tool is not affiliated with Apigee or Google and is highly experimental.