API-tietoturvatestaus alkaa epämukavalla kysymyksellä: kuinka monta päätepistettä sovelluksesi tarjoaa tänään? Ei niitä, jotka on määritelty OpenAPI-spesifikaatiossasi, vaan niitä, joita koodisi todellisuudessa palvelee.
Useimmilla tiimeillä nuo kaksi numeroa eivät täsmää. Spesifikaatio kirjoitettiin kuukausia sitten, koodi eteni jatkuvasti, ja matkan varrella tulivat sisäiset reitit, vientipäätepisteet ja vanhoja versioita, joita kukaan ei dokumentoinut. Nämä ovat varjo-API-rajapintoja, etkä voi testata sellaista, minkä olemassaolosta kukaan ei tiedä.
TL; DR
API-tietoturvatestaus kahdessa kerroksessa: inventointi koodista, testaus ajonaikana
Et voi suojata API-rajapintoja, joita et tiedä omaavasi. API-tietoturvatestaus alkaa luotettavasta inventaariosta, ja luotettavin lähde on itse koodi, ei spesifikaatio.
- Varastotilanteen muutos: koodin ja spesifikaation vertaaminen paljastaa päätepisteitä, jotka ovat olemassa, mutta joita ei ole dokumentoitu (varjo-API:t), ja dokumentoituja toimintoja, joita mikään ei enää palvele (orpo-API:t), molemmat OWASP-sovellusliittymä 9:2023.
- Käsittelijän viat: Monet API-virheet eivät ole injektiovirheitä. Ne ovat puuttuva omistajuustarkistus (BOLA), järjestelmänvalvojan reitti ilman roolitarkistusta tai vastaus, joka palauttaa enemmän kenttiä kuin pitäisi. Näet ne parhaiten lukemalla käsittelijän.
- Todiste ajonaikana: Suorituksenaikainen testaus vahvistaa koodin ehdottamat tiedot: mitkä päätepisteet vastaavat ilman todennusta, missä yhdyskäytäväsi jo kompensoi ja mitä hyökkäyksiä voidaan hyödyntää käyttöönotetussa sovelluksessa.
- Yksi löydös ongelmaa kohden: Yhdessä nämä kaksi tasoa antavat sinulle yhden löydöksen ongelmaa kohden, järjestettynä paljastamiensa tietojen (henkilökohtaiset, maksu-, terveys-, tunnistetiedot) mukaan.
Ensimmäinen askel: Rakenna API-luettelosi koodista, vertaa sitä OpenAPI-spesifikaatioosi ja kohdista sitten ajonaikaiset testit koko luetteloon, ei vain dokumentoituun osaan.
Miksi tyypillinen API-tietoturvatestaus epäonnistuu
Useimmat tiimit suojaavat API-rajapintojaan kolmella osalla: yhdyskäytävällä, joka valvoo todennusta reunalla, skannerilla, joka tarkistaa spesifikaatiot, ja manuaalisella penetraatiotestillä kerran tai kaksi vuodessa. Kaikki kolme auttavat, mutta niillä on yhteinen sokea piste.
Ne kaikki riippuvat siitä, että joku tietää, mitkä päätepisteet ovat olemassa. Skanneri testaa vain sen, mitä spesifikaatiossa on. Läpäisytesti kattaa sille annetun soveltamisalan. Ja yhdyskäytävä valvoo todennusta reunalla, mutta se ei näe, että käsittelijä ei koskaan tarkista, kuuluuko tilaus 4512 sitä pyytävälle käyttäjälle.
Siksi OWASP API Security Top 10 omistaa kokonaisen kategorian epäasianmukaiselle varastonhallinnalle (API9:2023), ja miksi sen suurin riski on Broken Object Level Authorization (API1): logiikkavirhe, jossa ei ole allekirjoitusta eikä injektiokuviota.
Kerros 1: koodista rakennettu API-varasto
Luotettava API-tietoturvatestaus alkaa inventaariolla, joka rakennetaan yhdestä lähteestä, joka ei ajaudu pois tieltä: koodista. Xygeni API:n tietoturva tarkastaa riippuvuusluettelosi, tunnistaa käyttämäsi verkkokehykset ja poimii kaikki päätepisteet, mukaan lukien useiden tiedostojen kautta ilmoitetut reitit.
Se lukee suosittuja verkkokehyksiä tärkeimmillä palvelinpuolen kielillä, kuten Spring Boot, ASP.NET Core, Django, FastAPI, Express ja Laravel, sekä OpenAPI 3.x ja Swagger 2.x -spesifikaatiot. Tuloksena on luettelo palveluista, moduuleista ja päätepisteistä, mukaan lukien niiden metodit, parametrit, pyyntöjen rungot ja vastausmuodot.
Kun koodi ja spec ovat rinnakkain, ajautuminen on ilmeistä:
- Varjo-API:t: päätepisteet, joita koodi palvelee, mutta spesifikaatio ei dokumentoi sitä.
- Orpo-API:t: spec-operaatiot, joita mikään käsittelijä enää ei palvele.
Jos et ole valmis ottamaan tunnistusta käyttöön, etsintätila rakentaa luettelon ja sen aukot itse. Se on hyvä tapa aloittaa keskustelu kehitystiimien kanssa ilman, että se lisää meteliä ensimmäisenä päivänä.
Mitä puutteita huomaat lukemalla käsittelijän
Monet API-virheet eivät ole injektiovirheitä: ne ovat puuttuvia tarkistuksia. Koska Xygeni lukee reittejä, käsittelijöitä ja spec-tietoja yhdessä, se voi ilmaista virheitä, joita kuviopohjaiset skannerit eivät pysty. Jokainen löydös liittyy sen OWASP API Security Top 10 (2023) -kategoriaan ja CWE:hen.
API-virheet, jotka löydät lukemalla koodia
Jokainen vika vastaa omaa kategoriaansa OWASP API Security Top 10, joten löydökset puhuvat samaa kieltä kuin auditoijasi ja penetraatiotestaajasi.
| Virhe | Mitä se etsii koodista | OWASP-luokka |
|---|---|---|
| Rikkoutunut objektitason valtuutusBOLA / IDOR | Päätepisteet, jotka lataavat objektin pyynnön ID:n perusteella tarkistamatta sen kuuluvuutta käyttäjälle | API1 |
| Liiallinen datan altistuminen | Vastaukset, jotka palauttavat enemmän kenttiä kuin tarvitaan | API3 |
| Rikkoutuneen toimintotason valtuutus | Ylläpitäjän reitit ilman roolitarkistusta | API5 |
| Todentamattomat päätepisteet ja massamääritys | Avaa reittejä ja pyydä yksiköitä, jotka hyväksyvät kenttiä, joita niiden ei pitäisi hyväksyä | API2 ja API3 |
| Varjo- ja orpo-API:t | Koodin ja spesifikaation väliset erot | API9 |
BOLA-kielen osalta kielikohtainen analyysi etsii omistajuustarkistuksia, tietovaraston laajuuden määritystä ja identiteettisidontaa. Se ratkaisee myös keskitetysti kehyskokoonpanossasi ilmoitetut valtuutussäännöt, ja voit lisätä omien omistajuustarkistusfunktioidesi nimet kohinan vähentämiseksi entisestään. GraphQL-API-rajapinnoilla on omat erityistarkistuksensa.
Priorisointia muuttava yksityiskohta: jokainen kenttä merkitään henkilö-, maksu-, terveys-, tunniste- tai kryptografiseksi tiedoksi. Henkilötietoja palauttava todentamaton päätepiste luokitellaan kriittiseksi sen sijaan, että se katoaisi jonossa sadan pienen löydöksen takana.
Kerros 2: ajonaikainen testaus
Koodi kertoo, mitä voi tapahtua. Ajonaikainen testaus kertoo, mitä tapahtuu. Täydellinen API-tietoturvatestaus tarvitsee molemmat näkymät, ja Xygeni yhdistää ne saman päätepisteluettelon kautta kolmella tasolla:
- API-tietoturvan reaaliaikainen tarkistus. Se lähettää yhden ei-tuhoavan pyynnön kullekin ehdokaspäätepisteelle todennustulosten vahvistamiseksi tai kumoamiseksi. Jos ympäristö vastaa 401- tai 403-virheeseen, löydös merkitään kumotuksi: todiste siitä, että yhdyskäytäväsi jo kompensoi kyseiset löydökset.
- Xygeni DAST. Se testaa verkkosovellusten ja APIen suorittamista allekirjoitetusta Docker-kuvasta, joka toimii omassa CI-runnerissasi tai sisäisessä verkossasi. Tuotantoympäristössä se käyttää passiivista intensiteettiä, joka ei lähetä hyökkäyskuormia. Aktiivista testausta varten suositellaan testiympäristöä ja testitiliä.
- Tekoälyn läpäisytestaus. Tekoälyagentti suunnittelee ja suorittaa vahingoittamattomia hyökkäyksiä valtuutettuja kohteita vastaan todistaakseen, mitkä löydökset ovat hyödynnettävissä, ja ne on kartoitettu OWASP API Security Top 10 -listalle.
Yksi ongelma, yksi löytö
Inventaarion yhdistäminen ajonaikaiseen testaukseen ei tuota enemmän hälytyksiä, vaan vähemmän ja parempia hälytyksiä. AI SAST käsittelijän löydökset, käynnissä olevan päätepisteen DAST-löydökset ja API-virheet korreloivat ASPM Riskikaavio, johon on liitetty herkkyystunnisteet.
API-varasto koodista vs. ajonaikaisesta testauksesta
Kumpikaan kerros ei korvaa toista. Täydellinen API-tietoturvatestaus käyttää molempia, jotka on yhdistetty saman päätepisteluettelon kautta:
| Ulottuvuus | API-varasto koodista | Suoritusaikainen testaus |
|---|---|---|
| Kun se toimii | Ennen käyttöönottoa, joka pull request | Käyttöönotettua sovellusta vasten (vaiheittaisessa käytössä tai passiivisessa tuotannossa) |
| Mitä se parhaiten näkee | Varjo-APIt, BOLA, puuttuvien roolien tarkistukset, datan paljastuminen | Mikä oikeastaan vastaa, ympäristön kokoonpano, hyödynnettävyys |
| Mitä se antaa toiselle kerrokselle | Testattavien päätepisteiden täydellinen luettelo | Koodiehdotuksen vahvistus tai kumoaminen |
Käsittelijän virhe ja siihen johtava paljastunut päätepiste ovat yksi ongelma, jolla on yksi omistaja. Ja jos sinulla on jo käytössä toinen DAST-työkalu, Xygeni tuo sen tulokset samaan riskinäkymään pyytämättä sinua korvaamaan sitä.
Haluatko nähdä molempien kerrosten toimivan yhdessä? Katso istuntomme Koodista suoritusympäristöön: Miksi SAST + DAST ovat molemmat välttämättömiä nykyaikaiselle sovellusturvallisuudelle, jossa käymme läpi, miten koodilöydökset ja ajonaikaiset testit vahvistavat toisensa.
Kuinka sovittaa API-tietoturvatestaus kehityssykliin
Keskikokoisille tiimeille parhaiten toimiva kaava on yksinkertainen:
- Jokaisella pull request: API-tietoturva CI:ssä muutetussa koodissa sekä inkrementaaliset DAST-skannaukset.
- Ennen commit: kuten pre-commit portti lavastetuille tiedostoille.
- Yöllä tai yhdistämisen yhteydessä: täydellinen DAST-skannaus.
- Ennen jokaista merkittävää julkaisua: Tekoälyn läpitestaus vaiheittaista kehitystä vasten ruuhkan validoimiseksi ja sen varmistamiseksi, että jokainen korjaus sulki aukon.
API-tietoturvaskanneri toimii missä tahansa, myös ilmarakoisissa ympäristöissä, ja raportoi Xygeni SaaS:lle tai omalle on-premise alusta. Tulokset julkaistaan JSON-muodossa, SARIF 2.1.0, CSV ja Markdown sovellukselle pull request kommentit.
API-tietoturvatestaus ja vaatimustenmukaisuus
Pankki-, vakuutus- tai julkisen sektorin tiimeille API-tietoturvatestaus on myös todistusaineistoa. Jokaisessa löydöksessä on vaatimustenmukaisuustunnisteet. GDPR artikla 32, PCI DSS 4.0 (vaatimukset 3.4, 6.4.3, 7.1, 7.2 ja 8) ja NIST SP 800-53 (AC-3, AC-6, IA-2, IA-5), näkyvät alustalla sekä JSON- ja SARIF-tulosteissa.
Jos organisaatiosi kuuluu DORA or NIS2Ajonaikainen testaus antaa sinulle jatkuvaa näyttöä manuaalisten läpäisytestien välillä, joita säätimesi edelleen vaativat.
Testaa itse käyttämääsi API:a, älä sitä, jonka dokumentoit
API-tietoturvatestaus, joka lukee vain spesifikaatiot, testaa API:a, jonka luulet omaavasi, ei sitä, jota itse asiassa käytät. Aloita koodista rakennetulla inventaariolla, vahvista se ajonaikaisella testauksella ja luokittele jokainen puute päätepisteen paljastaman datan perusteella.
Haluatko nähdä kaikki koodisi paljastamat päätepisteet? Varaa tapaaminen insinöörin kanssa, jotta voit rakentaa jonkin repositoriosi API-luettelon ja tarkastella sen tuloksia. Tai aloita ilmainen koodin ja riippuvuuksien skannaus jo tänään!
UKK
Tarvitsenko API-tietoturvatestausta, jos minulla on jo API-yhdyskäytävä?
Kyllä. Yhdyskäytävä valvoo todennusta reunalla, mutta se ei näe puuttuvaa omistajuustarkistusta käsittelijän sisällä tai vastausta, joka palauttaa liian monta kenttää. Xygenin reaaliaikainen tarkistus näyttää jopa, missä kohtaa yhdyskäytäväsi jo kompensoi, merkitsemällä kyseiset löydökset kumotuiksi.
Miten löydän varjo- tai dokumentoimattomia API-rajapintoja?
Vertaa koodisi tarjoamia ominaisuuksia spesifikaatioidesi dokumentoimiin. Xygeni API Security tekee tämän automaattisesti: se löytää lähdekoodista päätepisteet, merkitsee OpenAPI- tai Swagger-spesifikaatiostasi puuttuvat päätepisteet varjo-API-rajapinnoiksi ja merkitsee käsittelijää vailla olevat spesifikaatiotoiminnot orvoiksi.
Onko turvallista suorittaa ajonaikaisia testejä tuotantoympäristössä?
Xygeni DAST:n passiivisen intensiteetin ansiosta kyllä: se ei lähetä hyökkäyskuormia, antaa sinun rajoittaa pyyntöjen määrää ja tunnistaa liikenteen X-Xygeni-DAST-otsikon avulla. Aktiivista testausta ja tekoälyn läpäisytestausta varten suositellaan testiympäristöä testitilillä.







