apigeecli

========== apigee-cli

|Python version| |Downloads| |License|

.. warning::

This tool is no longer actively maintained.

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.

Initially developed for Darumatic clients, this project remains available as a functional proof of concept and has proven reliable in production CI/CD pipelines. I do not plan to maintain this public version, but you're welcome to explore and learn from the code. The custom plugins feature will continue to work even if the Apigee Edge APIs become unavailable.

If you’re up for a challenge, try updating the code to work with Apigee X

Why use this instead of the official tool

The official Apigee CLI_ is powerful and may suit your needs. However, I built this version to better support our CI/CD processes, self-service operations, and DevOps workflows that are difficult to manage with the official tool.

Installation

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

Getting Started

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.

^^^^^^^^^^^^^^^^^^^^ Basic authentication ^^^^^^^^^^^^^^^^^^^^

::

$ apigee configure -P default -u MY_EMAIL -p MY_PASS -o MY_ORG -mfa '' -z '' --no-token --prefix ''

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Multi-factor authentication (MFA) ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

::

$ apigee configure -P default -u MY_EMAIL -p MY_PASS -o MY_ORG -mfa MY_KEY -z '' --no-token --prefix ''

^^^^^^^^^^^^^^^^^^ SSO authentication ^^^^^^^^^^^^^^^^^^

::

$ 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_.

^^^^^^^^^^^^^^^^^^^^^^^^ Testing your credentials ^^^^^^^^^^^^^^^^^^^^^^^^

Run the following command to get a list of API proxies in your default Apigee organization::

$ apigee apis list
["helloworld", "oauth"]

Running Tests

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:

.. code-block:: bash

pip3 install coverage

Once coverage.py is installed, you can run the tests using the runtests script:

.. code-block:: bash

./runtests

This script will run all the tests in the tests directory and generate a coverage report.

Getting Help

• Apigee Product Documentation_

More Links

• GitHub_
• Mirror_
• Python Package Index (PyPI)_

For further questions, feel free to contact us at [e-mail].

Disclaimer

This tool is not affiliated with Apigee or Google and is highly experimental.

.. _official Apigee CLI: https://github.com/apigee/apigeetool-node

.. |Upload Python Package badge| image:: https://github.com/mdelotavo/apigee-cli/workflows/Upload%20Python%20Package/badge.svg :target: https://github.com/mdelotavo/apigee-cli/actions?query=workflow%3A%22Upload+Python+Package%22

.. |Python package badge| image:: https://github.com/mdelotavo/apigee-cli/workflows/Python%20package/badge.svg :target: https://github.com/mdelotavo/apigee-cli/actions?query=workflow%3A%22Python+package%22

.. |Code style: black| image:: https://img.shields.io/badge/code%20style-black-000000.svg :target: https://github.com/psf/black

.. |PyPI| image:: https://img.shields.io/pypi/v/apigeecli :target: https://pypi.org/project/apigeecli/

.. |License| image:: https://img.shields.io/badge/License-Apache%202.0-blue.svg :target: https://opensource.org/licenses/Apache-2.0

.. |Python version| image:: https://img.shields.io/pypi/pyversions/apigeecli :target: https://pypi.org/project/apigeecli/

.. |PyPI Version| image:: https://badge.fury.io/py/apigeecli.svg :target: https://badge.fury.io/py/apigeecli

.. |Downloads| image:: https://pepy.tech/badge/apigeecli :target: https://pepy.tech/project/apigeecli

.. _Apigee Product Documentation: https://apidocs.apigee.com/management/apis

.. _Permissions reference: https://docs.apigee.com/api-platform/system-administration/permissions

.. _Add permissions to testing role: https://docs.apigee.com/api-platform/system-administration/managing-roles-api#addpermissionstotestingrole

.. _pip: http://www.pip-installer.org/en/latest/

.. _Universal Command Line Interface for Amazon Web Services: https://github.com/aws/aws-cli

.. _The Apigee Management API command-line interface documentation: https://darumatic.github.io/apigee-cli/index.html

.. _GitHub: https://github.com/darumatic/apigee-cli

.. _Python Package Index (PyPI): https://pypi.org/project/apigeecli/

.. _Access the Edge API with SAML: https://docs.apigee.com/api-platform/system-administration/using-saml

.. _Commands cheatsheet: https://github.com/mdelotavo/apigee-cli-docs

.. _Using SAML with automated tasks: https://github.com/mdelotavo/apigee-cli-docs

.. _Tabulating deployments: https://github.com/mdelotavo/apigee-cli-docs

.. _Tabulating resource permissions: https://github.com/mdelotavo/apigee-cli-docs

.. _Troubleshooting: https://github.com/mdelotavo/apigee-cli-docs

.. _Mirror: https://github.com/mdelotavo/apigee-cli

.. _Apigee CI/CD Docker releases: https://hub.docker.com/r/darumatic/apigee-cicd