Hva er en API-gateway?

Når dere bare har én tjeneste, er det enkelt: Den tar imot kallene sine og svarer. Men i virkeligheten vokser det. Snart finnes det flere tjenester bak kulissene, og flere apper, partnere og systemer som vil snakke med dem. Da oppstår spørsmålet om hvor all denne trafikken skal komme inn, og hvordan dere holder orden på sikkerhet og oversikt. Svaret er ofte en API-gateway. Her er hva det er.

Et bilde: resepsjonisten

Tenk deg et stort kontor med mange avdelinger. Uten resepsjon måtte alle besøkende vite nøyaktig hvor de skulle og gå rett inn, og hver avdeling måtte selv kontrollere hvem som kom og gikk. Det blir rotete og usikkert.

Med en resepsjon i inngangen blir det orden. Resepsjonisten slipper inn dem som skal inn, viser hver enkelt til riktig avdeling og fører en besøkslogg over hvem som har passert. Ett enkelt punkt tar seg av det som ellers ville være spredt og uoversiktlig.

En API-gateway er nettopp en slik resepsjonist for systemene deres. Den sitter foran alle de bakenforliggende tjenestene som en felles inngang. Alle kall kommer inn der, og gatewayen slipper inn dem som har tilgang, styrer hvert kall til riktig tjeneste og fører logg over trafikken. De besøkende, altså appene og systemene, trenger bare å kjenne inngangen, ikke hvordan kontoret er organisert innenfor.

Hva gatewayen tar seg av

Bak bildet ligger noen konkrete oppgaver som gatewayen tar seg av på ett sted, i stedet for at hver tjeneste skal gjøre det selv:

• Autentisering. Gatewayen kontrollerer at den som gjør kallet, faktisk har rett til det. Dette gjøres før kallet i det hele tatt når tjenestene bak. Tilgangskontrollen skjer ved døren, én gang, for alt.
• Hastighetsbegrensning. Den setter et tak for hvor mange kall én enkelt avsender får gjøre i løpet av en viss tid. Slik beskyttes tjenestene deres mot at én klient, med vilje eller ved en feil, drukner dem i forespørsler. Den avsenderen bremses uten at andre rammes.
• Versjonshåndtering av API-er. Når API-ene deres utvikles, kan gatewayen hjelpe til med å styre trafikken riktig mellom ulike versjoner slik at endringer kan rulles ut uten at alt må endres på en gang.

I tillegg fører gatewayen logg over trafikken, noe som gir oversikt og gjør det lettere å feilsøke når noe går galt. Poenget er det samme hele veien: Det som ellers måtte bygges inn i hver tjeneste, samles på ett felles sted.

Hvorfor det er bedre enn å la hver tjeneste klare seg selv

Det er mulig å la hver tjeneste håndtere sin egen sikkerhet, sin egen trafikkbegrensning og sin egen logging. Problemet er at den samme logikken da må bygges og vedlikeholdes mange steder. Det blir dyrere, og verre: Det gjøres lett ulikt i ulike tjenester, eller glemmes i en av dem. En glemt tilgangskontroll i én eneste tjeneste er en åpen dør.

Med en gateway finnes den felles logikken på ett sted, konsekvent for alle. Tjenestene bak kan konsentrere seg om den egentlige jobben sin, mens den felles ordenen håndteres én gang, samlet og oversiktlig. Det gjør systemet både sikrere og billigere å forvalte.

Når den trengs

En API-gateway er ikke alltid riktig. Har dere én tjeneste og én klient som snakker med den, er en gateway ofte mer enn dere trenger. Den legger til et lag uten å løse noe reelt problem.

Nytten oppstår når det blir flere. Tommelfingerregelen er at en gateway lønner seg når dere har mer enn én konsument av API-ene deres (flere apper, partnere eller systemer som gjør kall mot dere) eller mer enn et par tjenester bak kulissene som skal henge sammen. Da er det den felles inngangen som holder orden på sikkerhet, trafikk og oversikt når kompleksiteten ellers kunne komme ut av kontroll.

Vi i Weapp bygger API-er og setter opp gatewayer der de gjør nytte, verken mer eller mindre. Vil dere ha orden på hvordan systemene deres nås? Se tjenestene våre eller ta kontakt.