Les proves de seguretat de l'API comencen amb una pregunta incòmoda: quants punts finals exposa la teva aplicació avui? No els de la teva especificació OpenAPI, sinó els que realment serveix el teu codi.
Per a la majoria d'equips, aquests dos números no coincideixen. L'especificació es va escriure fa mesos, el codi va anar canviant i, pel camí, van aparèixer rutes internes, punts finals d'exportació i versions antigues que ningú no ha documentat. Aquestes són API a l'ombra i no es pot provar allò que ningú sap que existeix.
TL; DR
Proves de seguretat de l'API en dues capes: inventari des del codi, prova en temps d'execució
No pots protegir les API que no saps que tens. Les proves de seguretat de les API comencen amb un inventari fiable, i la font més fiable és el codi en si, no l'especificació.
- Deriva de l'inventari: La comparació del codi i l'especificació revela punts finals que existeixen però no estan documentats (API ombra) i operacions documentades que ja no serveixen res (API orfes), ambdues sota API d'OWASP 9:2023.
- Defectes del controlador: Molts defectes de l'API no són errors d'injecció. Són una comprovació de propietat que falta (BOLA), una ruta d'administració sense comprovació de rol o una resposta que retorna més camps dels que hauria de fer. Els podeu veure millor llegint el controlador.
- Prova d'execució: Les proves en temps d'execució confirmen el que suggereix el codi: quins punts finals responen sense autenticació, on la vostra passarel·la ja compensa i què és explotable a l'aplicació implementada.
- Una troballa per problema: juntes, les dues capes us proporcionen una única troballa per problema, classificada segons les dades que exposa (personals, de pagament, de salut, de credencials).
El primer pas: crea el teu inventari d'API a partir de codi, compara'l amb les teves especificacions d'OpenAPI i, a continuació, dirigeix les proves d'execució al catàleg complet, no només a la part documentada.
Per què les proves de seguretat típiques de l'API són insuficients
La majoria dels equips protegeixen les seves API amb tres elements: una passarel·la que aplica l'autenticació a la vora, un escàner que segueix les especificacions i una prova de penetració manual una o dues vegades l'any. Tots tres ajuden, però comparteixen un punt feble.
Tots depenen d'algú que sàpiga quins punts finals existeixen. L'escàner només comprova el que hi ha a l'especificació. La prova de penetració cobreix l'abast que se li va donar. I la passarel·la aplica l'autenticació a la vora, però no pot veure que el controlador mai comprova si l'ordre 4512 pertany a l'usuari que la sol·licita.
És per això que Els 10 millors de seguretat de l'API d'OWASP dedica una categoria completa a la gestió inadequada de l'inventari (API9:2023), i per què el seu risc número u és l'autorització a nivell d'objecte trencat (API1): un defecte lògic sense signatura ni patró d'injecció.
Capa 1: un inventari d'API creat a partir de codi
Les proves de seguretat d'API fiables comencen amb un inventari creat a partir de l'única font que no es desvia: el codi. Seguretat de l'API de Xygeni inspecciona els manifestos de les vostres dependències, detecta els frameworks web que feu servir i extreu tots els punts finals, incloses les rutes declarades a través de diversos fitxers.
Llegeix frameworks web populars en els principals llenguatges de servidor, com ara Spring Boot, ASP.NET Core, Django, FastAPI, Express i Laravel, a més de... OpenAPI 3.x i les especificacions de Swagger 2.x. El resultat és un catàleg de serveis, mòduls i punts finals, amb els seus mètodes, paràmetres, cossos de sol·licitud i formes de resposta.
Amb el codi i l'especificació costat a costat, la deriva esdevé evident:
- API d'ombra: punts finals que serveix el codi, però que l'especificació no documenta.
- API orfes: operacions d'especificació que ja no serveix cap controlador.
Si no esteu preparats per activar la detecció, el mode de descobriment crea el catàleg i les seves llacunes pel seu compte. És una bona manera d'iniciar la conversa amb els equips de desenvolupament sense afegir soroll el primer dia.
Quins defectes detectes llegint el controlador
Molts defectes de l'API no són errors d'injecció: són una comprovació que falta. Com que Xygeni llegeix rutes, controladors i especificacions junts, pot expressar defectes que els escàners basats en patrons no poden. Cada troballa es correspon amb la seva categoria OWASP API Security Top 10 (2023) i amb CWE.
Defectes de l'API que detectes llegint el codi
Cada defecte correspon a la seva categoria en el Els 10 millors de seguretat de l'API d'OWASP, de manera que les troballes parlen el mateix idioma que els vostres auditors i pentesters.
| Defecte | Què busca al codi | Categoria OWASP |
|---|---|---|
| Autorització a nivell d'objecte trencatBOLA / IDOR | Punts finals que carreguen un objecte mitjançant un ID de la sol·licitud sense comprovar que pertanyi a l'usuari | API1 |
| Exposició excessiva de dades | Respostes que retornen més camps dels necessaris | API3 |
| Autorització de nivell de funció trencada | Rutes d'administrador sense comprovació de rols | API5 |
| Punts finals no autenticats i assignació massiva | Obrir rutes i sol·licitar cossos que acceptin camps que no haurien d'acceptar. | API2 i API3 |
| API ombres i orfes | Diferències entre codi i especificació | API9 |
Per a BOLA, l'anàlisi per idioma busca comprovacions de propietat, abast de repositori i vinculació d'identitat. També resol les regles d'autorització declarades centralment a la configuració del vostre marc de treball i podeu afegir els noms de les vostres pròpies funcions de comprovació de propietat per reduir encara més el soroll. Les API de GraphQL tenen les seves pròpies comprovacions específiques.
El detall que canvia la priorització: cada camp està etiquetat com a dades personals, de pagament, de salut, de credencials o criptogràfiques. Un punt final no autenticat que retorna dades personals es classifica com a crític, en lloc de perdre's a la cua darrere d'un centenar de troballes menors.
Capa 2: proves en temps d'execució
El codi t'indica què podria passar. Les proves en temps d'execució t'indiquen què passa. Les proves de seguretat de l'API completes necessiten ambdues vistes, i Xygeni les connecta a través del mateix inventari de punts finals a tres nivells:
- Comprovació de seguretat de l'API en directe. Envia una sol·licitud no destructiva per punt final candidat per confirmar o refutar les troballes d'autenticació. Si l'entorn respon a 401 o 403, la troballa es marca com a refutada: prova que la vostra passarel·la ja hi compensa.
- Xygeni DAST. Prova l'execució d'aplicacions web i API des d'una imatge de Docker signada que s'executa als vostres propis executors de CI o a la xarxa interna. En producció, utilitza intensitat passiva, que no envia càrregues útils d'atac. Per a proves actives, es recomana un entorn de proves amb un compte de prova.
- Proves de penetració per IA. Un agent d'IA planifica i executa atacs no perjudicials contra objectius autoritzats per demostrar quines troballes són explotables, assignades al Top 10 de seguretat de l'API d'OWASP.
Un problema, una troballa
El valor de combinar l'inventari amb les proves en temps d'execució no rau en més alertes. Sinó en menys, però millors. AI SAST les troballes al controlador, les troballes de DAST al punt final en execució i els defectes de l'API es correlacionen a ASPM Gràfic de risc, amb etiquetes de sensibilitat adjuntes.
Inventari d'API a partir de proves de codi vs. proves en temps d'execució
Cap de les dues capes substitueix l'altra. Les proves de seguretat de l'API completes utilitzen totes dues, connectades a través del mateix inventari de punts finals:
| dimensió | Inventari d'API des del codi | Proves en temps d'execució |
|---|---|---|
| Quan s'executa | Abans del desplegament, a cada pull request | Contra l'aplicació desplegada (en fase de proves o passiva en producció) |
| El que millor veu | API a l'ombra, BOLA, comprovacions de rols que falten, exposició de dades | Què respon realment, configuració de l'entorn, explotabilitat |
| Què li dóna a l'altra capa | El catàleg complet de punts finals per provar | Confirmació o refutació del que suggereix el codi |
Un defecte en el controlador i el punt final exposat que hi arriba són un problema, amb un sol propietari. I si ja executeu una altra eina DAST, Xygeni importa els seus resultats a la mateixa vista de risc, sense demanar-vos que el substituïu.
Voleu veure les dues capes treballant juntes? Mira la nostra sessió Del codi a l'execució: per què SAST + DAST són essencials per a l'AppSec moderna, on veurem com es confirmen mútuament les troballes de codi i les proves en temps d'execució.
Com integrar les proves de seguretat de l'API al cicle de vida del desenvolupament
El patró que funciona millor per a equips de mida mitjana és simple:
- A tots pull request: Seguretat de l'API a CI al codi modificat, a més d'escanejos DAST incrementals.
- Abans commit: com una pre-commit porta en fitxers en stage.
- Cada nit o en la fusió: una exploració DAST completa.
- Abans de cada llançament important: Proves d'IA contra estadificació per validar l'endarreriment i confirmar que cada correcció ha tancat el forat.
L'escàner de seguretat de l'API s'executa a qualsevol lloc, inclosos els entorns amb espais reduïts, i informa a Xygeni SaaS o al vostre on-premise plataforma. Els resultats surten com a JSON, SARIF 2.1.0, CSV i Markdown per a pull request comentaris.
Proves de seguretat i compliment de l'API
Per als equips de la banca, les assegurances o el sector públic, les proves de seguretat de l'API també són una prova. Cada troballa porta etiquetes de compliment per a Article 32 del RGPD, PCI DSS 4.0 (requisits 3.4, 6.4.3, 7.1, 7.2 i 8) i NIST SP 800-53 (AC-3, AC-6, IA-2, IA-5), visible a la plataforma i a la sortida JSON i SARIF.
Si la vostra organització pertany a DORA or NIS2, les proves en temps d'execució us proporcionen evidència contínua entre les proves de penetració manuals que els vostres reguladors encara requereixen.
Prova l'API que executes realment, no la que has documentat
Les proves de seguretat de l'API que només llegeixen les especificacions proven l'API que creieu que teniu, no la que realment executeu. Comenceu amb un inventari creat a partir de codi, confirmeu-lo amb proves en temps d'execució i classifiqueu cada defecte segons les dades que exposa el punt final.
Voleu veure tots els punts finals que exposa el vostre codi? Reserveu una sessió amb un enginyer per crear l'inventari de l'API d'un dels vostres repositoris i revisar-ne les conclusions. O comenceu gratuïtament amb l'escaneig de codi i dependències avui mateix!
Preguntes freqüents
Necessito proves de seguretat de l'API si ja tinc una passarel·la d'API?
Sí. Una passarel·la aplica l'autenticació a la vora, però no pot veure una comprovació de propietat que falta dins d'un controlador o una resposta que retorna massa camps. La comprovació en directe de Xygeni fins i tot mostra on la vostra passarel·la ja compensa, marcant aquestes troballes com a refutades.
Com puc trobar API ombrejades o sense documentar?
Compareu el que serveix el vostre codi amb el que documenta la vostra especificació. Xygeni API Security ho fa automàticament: descobreix punts finals del codi font, marca els que falten a la vostra especificació OpenAPI o Swagger com a API ombra i marca les operacions d'especificació sense controlador com a orfes.
És segur executar proves d'execució contra la producció?
Amb la intensitat passiva de Xygeni DAST, sí: no envia càrregues útils d'atac, permet limitar la taxa de sol·licituds i identifica el seu trànsit amb la capçalera X-Xygeni-DAST. Per a proves actives i AI Pentesting, es recomana un entorn de proves amb un compte de prova.







