Full Azure API Management suite and more VSTS extension

THE PROJECT IS NOT MAINTAINED ANYMORE. THIS EXTENSION WAS CREATED AT A TIME WHERE NO REAL USABLE ALTERNATIVE WAS AVAILABLE. TODAY, YOU CAN NATIVELY USE TERRAFORM AND BICEP TO TACKLE THIS.

The purpose of this extension is to bring Azure API Management into VSTS as part of your release lifecyle. Whether you use API Management to monetize APIS or for internal purposes, it is good to associate the release of your backends APIs with their corresponding facade APIs published against the API Gateway. On top of the API Management integration, the extension also ships with an API Security Checker that helps validating that all endpoints of an API are well secured, this is of course only applicable to non-public APIs.

• Removed all tasks not upgraded to latest apim version - Velocity Cubed

• Updated API Create or Add to support version 2021-08-01 - Velocity Cubed

• Added the possibility to use previously created / updated operations - Serge Aradj

• Addition of the subscription flag to non-versioned APIs - Sorin Pasa
• Possibility to support non-commercial endpoint - Joey Eng

• New task to manage API Revisions

• Making it possible to publish new revision as current revision

• Support of API revisions in operation-level policies
• Support of API revisions in API-level policies
• Support of API revisions for versioned APIs

• Fixed a bug when redeploying existing version
• Added the possibility to use dots in version numbers.

• Support of OpenAPI v3
• New task to create or update global policy.
• ARM API version selector added to two of the tasks

• New task to set policies on API operations. Kudos: Luis Ruiz Pavon
• Ability to choose the Azure ARM API version to work with. Kudos:Jacques Snyman

• It is now possible to push and restore the configuration to the underlying Git repo. Kudos:Justin Marshall

• Security Groups get created on the fly when creating/updating products
• APIs can be linked to multiple products Kudos:Luis Ruiz Pavon

• Added the possibility to associate groups to products. Author: Luis Ruiz Pavon

• New task to import legacy services from WSDL: SOAP Pass-Through and SOAP to REST. Author: Luis Ruiz Pavon

• Minor improvements in the policy templates
• Product creation task revisited to with visibility rules
• Support of OAuth2 servers and OpenID Connect integration. Note that if you double check the authorization settings in the portal, you might need to refresh the page multiple times before it gets rendered correctly.

The below features were added.

• Versioning Scheme (Segment, Query String, HTTP Header)
• Inline Swagger and Swagger as a build artifact
• API Suffix

• Switched the input type from "string" to "multiline" for policies
• Added a new policy of type "custom"

Update of the documentation.

• Supports versioned APIs
• Creation of API products on the fly
• Supports both API and Product policies
• Supports the creation of APIs on top of Azure Functions
• API Security checker

In order to use this extension, you must have an ARM Service Endpoint configured in VSTS and make sure this endpoint is allowed to contribute to API Management instances. This can easily be done by granting Subscription Contributor role or the ad-hoc API Management Service Contributor role. Similarly, the endpoint should have access to the Azure Functions should you plan to use the tasks related to Azure Functions.

Depending on your usage of API Management, some extra considerations should also be paid attention to. If your backend APIs are part of a dedicated VNET, make sure the VSTS agents have connectivity to them. In case you provide a web URL for the Swagger definition, the extension makes use of Swagger import and downloads the Swagger definition of the backend API. Therefore, connectivity between the VSTS agent and the target API is required. If you do not have such connectivity, you should fallback to in-line Swagger (provided as a piece of text) or a Swagger from file provided as a build artifact. For the latter, you might want to use a Config Transformation task as part of your release definition in order to inject the right API host as shown below:

where in this case, the APIHost variable is defined as a enviromnment-scoped release variable.

API description and display name come from the OpenAPI definition itself, that's the reason why these settings are not captured by the tasks.

A few tasks allow to set policies at product and/or API level. They come with some pre-defined policies which you can override to adjust them to specific needs. You can easily use other policies by getting the default boilerplate config from the APIM Portal.

This task allows you to create a new Gateway API or update an existing one, against backend APIs.

where you reference the Swagger location as well as the API suffix and optionally a policy that governs the API such as a JWT validation policy. Note that you can create gateway APIs based on WSDL files.