apigeecli 0.49.3

(Unofficial) Apigee Management API command-line interface with multi-factor authentication (MFA) and single sign-on (SSO)/SAML support

Welcome to the (Unofficial) Apigee Management API command-line interface!

It is designed to provide a simple command-line experience with CI/CD and SSO features in mind.

More details can be found in The Apigee Management API command-line interface documentation.

This is not an officially supported Google product, and is not affiliated with Apigee or Google in any way.

Please note that this CLI is still highly experimental and may change significantly based on client needs.

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"]

Why does this exist?

Apigee CLI is a user-friendly command-line interface to the Apigee Edge Management API providing automation capabilities with multi-factor authentication (MFA) and single sign-on (SSO)/SAML support. It is intended for general administrative use from your shell, as a package for developers, and to support automation for common development tasks, such as test automation or Continuous Integration/Continuous Deployment (CI/CD).

Third-party plugins

The Apigee CLI also supports the ability to load third-party plugins (to be documented) as additional commands which enables us (and third-party developers) to distribute their own commands for very specific use cases, including those do not require any interaction with the Apigee Management API, while being able to leverage the command-line interface without any knowledge of the CLI internals.

When to use this over the official tool

Apigee Corporation maintains their own fully-featured CLI for the Apigee Management API that can be used as an SDK to orchestrate tasks and may be more than suitable for your needs.

Our Apigee CLI provides a simpler command-line experience with CI/CD and SSO features in mind.

We built and use the Apigee CLI to implement and distribute features that allow our clients to manage CI/CD, perform self-service operations and promote our DevOps workflows in ways that are not supported by official tools.

Getting Help

• The Apigee Management API command-line interface documentation

• Apigee Product Documentation

More Links

• GitHub

• Mirror

• Python Package Index (PyPI)

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

Disclaimer

This is not an officially supported Google product.