Adding and configuring an extension

Before you can use an extension from an API proxy, you'll need to add and configure the extension. Apigee Edge includes several installed extension packages. When you add an extension, you locate the extension package that represents the external resource you want to integrate with your API proxy, then add and configure an extension from that package.

When you configure an extension from an extension package, you specify values that focus the extension's interaction with its external resource. For example, when you configure a Google Cloud Firestore Extension, you specify which database the extension should use when creating, getting, and deleting documents. Each extension has its own set of configuration properties that correspond to aspects of the resource it interacts with. For a list of included extensions, see Extensions reference overview.

Typically, each extension's configuration includes the credentials the extension should use to authenticate with the resource on your behalf.

You access an extension from an API proxy with an Extension Callout policy.

For an overview of extensions, see What are extensions? For a tutorial to get started, see Tutorial: Adding and using an extension.

Adding and configuring an extension

  1. In the New Edge experience, click the Admin menu, then click Extensions.

    The Extensions page that appears lists all of the extensions that have been configured from extension packages available on the system. If you wanted to view an existing configured extension, you could filter the list by typing filtering terms at the top of the page.

    In the next steps, you'll add your own connector.

  2. In the Extension page, click Add Extension.

  3. Under Select an extension, locate the extension corresponding to the external resource you're accessing.

    • In the box for the extension package, you can click View Details to view information about the extension's version, author, and so on.
  4. Click the box for the extension package to begin configuring an extension from the package.

  5. In the Extension Properties dialog box, enter a name and description for the extension, then click Create.

  6. In the Extension > My-Extension-Name page for the extension you're creating, locate an Apigee Edge environment for which you want to configure the extension.

    This should be the same environment to which your API proxy is deployed. An extension must be deployed to the same environment as the API proxy that will be using it.

  7. Click the environment's row in the list.

  8. In the Configuration dialog, select or enter values to configure this extension.

    Each extension has its own configuration properties. For descriptions of the properties, use the extension's reference. Extension references are listed in Extensions reference overview.

  9. Click Save.

Deploying an extension

  1. In the Extension > My-Extension-Name page for the extension, click Deploy to deploy the extension for use from an API proxy.