Getting started
You can easily install the self-hosted gateway with Docker:
docker run -d -p 8080:8080 -p 8081:8081 --name <gateway-name> --envconfig.service.endpoint=<instance-name>.configuration.azure-api.net
config.service.auth=<auth-token> mcr.microsoft.com/azure-api-management/gateway:2.7.0
Learn how you can install it on other container platforms:
- Deploy self-hosted gateway on Kubernetes with Helm
- Deploy self-hosted gateway on Kubernetes with Azure Arc (Preview)
- Deploy self-hosted gateway on Kubernetes with YAML
Here are other relevant resources:
- Authenticate self-hosted gateway with Azure AD
- Self-hosted gateway on Microsoft Artifact Registry
- Our image tagging strategy
What is new?
Features
- Support for WebSocket APIs is now generally available (GA)
- Support for decryption keys to the validate-azure-ad-token policy
Fixes / Changes
- Fixed a bug where expressions did not work as expected for in the elements in the validate-jwt policy
- Fixed a bug where JSON payloads are malformed when log volume is high (#278)
- Improve Configuration API integration logging for improved support/troubleshooting:
- Provide information about request path that failed
- Provide
RequestId
in all logs that helps during support cases
- Fixed a bug where Configuration API integration will fail with 404 because of missing sanitizing of
gateway.name
setting (Entra ID authentication only) - Fix for all CVEs
- Various improvements
Breaking Changes
- Automatic failover to Configuration API v1 is no longer supported given it is no longer supported since October 1st, 2023
Removal
None.