Märke on odav näidata ja kallis tõlgendada. Avaldatud auditiaruanne on piiratud tükk inseneritööd: nimetatud hindaja uuris nimetatud komponente nimetatud versioonis, deklareeritud meetodi ja ajaeelarvega. Need neli fakti määravad, mida järeldus saab toetada, ja need on tavaliselt esimestel lehekülgedel, mitte turunduskokkuvõttes. Nende lugemine võtab kümme minutit ja hoiab ära levinud vea laiendada kliendirakenduse leidu tervele teenusele.

Mida ulatuse jaotis tegelikult piirab

Ulatusdeklaratsioon on tara ja kõik sellest väljaspool on vastamata, mitte läbitud. Aruanded loetlevad uuritud komponendid, commit'i vahemiku või versiooni identifikaatori, kasutatud keskkonna ja lubatud interaktsioonimudeli. Töölauaklient, mobiilirakendus, serverikood, konto backend ja tootmise infrastruktuur on viis erinevat teemat ning töö võib katta nende mis tahes alamhulga.

Väljajätmised loevad sama palju kui kaasamised, sest need deklareeritakse meelega ja loetakse hooletult. Ulatusest väljas kirjeldatud kontosüsteemi ei eeldata turvaliseks ja tööst välja jäetud mobiilirakendus on lihtsalt uurimata. Märgi oma märkmetes iga testimata komponent teadmata olevaks ja vastusta kiusatust täita tühik mainega.

Kahte liiki test vastavad erinevatele küsimustele

Lähtekoodi ülevaatus ja käitusaegne testimine otsivad erinevaid rikkeid. Koodi lugev ülevaataja saab jälgida võtme tuletamist, märgata puuduvat pikkusekontrolli ja arutleda terve parsija üle seda käivitamata. Töötava teenuse vastu testija avastab, mida juurutatud versioon tegelikult teeb: sertifikaat, mille rakendus tagasi lükkab, endiselt lubatud varuprotokoll, lõpp-punkt, mis lekitab versioonibännerit konfiguratsiooni kaudu, mida keegi ei vaadanud.

Kumbki ei asenda teist ja aruanne nimetab tavaliselt, kumb tehti. Kui kokkuvõte ütleb «auditeeritud» ilma selle eristuseta, on ebaselgus kokkuvõttes, mitte aruandes.

Ligipääsupiirangud teevad sama tööd. Musta kasti töö ei näe serveri konfiguratsiooni ja arhitektuuri ülevaatus, mis ei puuduta kunagi juurutatud lõpp-punkti, ei saa märgata, et tootmine erineb diagrammist. Mõlemad on legitiimsed; nende tulemuste segamine ei ole.

Kuidas leid saab parandatud versiooniks

Aruande väärtuslik pool on kõrvaldamise tabel: iga leid, selle raskusaste hindaja meetodi järgi, operaatori vastus ja kordustesti tulemus. Raskusastme numbrid tulevad valitud metoodikast, mitte loodusest, seega võrdle raskusastmeid ühe aruande sees, mitte kahe erineva skaalaga aruande vahel.

Seejärel ühenda parandus välja antud tarkvaraga. Parandatud leid on kasutajale oluline alles siis, kui parandust kandev versioon on paigaldatud, mistõttu tuleb aruande versiooni identifikaatorit ja väljalaske muudatuste logi lugeda koos. Parandust katnud kordustest sulgeb ringi; testimata parandus on väide. Nii on ka parandusega, mis saadeti ainult haru, mida ükski stabiilne väljalase kunagi ei liitnud.

Mida märk sulle öelda ei saa

Leidude puudumine ei ole tõestus defektide puudumisest. Fikseeritud eelarvega lühike töö jätab midagi märkamata ja puhta aruande aus lugemine on see, et hindaja ei leidnud neid probleemiklasse, mida ta saadaoleva aja jooksul otsis.

Märk ei saa ka rääkida omadustest väljaspool oma ulatust. Väited logimistavade, jurisdiktsiooni või säilitamise kohta elavad poliitikadokumendis, mitte kliendirakenduse auditis, ja ükski hindaja maine ei kandu üle selle piiri.

Tõendite fikseerimine, mida saad kaitsta

Kirjuta viide kolmes osas: komponent, versioon ja kinnitatud parandus. Avaldatud töö nagu Mozilla tellitud VPN-i audit toetab täpselt neid väiteid, mida kirjeldab selle ulatus, ja mitte midagi laiemat, mis on täpse viite korral siiski üsna palju väärt. Sama aruanne, mida tsiteeritakse millegi eest, mida see kunagi ei uurinud, on väärt vähem kui viite puudumine, sest see kutsub usaldust, mida keegi ei teeninud.

Kui väidetud omadus jääb väljapoole kõiki saadaolevaid aruandeid, jäta see dokumendis lahendamata. Lahendamata rida kutsub järelküsimuse; märk mitte. Ainus erand on omadus, mille lahendab teine, sama konkreetne dokument, ja siis muutub viide, mitte väide.

Veel kaks harjumust teevad lugemise kestvaks: märgi aruande kuupäev selle väljalaske suhtes, mida tegelikult kasutad, ja hoia vahet testitu ja juurutatu vahel. Mõlemad muudavad usaldusotsuse millekski, mida kolleeg saab kontrollida.

Seotud artiklid