Bijna geen organisatie draait op maar één API gateway. Het ene team kiest de Kong API gateway voor Kubernetes, een ander draait AWS API Gateway, en een oude on premises gateway blijft verkeer afhandelen waar niemand aan durft te komen. Gartner verwacht dat in 2028 meer dan 75% van de organisaties twee of meer API gateways gebruikt. Met API gateway federation beheer je ze allemaal vanuit één plek, zonder ook maar één API te verhuizen.
In deze handleiding zie je hoe WSO2 API Manager 4.7 API’s op Kong Gateway ontdekt, ze gesynchroniseerd houdt en ze in één developer portal aanbiedt. Je hebt geen extra libraries of configuratiebestanden nodig: de Kong connector zit standaard in het product.
Belangrijkste punten
- API gateway federation scheidt het control plane (WSO2 API Manager) van de runtime gateways, zodat API’s blijven draaien waar ze nu al draaien.
- WSO2 API Manager 4.7 heeft een ingebouwde Kong connector. Je hebt een Kong Konnect personal access token nodig en drie gegevens uit je Kong control plane.
- Discovery draait volgens een schema. Wijzigingen in Kong leveren een nieuwe API revisie op in WSO2, geen duplicaat.
- Kong en Envoy ondersteunen alleen discovery. AWS API Gateway en Azure API Management ondersteunen ook deployment vanuit WSO2.
- Het addertje: discovery zet Kong plugin policies niet om naar WSO2 policies. Plan die stap apart.
De technische uitdaging: waarom hebben teams meerdere API gateways?
Teams belanden bij meerdere API gateways omdat elke platformkeuze lokaal logisch was. Elke gateway wordt daarna een eigen silo, met een eigen manier om API’s te beheren, te beveiligen en beschikbaar te stellen.
Het probleem is governance, niet connectiviteit. Gartner waarschuwt dat gateways van verschillende leveranciers zonder overkoepelend API management leiden tot “API sprawl, shadow APIs and other governance challenges”. OWASP noemt Improper Inventory Management als API9 in de API Security Top 10 van 2023: API’s waarvan je het bestaan niet kent, patch je niet en faseer je niet uit.
Alles migreren naar één gateway is de voor de hand liggende oplossing, en meestal de verkeerde. Het kost maanden, raakt productieroutes en gooit investeringen weg die gewoon werken. Federation brengt API’s onder één governance model en laat de runtime met rust.
Architectuur: hoe werkt API gateway federation?
API gateway federation koppelt het control plane los van de runtime gateways. WSO2 omschrijft een federated gateway als “an external API gateway that operates independently but is managed centrally through WSO2 API Manager”.
- Control plane: WSO2 API Manager, waar je API’s definieert, versioneert, beveiligt en monitort, en waar de developer portal staat.
- Runtime gateways: overal waar API’s daadwerkelijk worden aangeboden. Kong, AWS, Azure, Envoy of on premises, en vaak meerdere tegelijk.
Je voorkomt een gatewaymigratie, verkeer blijft dicht bij consumers en backends, en consumers krijgen één portal voor alle API’s. Dat levert het meeste op in hybrid cloud, multi cloud en geografisch verspreide omgevingen.
Voor Kong draait de connector in Read-Only modus. WSO2 bevraagt de Kong Admin API, zet services en routes om naar WSO2 API definities en deployt een revisie op de Kong gateway environment. Requests gaan nog precies zoals voorheen via Kong.
Stap voor stap: zo ontdek je Kong API’s in WSO2 API Manager
Je ontdekt Kong API’s in WSO2 API Manager in elf stappen: koppel beide platformen (stap 1 tot en met 4), laat WSO2 de API ontdekken en synchroniseren (stap 5 tot en met 10) en roep hem aan vanuit de Developer Portal (stap 11).
Stap 1: Genereer een personal access token in Kong Konnect
WSO2 authenticeert bij de Kong Admin API met een personal access token (PAT). Ga in Kong Konnect naar Account > Personal access tokens en genereer een token. Geef het een duidelijke naam (hier wso2) en een vervaldatum. Je hebt het nodig in stap 3.
Stap 2: Noteer de gegevens van je Kong control plane
Open het Kong control plane dat je wilt federeren (hier serverless-api-gateway-demo) en kopieer drie waarden:
- De Proxy URL
- De Admin API URL
- De Control Plane ID
Stap 3: Voeg Kong toe als gateway environment in WSO2 API Manager
Maak in de WSO2 Admin Portal een nieuwe gateway environment aan:
| Veld | Waarde |
|---|---|
| Gateway Environment Type | Kong Gateway |
| Gateway Mode | Read-Only (WSO2 ontdekt API’s, maar deployt ze niet naar Kong) |
| API Discovery Scheduling Interval | Polling interval in minuten, hier 30 |
| Deployment Type | Standalone |
| Admin URL | Host van de Admin API URL uit stap 2 |
| Control Plane ID | Control plane ID uit stap 2 |
| Access Token | PAT uit stap 1 |
| Vhosts | Host van de Proxy URL uit stap 2 |
Sla op. WSO2 scant Kong nu elke cyclus op API’s.
Stap 4: Controleer of de gateway environment actief is
Bekijk de serverlogs. De FederatedAPIDiscoveryRunner start een discoverycyclus voor de nieuwe environment.
Stap 5: Maak een API aan in Kong Gateway
Maak een gewone Kong service aan of gebruik een bestaande. Dit voorbeeld gebruikt Test-Service met één route, posts, die GET /posts aanbiedt. Niets hiervan is specifiek voor WSO2.
Stap 6: Zie hoe WSO2 de API ontdekt
Bij de volgende cyclus pikt WSO2 de service op, zonder handmatige import, OpenAPI upload of gekopieerde endpoints. Hij verschijnt in de Publisher Portal als Discovered API: Kong, met status CREATED en GET /posts gemapt.
Stap 7: Wijzig de API in Kong
Voeg PUT, POST en DELETE toe aan de route /posts, plus een nieuwe route todos met GET /todos.
Stap 8: Zie hoe WSO2 de wijziging oppikt
Bij de volgende run herkent WSO2 de bestaande federated API, werkt hem bij en deployt een nieuwe revisie. Er ontstaat geen duplicaat, en de logs tonen elke actie.
Stap 9: Controleer de bijgewerkte API in de Publisher Portal
De API toont nu GET, PUT, POST en DELETE op /posts, plus GET op /todos. Niemand heeft WSO2 met de hand aangepast.
Stap 10: Bekijk de revisiegeschiedenis
Elke gedetecteerde wijziging levert een nieuwe API revisie op. De weergave Deployments toont ze allemaal, met de laatste gedeployd op de Kong environment. Zo heb je een audittrail met versies van elke wijziging aan de kant van Kong.
Stap 11: Roep de Kong API aan vanuit de WSO2 Developer Portal
Publiceer de API en open hem in de Developer Portal. Roep GET /posts aan vanuit de Try Out console: het request gaat naar de backend achter Kong en geeft 200 OK terug. Van discovery tot aanroep, van begin tot eind.
Wat lost API gateway federation niet op?
Federation geeft je één beheerde inventaris. Je gateways worden er niet identiek door, dus houd rekening met drie beperkingen.
Discovery draait volgens een schema. Met een interval van 30 minuten kan het tot een half uur duren voordat een nieuwe Kong route in WSO2 verschijnt. Stem het interval af op hoe vaak je Kong teams opleveren.
Policies blijven waar ze zijn. Discovery leest services en routes. Ga er niet van uit dat een Kong plugin voor rate limiting of authenticatie een WSO2 policy wordt. Stem policies bewust af als vervolgstap.
Het PAT is een afhankelijkheid in de run. Verloopt het token, dan stopt discovery en loopt de portal achter. In ons WSO2 beheerwerk is dit precies het soort probleem dat maanden na livegang opduikt. Zet tokenrotatie vanaf dag één in je runbook.
Welke andere gateways kan WSO2 API Manager federeren?
WSO2 API Manager 4.7 federeert standaard vier gatewayplatformen:
| Gateway | Discovery | Deployen vanuit WSO2 |
|---|---|---|
| Kong Gateway (standalone of Kubernetes) | Ja | Nee |
| Envoy Gateway (Kubernetes) | Ja | Nee |
| AWS API Gateway | Ja | Ja, OAuth 2.0 via een Lambda authorizer |
| Azure API Management | Ja | Ja, authenticatie via Microsoft Entra ID |
Elke API komt nog steeds in hetzelfde control plane, dezelfde portal en hetzelfde governance model terecht. Voor een gateway die niet op de lijst staat, zoals een eigen gateway, bouw je een custom gateway agent op hetzelfde federation framework.
Je volgende stap
Draai je Kong, AWS, Azure, Envoy of een eigen gateway en wil je WSO2 API Manager als governancelaag erbovenop? Dan is discovery de praktische plek om te beginnen. Je bestaande API’s verschijnen binnen één discoverycyclus in WSO2.
Ons team voor enterprise integratie helpt architecten om omgevingen met meerdere gateways in kaart te brengen, te bepalen waar federation beter werkt dan een migratie, en WSO2 API Manager in te richten als één beheerd control plane. Connext managed services houden het daarna gepatcht, gemonitord en gesynchroniseerd.
