API-tietoturvan hallinnointi: ISO 27001 -auditointinäyttö vuodelle 2026

API-auditointihavainto, joka saapuu ennen tietoturvaloukkausta
Maria, nopeasti kasvavan fintech-SaaS-yhtiön CISO, avaa pääauditoijan sähköpostin kolme viikkoa ennen vuosittaista arviointia. Viesti on suora:
“Teemme perusteellisen katselmoinnin ICT-toimittajariskien hallinnan viitekehyksestänne ja sen yhdenmukaisuudesta DORA-, NIS2- ja GDPR-vaatimusten kanssa. Erityisenä painopisteenä on API-ekosysteeminne. Toimittakaa tuotanto- ja kumppani-API:en luettelo, todennusmalli, nopeusrajoituksia koskeva näyttö ja lokituksen kattavuus.”
Kaksi päivää myöhemmin sisäinen tarkastus lähettää toisen viestin:
“Löysimme 47 julkista API-päätepistettä, joita ei ole omaisuusluettelossa. Neljä hyväksyy API-avaimia ilman näyttöä avainten kierrosta. Yhdessä kumppani-integraatiossa ei ole nopeusrajoitusta. Lokitus on epäyhtenäistä tuotantopalveluissa. Toimittakaa ISO 27001-, GDPR- ja NIS2-näyttö perjantaihin mennessä.”
Kiristyshaittaohjelmaviestiä ei ole. Julkista tietoturvaloukkausta ei ole. Asiakasvalitusta ei ole. Havainto on silti vakava, koska se paljastaa hallinnointiaukon, jota hyökkääjät jo hyödyntävät. API:t ovat nyt todellinen perimeteri. Ne yhdistävät maksut, käyttöönoton, identiteetin, asiakasportaalit, toimittajapalvelut, mobiilisovellukset, pilvityökuormat, analytiikka-alustat ja ulkoistetut riskimoottorit.
Läheltä piti -tilanne tekee asiasta vaikeamman sivuuttaa. Paineen alla työskennellyt nuorempi kehittäjä altisti staging-API:n internetiin ilman todennusta. Se sisälsi realistista, pseudonymisoitua asiakasdataa. Red Team löysi sen ensin, mutta johto esitti ilmeisen kysymyksen: mitä muuta siellä on?
Vuonna 2026 API-tietoturvan hallinnointi ei ole vain kehittäjien tarkistuslista. CISOjen, vaatimustenmukaisuudesta vastaavien johtajien, sisäisten auditoijien ja hallitusten on osoitettava, että API:t tunnetaan, niillä on omistajat, ne todennetaan, niitä valvotaan, niihin sovelletaan nopeusrajoituksia, niitä testataan, niiden riskit arvioidaan ja ne sisältyvät poikkeamien ilmoittamiseen. Sama näyttö on usein pystyttävä esittämään ISO/IEC 27001:2022-, NIS2-, DORA-, GDPR-, NIST CSF 2.0- ja COBIT-linjaisten varmennusodotusten täyttämiseksi.
Useimmilla organisaatioilla on jo tekniset työkalut: API-yhdyskäytävät, identiteetintarjoajat, SIEM-alustat, WAF-ratkaisut, pilvilokit, palveluverkot, CI/CD-putket ja tikettijärjestelmät. Usein puuttuu kontrollitarina. Mitkä API:t kuuluvat soveltamisalaan? Kuka hyväksyy uudet API:t? Mitkä lokit osoittavat todennuksen epäonnistumiset? Mikä rekisteri näyttää kolmansien osapuolten API-riippuvuudet? Miksi nopeusrajoitukset eroavat asiakas-, ylläpitäjä- ja koneiden välisissä API:eissa?
Clarysecin lähestymistapa on käsitellä API-tietoturvan hallinnointia vaatimustenmukaisuuksia yhdistävänä näyttöjärjestelmänä, ei kertaluonteisena teknisenä tehtävänä. Jos API voi altistaa dataa, muuttaa liiketoimintaprosessia, todentaa käyttäjän, käynnistää maksun, kutsua toimittajaa tai tukea säänneltyä palvelua, se kuuluu ISMS:n näyttömalliin.
Miksi API-hallinnointi on nyt hallitustason asia
NIS2 tekee kyberturvallisuuden hallinnoinnista ylimmän hallintoelimen vastuun. Article 20 edellyttää, että hallintoelimet hyväksyvät kyberturvallisuuden riskienhallintatoimenpiteet, valvovat niiden toteutusta ja saavat koulutusta, jotta ne ymmärtävät kyberriskit ja niiden vaikutukset palveluihin. Article 21 edellyttää asianmukaisia ja oikeasuhtaisia teknisiä, operatiivisia ja organisatorisia toimenpiteitä, mukaan lukien riskianalyysi, tietoturvapolitiikat, poikkeamien käsittely, liiketoiminnan jatkuvuus, toimitusketjun turvallisuus, turvallinen hankinta ja kehittäminen, haavoittuvuuksien käsittely, vaikuttavuuden arviointi, kyberhygienia, kryptografia, pääsynhallinta, omaisuudenhallinta sekä tarvittaessa monivaiheinen tai jatkuva todennus.
API-hallinnoinnissa tämä tarkoittaa, että julkiset API:t, kumppani-API:t, ylläpitäjä-API:t ja sisäiset mikropalvelu-API:t voivat olla osa säännellyn palvelun tuottamista. NIS2 voi soveltua pilvipalvelujen tarjoajiin, datakeskuspalvelujen tarjoajiin, sisällönjakeluverkkoihin, luottamuspalvelujen tarjoajiin, julkisiin sähköisiin viestintäverkkoihin ja -palveluihin sekä ICT-palvelunhallinnan tarjoajiin, kuten MSP- ja MSSP-toimijoihin, toimialasta, koosta, kriittisyydestä ja jäsenvaltion luokittelusta riippuen.
DORA tuo mukaan finanssisektorin näkökulman. Sitä sovelletaan 17. tammikuuta 2025 alkaen, ja se asettaa yhdenmukaiset vaatimukset ICT-riskien hallinnalle, ICT:hen liittyvien poikkeamien raportoinnille, digitaalisen operatiivisen häiriönsietokyvyn testaukselle, tietojen jakamiselle ja ICT-toimittajariskien hallinnalle. Article 5 edellyttää, että hallintoelin määrittelee, hyväksyy ja valvoo ICT-riskien hallinnan viitekehystä ja vastaa siitä edelleen. Article 8 edellyttää ICT-tuettujen liiketoimintatoimintojen, tietovarojen, ICT-omaisuuserien, riippuvuuksien, kolmansien osapuolten tukemien prosessien, kriittisten omaisuuserien, luetteloiden ja legacy-ICT-riskin tunnistamista, luokittelua ja dokumentointia.
API-näkökulmasta maksun käynnistys-API, petospisteytys-API, asiakkaan onboarding-API tai ulkoistettu KYC-API ei ole vain päätepiste. Se on ICT-omaisuuserä ja riippuvuus, joka tukee liiketoimintatoimintoa.
GDPR täydentää kokonaisuuden. API:t, jotka siirtävät tunnisteita, tilitietoja, laitetunnisteita, käyttäytymistelemetriaa, biometrisiä tietoja, terveystietoja tai taloudellisia profiileja, voivat käsitellä henkilötietoja. GDPR:n osoitusvelvollisuusperiaate edellyttää, että rekisterinpitäjät osoittavat vaatimustenmukaisuuden lainmukaisuuden, käyttötarkoitussidonnaisuuden, tietojen minimoinnin, säilytyksen rajoittamisen, eheyden ja luottamuksellisuuden osalta. Article 32 edellyttää käsittelyn turvallisuutta, ja Articles 33 ja 34 perustuvat luotettavaan näyttöön henkilötietojen tietoturvaloukkauksen tapahtuessa.
Hallitus ei tarvitse pakettikaappauksia, mutta sen on voitava luottaa siihen, että organisaatio tietää, mitkä API:t ovat merkityksellisiä, mitä dataa ne käsittelevät, mistä toimittajista ne riippuvat, miten väärinkäyttö estetään, miten poikkeamat havaitaan ja miten vaatimustenmukaisuus voidaan osoittaa.
Aloita API-luettelosta
Useimmat API-epäonnistumiset alkavat omaisuusluettelon puutteista. Käytöstä poistettu mobiilitaustapalvelu toimii edelleen tuotannossa. Väliaikainen kumppani-integraatio muuttuu pysyväksi. Pilvifunktio altistaa uuden päätepisteen. Sisäinen API muuttuu internetistä saavutettavaksi kuormantasaajamuutoksen jälkeen. Mikään näistä ei näy CMDB:ssä, joten mikään niistä ei saa todennuskatselmointia, lokitusstandardeja, nopeusrajoituskynnyksiä, toimittaja-arviointia tai säilytysluokitusta.
Ensimmäinen auditointikysymys on yleensä yksinkertainen: “Voinko nähdä API-luettelonne?”
Clarysec käsittelee API-luetteloa osana ISMS:n omaisuusluetteloa. Zenith Blueprint: auditoijan 30 vaiheen tiekartta Zenith Blueprint -materiaalin Controls in Action -vaiheen vaiheessa 22 ISO/IEC 27002:2022 -hallintakeinoa 5.9 koskeva ohje toteaa:
“Mikään organisaatio ei voi suojata sellaista, jonka olemassaolosta se ei tiedä. Control 5.9 virallistaa tämän perustavan periaatteen ja edellyttää ajantasaisen luettelon laatimista ja ylläpitoa kaikista ISMS:n kannalta olennaisista tiedoista ja niihin liittyvistä omaisuuseristä.”
Sama vaihe sisältää loogiset omaisuuserät, kuten “käyttäjätilit, tunnistetiedot, avaimet, ohjelmistolisenssit, API:t”, sekä palveluihin liittyvät omaisuuserät, kuten SaaS-alustat ja ulkoistetun tallennuksen. Zenith Blueprint kutsuu luetteloa “ISMS:n keskushermostoksi”, koska se ohjaa käyttöoikeuksien myöntämistä, salausta, varmuuskopiointia, lokitusta, luokittelua ja säilytystä.
Clarysecin yritystason Omaisuudenhallintapolitiikka Omaisuudenhallintapolitiikka muuntaa tämän hallinnointivaatimukseksi:
“IT-omaisuuspäällikön tulee ylläpitää kattavaa ja keskitettyä omaisuusluetteloa, joka kattaa kaikki organisaation käyttämät tai siihen liitetyt tietovarat.”
Kohdasta “Politiikan toteutusvaatimukset”, politiikkalauseke 6.1.1.
Pk-yrityksille Clarysecin Omaisuudenhallintapolitiikka – pk-yritys Omaisuudenhallintapolitiikka – pk-yritys sisältää nimenomaisesti API-relevantit digitaaliset omaisuuserät:
“Digitaaliset tunnistetiedot ja palvelut: verkkotunnukset, digitaaliset varmenteet, API-avaimet, sähköpostitilit, pilvikirjautumiset”
Kohdasta “Soveltamisala”, politiikkalauseke 2.2.4.
Tällä ilmauksella on merkitystä. Monissa auditoinneissa API-päätepiste näkyy yhdyskäytävässä, token näkyy salaisuusholvissa, varmenne näkyy pilvitilillä ja tietovirta näkyy tietosuojatallenteessa. Puolustettava API-luettelo yhdistää ne.
| Luettelokenttä | Miksi auditoijat välittävät | Esimerkkinäyttö |
|---|---|---|
| API:n nimi ja päätepiste | Osoittaa, että API tunnetaan ja kuuluu soveltamisalaan | API-katalogin vienti, yhdyskäytävän reittiluettelo, palvelurekisteri |
| Omistaja ja liiketoimintaprosessi | Yhdistää vastuullisuuden liiketoimintavaikutukseen | RACI, järjestelmäomistajan hyväksyntä, prosessikartta |
| Tietojen luokittelu ja henkilötietostatus | Tukee GDPR:n ja ISO 27001:n mukaista riskien käsittelyä | Tietoaineistorekisteri, DPIA-seulonta, luokittelutallenne |
| Todennusmenetelmä | Osoittaa pääsynhallinnan suunnittelun | OAuth-asiakasluettelo, mTLS-konfiguraatio, token-politiikka |
| Nopeusrajoitus ja väärinkäytön hallinta | Osoittaa häiriönsietokyvyn API-väärinkäyttöä vastaan | Yhdyskäytäväpolitiikka, testitulokset, hälytyssääntö |
| Lokitusvaatimukset | Tukee havaitsemista, tutkintaa ja raportointia | SIEM-mittaristo, lokiskeema, säilytysasetus |
| Kolmannen osapuolen riippuvuus | Tukee NIS2:n ja DORA:n toimitusketjuodotuksia | Toimittajarekisteri, sopimuslauseke, SLA |
| Kriittisyys ja palautumistavoite | Tukee jatkuvuuden ja häiriönsietokyvyn suunnittelua | BIA, RTO/RPO-tallenne, häiriönsietokyvyn testi |
Zenith Controls: vaatimustenmukaisuuksia yhdistävä opas Zenith Controls luokittelee ISO/IEC 27002:2022 -hallintakeinon 5.9, Inventory of information and other associated assets, ennaltaehkäiseväksi kontrolliksi, joka tukee luottamuksellisuutta, eheyttä ja saatavuutta. Sen kyberturvallisuuskonsepti on Identify, operatiivinen kyvykkyys on omaisuudenhallinta ja tietoturva-alueet ovat hallinnointi, ekosysteemi ja suojaus. Tämä auttaa auditoijia näkemään API-luettelon ennaltaehkäisevänä hallinnointikontrollina, ei hallinnollisena siivouksena.
Osoita, että jokainen API-identiteetti on tarkoituksellinen
Kun luettelo on olemassa, seuraava kysymys on ennakoitavissa: kuka tai mikä voi kutsua näitä API:eja?
Nykyaikaiset API:t todentavat ihmiskäyttäjiä, mobiilisovelluksia, palvelutilejä, CI/CD-töitä, kumppanijärjestelmiä, työkuormia, botteja, integraatioita, dataputkia ja kolmansien osapuolten alustoja. Heikot API-avaimet, pitkäikäiset bearer-tokenit, puuttuva mutual TLS, ylioikeutetut OAuth-scope-määritykset ja kiinteästi koodatut salaisuudet aiheuttavat auditointialtistusta.
Zenith Blueprint käsittelee Controls in Action -vaiheen vaiheessa 19 ISO/IEC 27002:2022 -hallintakeinoa 8.5, Secure authentication:
“Todennus on ensimmäinen ja kriittisin puolustuslinja uhkatoimijan ja järjestelmienne, datanne ja palvelujenne välillä. Jos todennus on heikko, kaikki muu — salaus, seuranta ja segmentointi — voidaan ohittaa.”
Sama vaihe korostaa koneiden välistä todennusta. Avaimet, varmenteet ja tokenit on suojattava tarkasti, tunnistetietoja ei tule upottaa koodiin, ja salaisuuksien hallintaa tai holveja tulee käyttää turvalliseen säilytykseen ja kiertoon.
Clarysecin yritystason Sovellusturvallisuusvaatimusten politiikka Sovellusturvallisuusvaatimusten politiikka tuo tämän suoraan API-hallinnointiin:
“Kaikki sovellusohjelmointirajapinnat (API:t), mikropalvelut ja ulkoiset integraatiot tulee suojata seuraavien avulla:”
Kohdasta “Hallinnointivaatimukset”, politiikkalauseke 5.3.
Sen jälkeen se määrittää:
“Vahvan todennuksen soveltaminen, kuten OAuth 2.0 ja mutual TLS”
Kohdasta “Hallinnointivaatimukset”, politiikkalauseke 5.3.1.
Pienemmille organisaatioille Clarysecin Sovellusturvallisuusvaatimusten politiikka – pk-yritys Sovellusturvallisuusvaatimusten politiikka – pk-yritys antaa perustason:
“Todennuskontrollit: Sovellusten tulee soveltaa vahvaa todennusta, mukaan lukien salasanojen vähimmäisvahvuus, tilien lukitus epäonnistuneiden yritysten jälkeen ja istunnon aikakatkaisut.”
Kohdasta “Politiikan toteutusvaatimukset”, politiikkalauseke 6.1.1.2.
API:eille nämä vaatimukset tulee muuntaa todennuksen näyttöpaketiksi:
- API-luettelo suodatettuna internetiin avautuviin, kumppaneille näkyviin, ylläpitäjä- ja sisäisiin API:eihin.
- Todennusmatriisi, joka näyttää OAuth 2.0:n, mTLS:n, allekirjoitetut pyynnöt, yhdyskäytävän auktorisoijat tai palveluverkon identiteetin.
- OAuth-asiakas- ja scope-rekisteri, jossa on omistaja, tarkoitus, vanheneminen, hyväksyntä ja viimeisin katselmointipäivä.
- Salaisuuksien hallinnan näyttö säilytyksestä, pääsystä, kierrosta ja perumisesta.
- Etuoikeutetun API-käytön käyttöoikeuskatselmointi ylläpitäjäpäätepisteille ja tuotannon palvelutileille.
- Epäonnistuneen todennuksen lokit ja hälytyssäännöt.
- Testitulokset puuttuvalle tokenille, vanhentuneelle tokenille, väärälle kohdeyleisölle, väärälle scope-määritykselle ja toistoskenaarioille.
Zenith Controls kartoittaa ISO/IEC 27002:2022 -hallintakeinon 8.5, Secure authentication, ennaltaehkäiseväksi kontrolliksi, joka tukee luottamuksellisuutta, eheyttä ja saatavuutta. Sen kyberturvallisuuskonsepti on Protect, operatiivinen kyvykkyys on identiteetin- ja pääsynhallinta ja tietoturva-alue on suojaus.
NIS2 Article 21 tukee tätä pääsynhallinnan, kryptografian ja tarvittaessa monivaiheisen tai jatkuvan todennuksen kautta. DORA odottaa finanssialan toimijoiden ylläpitävän kontrolleja, jotka suojaavat aitoutta, eheyttä, saatavuutta ja luottamuksellisuutta. GDPR Article 32 tekee heikosta API-todennuksesta käsittelyn turvallisuutta koskevan huolen, erityisesti silloin kun henkilötietoja altistuu.
Käsittele nopeusrajoitusta häiriönsietokyvyn näyttönä
Vahva todennus on välttämätöntä, mutta ei riittävää. Todennettu asiakas voi silti väärinkäyttää API:a. Hyökkääjät käyttävät API:eja tunnistetietojen kokeiluun, enumerointiin, scrapingiin, token-suihkutukseen, salasanan palautuksen pommitukseen, tapahtumien väärinkäyttöön ja palvelunestoon.
Nopeusrajoitusta pidettiin aiemmin suorituskykyominaisuutena. Vuonna 2026 se on tietoturvan, tietosuojan ja häiriönsietokyvyn näyttöä.
Clarysecin Sovellusturvallisuusvaatimusten politiikka toteaa:
“Nopeusrajoitus ja väärinkäytön ehkäisy”
Kohdasta “Hallinnointivaatimukset”, politiikkalauseke 5.3.2.
Zenith Blueprint selittää Controls in Action -vaiheen vaiheessa 20 ISO/IEC 27002:2022 -hallintakeinoa 8.26, Application security requirements, että sovellusturvallisuusvaatimusten tulee olla täsmällisiä ja toteutuskelpoisia. Se kysyy, tuleeko sovelluksen kestää injektiohyökkäyksiä, brute force -kirjautumisia tai palvelunestoyrityksiä. Se antaa myös API-kohtaisen esimerkin, jossa uuden API:n tulee sisältää pääsytunnisteen validointi ja syötteen sanitointi, ja toteaa, että julkisille rajapinnoille altistuvat alustat voivat edellyttää tiukempaa validointia, käyttäytymisanalytiikkaa ja nopeusrajoitusta.
Puolustettavan nopeusrajoitustallenteen tulee selittää paitsi se, että rajoitus on käytössä, myös miksi kynnysarvot valittiin, kuka hyväksyi poikkeukset ja miten hälytyksiä seurataan.
| API-luokka | Vähimmäistason hallinnointipäätös | Säilytettävä näyttö |
|---|---|---|
| Julkinen todentamaton API | Tiukat IP-, laite- tai istuntokohtaiset rajoitukset sekä bottien ja enumeroinnin havaitseminen | Yhdyskäytäväpolitiikka, testitulokset, hälytyssääntö |
| Todennettu asiakas-API | Käyttäjä- ja tenant-kohtaiset kiintiöt normaalin käytön perusteella | Käytön perustaso, kynnysarvon hyväksyntä, seurantamittaristo |
| Ylläpitäjä-API | Matalat kynnysarvot, etuoikeutettujen käyttöoikeuksien hälytys ja break-glass-poikkeusten käsittely | Etuoikeutetun API-käytön politiikka, SIEM-hälytys, käyttöoikeuskatselmointi |
| Kumppani-API | Sopimusperusteinen kiintiö mTLS- tai OAuth-asiakasidentiteetillä ja eskalointiyhteyshenkilöllä | Toimittajasopimus, perehdytyksen tarkistuslista, kiintiötallenne |
| Sisäinen palvelu-API | Palveluidentiteetti, palveluverkon politiikka, circuit breaker ja poikkeamien seuranta | Palveluverkon konfiguraatio, arkkitehtuurikaavio |
NIS2:n osalta tämä tukee turvallista kehittämistä, vaikuttavuuden arviointia, liiketoiminnan jatkuvuutta ja poikkeamien ehkäisyä. DORA:n osalta nopeusrajoitus liittyy ICT-riskien hallintaan, poikkeamien havaitsemiseen, häiriönsietokyvyn testaukseen ja kriittisten tai tärkeiden toimintojen jatkuvuuteen. GDPR:n osalta se tukee tietojen minimointia sekä suojaa liialliselta tai lainvastaiselta pääsyltä, erityisesti kun API-scraping voisi altistaa henkilötietoja.
Tee lokituksesta näyttökerros
Kun API-poikkeama tapahtuu, ensimmäinen todellinen kysymys ei ole “Onko teillä SIEM?” Se on “Pystyttekö rekonstruoimaan, mitä tapahtui?”
API-lokien tulee tallentaa todennuksen epäonnistumiset, valtuutuksen estot, token-väitteet, asiakasidentiteetti, lähde, päätepiste, metodi, pyynnön lopputulos, hallinnolliset muutokset, korkean riskin datakäyttö, nopeusrajoitustapahtumat, poikkeava volyymi, konfiguraatiomuutokset ja tietoturvarelevantit virheet. Niiden ei tule tallentaa salaisuuksia, bearer-tokeneita tai tarpeettomia henkilötietoja.
Zenith Blueprint toteaa Controls in Action -vaiheen vaiheessa 19 ISO/IEC 27002:2022 -hallintakeinon 8.15, Logging, osalta:
“Lokitus on turvallisen IT-ympäristön elinehto. Ilman sitä poikkeamat jäävät näkymättömiksi, vastuun osoitettavuus heikkenee ja syy-seuraussuhteet katoavat.”
Se myös selittää, että lokituksessa on kyse jäljitettävyydestä ja että hyödylliset lokit tulee säilyttää turvallisesti, niitä tulee seurata ja katselmoida ja ne tulee suojata peukaloinnilta.
Clarysecin Sovellusturvallisuusvaatimusten politiikka – pk-yritys edellyttää:
“Auditointilokitus: Sovellusten tulee lokittaa todennustapahtumat (kirjautumiset, uloskirjautumiset ja epäonnistuneet yritykset), datakäyttö ja hallinnolliset muutokset.”
Kohdasta “Politiikan toteutusvaatimukset”, politiikkalauseke 6.1.1.7.
Clarysecin Lokitus- ja valvontapolitiikka – pk-yritys Lokitus- ja valvontapolitiikka – pk-yritys määrittää lokituksen hallinnointiluokan:
“Vaaditut lokityypit”
Kohdasta “Hallinnointivaatimukset”, politiikkalauseke 5.4.
Pilvessä toimivien API:en osalta Clarysecin yritystason Pilvipalvelujen käyttöpolitiikka Pilvipalvelujen käyttöpolitiikka vahvistaa vaatimuksen:
“Lokien tulee tallentaa:”
Kohdasta “Politiikan toteutusvaatimukset”, politiikkalauseke 6.5.2.
Zenith Controls kartoittaa ISO/IEC 27002:2022 -hallintakeinon 8.15, Logging, havaitsevaksi kontrolliksi, joka tukee luottamuksellisuutta, eheyttä ja saatavuutta. Sen kyberturvallisuuskonsepti on Detect, operatiivinen kyvykkyys on tietoturvatapahtumien hallinta ja tietoturva-alueet ovat suojaus ja puolustus. Tämä tekee lokituksesta sillan politiikan ja näytön välillä.
NIS2 Article 23 edellyttää merkittävien poikkeamien vaiheistettua raportointia: ennakkovaroitus 24 tunnin kuluessa tietoisuudesta, poikkeamailmoitus 72 tunnin kuluessa, väliraportit pyydettäessä ja loppuraportti kuukauden kuluessa ilmoituksesta. Luottamuspalvelun tarjoajilta, joiden luottamuspalvelun tuottamiseen poikkeama vaikuttaa, edellytetään ilmoitusta 24 tunnin kuluessa tietoisuudesta.
DORA Articles 17 to 19 edellyttävät ICT:hen liittyvien poikkeamien hallintaa, johon sisältyvät ennakkovaroitusindikaattorit, vakavuuden ja kriittisyyden luokittelu, eskalointi, lokitus, juurisyyn seuranta ja merkittävien ICT:hen liittyvien poikkeamien raportointi alustavien, väliaikaisten ja lopullisten raporttien kautta. Myös GDPR:n mukainen loukkausarviointi perustuu lokeihin sen määrittämiseksi, onko henkilötietoihin päästy, keihin rekisteröityihin vaikutus kohdistui ja laukeavatko ilmoitusvelvoitteet.
Rakenna API-näyttöpaketti viidessä työpäivässä
Nopean sprintin tavoitteena ei ole korjata kaikkea API-tietoturvaa yhdessä viikossa. Tavoitteena on luoda puolustettava perustaso, tunnistaa puutteet ja aloittaa riskien käsittely.
Päivä 1: muodosta API-rekisteri
Vie reitit API-yhdyskäytävistä, palveluverkoista, pilvikuormantasaajista, serverless-funktioista, OpenAPI-tietovarastoista ja CI/CD-käyttöönottomanifesteista. Normalisoi ne yhdeksi API-rekisteriksi, jossa ovat päätepiste, ympäristö, omistaja, liiketoimintaprosessi, tietojen luokittelu, henkilötietoindikaattori, todennusmenetelmä, nopeusrajoitus, lokituksen tila, toimittajariippuvuus, kriittisyys ja viimeisin katselmointipäivä.
Käytä Omaisuudenhallintapolitiikan lauseketta 6.1.1 ja Zenith Blueprintin vaihetta 22 hallinnointiperustana.
Päivä 2: luokittele todennuspuutteet
Laadi todennusmatriisi. Merkitse API:t, joissa käytetään staattisia API-avaimia, pitkäikäisiä tokeneita, puuttuvaa kohdeyleisön validointia, puuttuvaa scope-validointia, puuttuvaa mTLS:ää kumppani-integraatioissa, jaettuja palvelutilejä tai puuttuvaa näyttöä avainten kierrosta.
Kartoita havainnot Sovellusturvallisuusvaatimusten politiikan lausekkeeseen 5.3.1 ja Zenith Blueprintin vaiheeseen 19. Kirjaa jokainen puute riskiksi, jolla on omistaja, käsittelypolku ja tavoitepäivä.
Päivä 3: osoita nopeusrajoitukset ja väärinkäytön hallinta
Tallenna julkisille, kumppani- ja ylläpitäjä-API:eille yhdyskäytäväpolitiikat, WAF-säännöt, bottikontrollit, kiintiöasetukset ja hälytyskynnykset. Jos kontrollit puuttuvat, kirjaa korvaavat kontrollit tai avoin riskien käsittely.
Käytä Sovellusturvallisuusvaatimusten politiikan lauseketta 5.3.2 politiikkavaltuutuksena. Kriittisten API:en osalta yhdistä kynnysarvot palveluvaikutukseen, asiakashaittaan sekä DORA- tai NIS2-häiriönsietokykyodotuksiin.
Päivä 4: validoi lokituksen kattavuus
Ota otos korkean riskin API:en lokeista. Varmista, että lokit tallentavat onnistuneen todennuksen, epäonnistuneen todennuksen, valtuutuksen eston, datakäytön, ylläpitomuutoksen, nopeusrajoitustapahtuman, lähdeidentiteetin ja korrelaatiotunnisteen. Varmista aikasynkronointi, säilytys, pääsynhallinta ja peukaloinnin suojaus.
Jos lokit sisältävät tokeneita, salaisuuksia tai liiallisia henkilötietoja, nosta tietosuoja- ja tietoturvakorjaukset käsiteltäviksi.
Päivä 5: toimita auditointivastauksen paketti
Toimita tiivis näyttökokonaisuus:
- API-luettelon vienti ja omistajuuden yhteenveto.
- API-riskirekisteri ja riskienkäsittelysuunnitelma.
- Todennusmatriisi ja token-katselmoinnin näyttö.
- Nopeusrajoitusnäyttö ja hyväksytyt poikkeukset.
- Lokituksen kattavuusraportti ja SIEM-mittariston kuvakaappaukset.
- Poikkeamien luokittelun pelikirja API-väärinkäytölle.
- Vaatimustenmukaisuuksia yhdistävä kartoitus ISO/IEC 27001:2022-, NIS2-, DORA-, GDPR-, NIST CSF 2.0- ja COBIT-linjaisiin auditointinäkymiin.
Keskeinen muutos on, että jokaisella artefaktilla on kontrollitarina. API-rekisteri tukee omaisuudenhallintaa. Todennus tukee pääsynhallintaa. Nopeusrajoitukset tukevat sovellusturvallisuutta ja häiriönsietokykyä. Lokit tukevat havaitsemista, tietoturvapoikkeamiin reagointia ja osoitusvelvollisuutta.
API-hallinnoinnin vaatimustenmukaisuuksia yhdistävä kartoitus
Suurin virhe on rakentaa erilliset näyttökokonaisuudet jokaista viitekehystä varten. API-hallinnointi toimii paremmin yhtenä kontrollimallina, jolla on useita sääntelynäkymiä.
| API-hallinnoinnin alue | ISO/IEC 27001:2022 -näyttönäkymä | NIS2-näkymä | DORA-näkymä | GDPR-näkymä | NIST CSF 2.0 -näkymä |
|---|---|---|---|---|---|
| API-luettelo | ISMS:n soveltamisala, omaisuusluettelo, riskien arviointi ja soveltuvuuslausunto | Omaisuudenhallinta ja riskianalyysi Article 21:n mukaisesti | ICT-omaisuuserien, riippuvuuksien ja kriittisten toimintojen tunnistaminen Article 8:n mukaisesti | Osoitusvelvollisuus, käsittelytoimien tallenteet ja sisäänrakennetun tietosuojan tuki | GOVERN- ja IDENTIFY-tulokset |
| Todennus | liite A:n turvallinen todennus, pääsynhallinta ja salaisuuksien käsittely | Pääsynhallinta, kryptografia ja tarvittaessa MFA tai jatkuva todennus | ICT-järjestelmien ja datan suojaus- ja ehkäisytoimenpiteet | Eheys ja luottamuksellisuus, käsittelyn turvallisuus Article 32:n mukaisesti | PROTECT-tulokset identiteetille ja turvalliselle pääsylle |
| Nopeusrajoitus | Sovellusturvallisuusvaatimukset, turvallinen kehittäminen ja operatiivinen ohjaus | Turvallinen kehittäminen, vaikuttavuuden arviointi, jatkuvuus ja poikkeamien ehkäisy | Poikkeamien havaitseminen, häiriönsietokyvyn testaus ja kriittisten toimintojen jatkuvuus | Tietojen minimointi sekä liiallisen tai lainvastaisen pääsyn ehkäisy | PROTECT- ja DETECT-tulokset |
| Lokitus | Lokitus, valvonta, poikkeamanäyttö ja auditoitavuus | Poikkeamien käsittelyn ja merkittävien poikkeamien raportoinnin tuki Article 23:n mukaisesti | ICT-poikkeamien hallinta, luokittelu, raportointi ja opit Articles 17 to 19:n mukaisesti | Loukkausarviointi, osoitusvelvollisuus ja ilmoitusnäyttö | DETECT-, RESPOND- ja RECOVER-tulokset |
| Kolmannen osapuolen API-riippuvuus | Toimittajasuhteet, ulkoisesti tuotetut prosessit ja riskien käsittely | Toimitusketjun turvallisuus Article 21:n mukaisesti | ICT-toimittajariskien hallinta ja kriittisten riippuvuuksien valvonta | Käsittelijän osoitusvelvollisuus ja sopimusperusteiset suojatoimet | GOVERN-tulokset toimitusketjuriskien hallinnalle |
ISO/IEC 27001:2022 tarjoaa hallintajärjestelmän, joka pitää näytön koossa. Clauses 4.1 to 4.4 edellyttävät, että organisaatio määrittää ISMS:n toimintaympäristön ja soveltamisalan, mukaan lukien sidosryhmät, lakisääteiset, sääntelyyn perustuvat ja sopimusvelvoitteet sekä rajapinnat tai riippuvuudet muihin organisaatioihin. Clauses 5.1 to 5.3 asettavat vastuun ylimmälle johdolle. Clauses 6.1.1 to 6.1.3 luovat riskien arvioinnin, riskien käsittelyn ja soveltuvuuslausunnon prosessin. Clause 8.1 edellyttää operatiivista suunnittelua ja ohjausta, mukaan lukien ISMS:n kannalta olennaisten ulkoisesti tuotettujen prosessien, tuotteiden tai palvelujen ohjaus.
API-hallinnoinnissa tämä tarkoittaa, että kolmannen osapuolen maksu-API, pilvi-identiteetti-API tai ulkoistettu petosten havaitsemisen API ei ole vaatimustenmukaisuuden ulkopuolella siksi, että se on ulkoinen. Se on rajapinta ja riippuvuus, joka tulee sisällyttää soveltamisalaan, arvioida riskien osalta ja kontrolloida.
NIST CSF 2.0 lisää hyödyllisen johdon näkymän. Sen GOVERN-toiminto auttaa organisaatioita määrittämään sidosryhmien odotukset, lakisääteiset velvoitteet, riskinottohalukkuuden ja toimitusketjuriskin. Sen Profiles-lähestymistapa tukee nykyprofiilia, tavoiteprofiilia, priorisoitua puutesuunnitelmaa ja jatkuvan parantamisen sykliä. Juuri näin API-hallinnointisprintin tulee toimia.
COBIT 2019 voi tukea johtamisen näkökulmaa yhdistämällä API-kontrollit hallinnointitavoitteisiin, kontrolliomistajuuteen, palvelun jatkuvuuteen, tietoturvan valvontaan, riskiraportointiin ja ongelmien seurantaan. Olennaista ei ole pakottaa API:eja yhteen viitekehykseen, vaan osoittaa, että yksi näyttömalli vastaa useisiin varmennuskysymyksiin.
Miten auditoijat testaavat API-hallinnointia
Vahva ohjelma ennakoi auditoijan näkökulman. Sama näyttö testataan eri tavoin viitekehyksestä riippuen.
| Auditoijan näkökulma | Tyypillinen auditointikysymys | Näyttö, joka vastaa hyvin |
|---|---|---|
| ISO/IEC 27001:2022 -auditoija | Sisältyvätkö API:t ISMS:n soveltamisalaan, riskien arviointiin, omaisuusluetteloon ja soveltuvuuslausuntoon? | API-rekisteri, soveltamisalakuvaus, riskien arviointi, SoA-kartoitus, politiikkalausekkeet, sisäisen tarkastuksen tallenne |
| NIST-suuntautunut arvioija | Onko käytössä nykyinen ja tavoiteltu API-tietoturvaprofiili sekä priorisoidut puutteet? | Current Profile, Target Profile, POA&M, riskirekisteri, hallinnointipäätökset |
| COBIT- tai ISACA-auditoija | Hallinnoidaanko, valvotaanko ja mitataanko API-kontrolleja osana yrityksen IT-tavoitteita? | Kontrolliomistajuus, mittarit, lokikatselmoinnin näyttö, johdon raportointi, ongelmien seuranta |
| NIS2-arvioija | Voiko johto osoittaa hyväksynnän, valvonnan ja oikeasuhtaiset toimenpiteet palveluihin vaikuttaville API:eille? | Hallitusraportointi, politiikan hyväksyntä, Article 21 -kartoitus, poikkeamien raportoinnin pelikirja |
| DORA-arvioija | Onko kriittisiä tai tärkeitä toimintoja tukevat API:t luetteloitu, testattu, valvottu ja katettu ICT-toimittajariskien hallinnassa? | Kriittisyysrekisteri, häiriönsietokyvyn testit, kolmannen osapuolen rekisteri, poikkeamien luokittelu, jatkuvuusnäyttö |
| GDPR-tietosuoja-arvioija | Voiko organisaatio osoittaa API:en kautta tapahtuvan käsittelyn lainmukaiseksi, rajatuksi ja turvalliseksi? | Tietovirtojen tallenteet, DPIA-seulonta, käyttölokit, minimointikontrollit, loukkausarviointimenettely |
Clarysec suosittelee näytön triangulointia. Älä näytä vain politiikkaa. Näytä politiikka, toteutusnäyttö ja operatiivinen näyttö.
Esimerkiksi:
- Politiikka: API:en tulee käyttää OAuth 2.0:aa tai mTLS:ää soveltuvin osin.
- Konfiguraatio: API-yhdyskäytävän reitti näyttää JWT-validoinnin ja sallitun kohdeyleisön.
- Operatiivinen näyttö: epäonnistuneet token-yritykset lokitetaan ja hälytys on aktiivinen.
- Katselmointinäyttö: OAuth-asiakaskatselmointi on suoritettu omistajan hyväksynnällä.
- Riskinäyttö: legacy-API-poikkeuksella on korvaavat kontrollit ja käsittelyn määräaika.
Tämä on huomattavasti vahvempi kuin pelkkiin kuvakaappauksiin perustuva vastaus.
API-hallinnoinnin yleiset sudenkuopat
Yleisin ongelma ei ole se, että API:t olisivat täysin suojaamattomia. Ongelma on tietoturvan epäyhtenäisyys.
Yksi tiimi käyttää OAuth-scope-määrityksiä hyvin, toinen käyttää jaettua API-avainta. Yksi palvelu lokittaa datakäytön, toinen lokittaa vain palvelinvirheet. Yhdessä kumppani-integraatiossa on mTLS, toinen luottaa pitkäikäiseen bearer-tokeniin. Julkisille päätepisteille on nopeusrajoituksia, mutta ei todennetuille asiakas-API:eille, joissa scraping voi tapahtua. CMDB listaa sovelluksen, mutta ei sen API:eja, tokeneita, varmenteita, tietoluokkia tai toimittajia.
Toistuvia sudenkuoppia ovat:
- Varjo-API:t, jotka otetaan käyttöön serverless-funktioiden tai väliaikaisten testireittien kautta.
- API-avaimet, joita säilytetään CI/CD-muuttujissa ilman dokumentoitua kiertoa.
- Lokitus, joka tallentaa tokeneita, salaisuuksia tai tarpeettomia henkilötietoja.
- Korrelaatiotunnisteen puuttuminen yhdyskäytävän, sovelluksen ja tietokannan lokien välillä.
- Suurille asiakkaille epämuodollisesti myönnetyt nopeusrajoituspoikkeukset.
- Kumppani-API:eista puuttuvat sopimusperusteiset poikkeamailmoitukset tai auditointioikeudet.
- API-kohtaisen poikkeamaluokittelun puuttuminen enumeroinnille, scrapingille tai token-väärinkäytölle.
- API-tietovirtojen ja GDPR-käsittelytallenteiden välisen kartoituksen puuttuminen.
- Tietoturvatestaus keskittyy web-käyttöliittymään, mutta API:t jäävät testaamatta.
- Hallitusraportit näyttävät “sovellusturvallisuuden” ilman API-kohtaisia riskimittareita.
Nämä ovat ratkaistavissa olevia ongelmia, mutta vain jos organisaatio käsittelee API-hallinnointia hallittuna kontrollialueena.
Muuta API-tietoturva auditointia kestäväksi hallinnoinniksi
Jos seuraava auditointi pyytää API-tietoturvan näyttöä, älä aloita keräämällä satunnaisia kuvakaappauksia. Aloita kontrollitarinasta.
Clarysec voi auttaa sen rakentamisessa seuraavilla:
- Zenith Blueprint Zenith Blueprint, joka auttaa jäsentämään toteutuksen omaisuusluettelon, turvallisen todennuksen, sovellusturvallisuusvaatimusten ja lokituksen osalta.
- Zenith Controls Zenith Controls, joka kartoittaa ISO/IEC 27002:2022 -hallintakeinot, kuten 5.9, 8.5, 8.15 ja 8.26, vaatimustenmukaisuuksia yhdistäviin odotuksiin ja auditointinäkökulmiin.
- Clarysecin politiikat, mukaan lukien Omaisuudenhallintapolitiikka Omaisuudenhallintapolitiikka, Sovellusturvallisuusvaatimusten politiikka Sovellusturvallisuusvaatimusten politiikka, Pilvipalvelujen käyttöpolitiikka Pilvipalvelujen käyttöpolitiikka, Omaisuudenhallintapolitiikka – pk-yritys Omaisuudenhallintapolitiikka – pk-yritys, Sovellusturvallisuusvaatimusten politiikka – pk-yritys Sovellusturvallisuusvaatimusten politiikka – pk-yritys ja Lokitus- ja valvontapolitiikka – pk-yritys Lokitus- ja valvontapolitiikka – pk-yritys.
Käytännöllinen seuraava askel on toteuttaa Clarysec API Governance Evidence Sprint: luetteloi API:t, luokittele todennus, tarkista nopeusrajoitukset, validoi lokitus, kartoita kolmansien osapuolten riippuvuudet ja tuota ISO 27001 -valmis näyttöpaketti, jossa on NIS2-, DORA-, GDPR-, NIST CSF 2.0- ja COBIT-linjaiset auditointinäkymät.
API:t ovat kohta, jossa liiketoimintalogiikka, asiakasdata ja kolmansien osapuolten riippuvuudet kohtaavat. Vuonna 2026 ne ansaitsevat enemmän kuin teknisen suojauksen. Ne tarvitsevat hallinnointia, joka kestää auditoinnin, tukee viranomaisvastetta ja auttaa tiimejä havaitsemaan väärinkäytön ennen asiakkaita.
Frequently Asked Questions
About the Author

Igor Petreski
Compliance Systems Architect, Clarysec LLC
Igor Petreski is a cybersecurity leader with over 30 years of experience in information technology and a dedicated decade specializing in global Governance, Risk, and Compliance (GRC).Core Credentials & Qualifications:• MSc in Cyber Security from Royal Holloway, University of London• PECB-Certified ISO/IEC 27001 Lead Auditor & Trainer• Certified Information Systems Auditor (CISA) from ISACA• Certified Information Security Manager (CISM) from ISACA • Certified Ethical Hacker from EC-Council


