Näin dokumentoit VPN-lukituksen poikkeuksen niin, että se voidaan poistaa
Poikkeus, jota kukaan ei osaa kuvata, on pysyvä. Kirjaa liikenne, jonka se sallii, vaatimus, vikatilannekäyttäytyminen ja komponentti, joka poistaa sen.
Ohitukset, joiden tarkoitus lähti tekijänsä mukana, ovat niitä, jotka elävät käyttökelpoisuuttaan pidempään, ja lukituskäytännöt keräävät niitä nopeammin kuin mitään muuta määritystyyppiä. Poikkeus, joka on kirjoitettu muotoon ”salli paikallinen verkko”, on sääntö, jota kukaan ei voi puolustaa eikä kukaan voi poistaa käytöstä, koska sen takana oleva vaatimus lähti sen lisänneen henkilön mukana. Tällaiset käytännöt epäonnistuvat kantamalla poikkeuksia, joiden syy haihtui riskin jäädessä. Hetki kirjoittaa laajuus, vikatilannekäyttäytyminen ja poistovaihe on hetki, jolloin lisäät poikkeuksen, kun joku vielä muistaa miksi.
Tämä on päätös siitä, mitä muistiinpanon on sisällettävä, ei täytettävä mallipohja. Alla olevat neljä kenttää ratkaisevat, voiko arvioija poistaa säännön vuotta myöhemmin ilman palaveria. Jokainen niistä on olemassa, koska sen puuttumisella on ennustettava hinta.
Miksi dokumentoimatonta ohitusta ei koskaan poisteta käytöstä
Ohitusta ilman kuvausta ei voi testata, joten sitä ei voi poistaa turvallisesti. Se selviää jokaisesta katselmuksesta, koska poistaminen näyttää riskialttiilta ja säilyttäminen vaarattomalta, ja jokainen katselmus, joka sivuuttaa sen, tekee seuraavastakin helpomman sivuuttaa. Hinta on näkymätön, kunnes auditointi kysyy, miksi yksityinen alue on vapautettu, ja silloin vastaus on olankohautus.
Merkinnän on oltava tarpeeksi lyhyt, että ihmiset todella kirjoittavat sen muutosikkunassa. Yksi rivi liikenteelle, yksi vaatimukselle, jota se palvelee.
Laajuuden kirjoittaminen liikenteenä
Luettele sovellus tai kohdealue, asiaan liittyvät osoiteperheet, palvelu ja portti sekä verkkoympäristö, jossa sääntö pätee, ja nimeä sitten hyväksyjä ja tarkka asiakas- tai alusta-asetus, joka sen kantaa. ”Tulostin” on aikomus; ”TCP 631 osoitteeseen 192.168.1.50, vain kotiverkko” on laajuus, jonka joku voi tarkistaa. Jos vastaus kysymykseen ”missä tämä asuu” on ”jossain MDM-profiilissa”, merkintä ei ole valmis. Tiedostopolku, profiilin nimi tai rekisteriavain on parempi kuin kuvaus siitä, missä asetus voisi olla.
Kun alusta tukee sovelluskohtaisia sääntöjä, suosi niitä osoitealueiden sijaan, koska yhden sovelluksen salliminen ohittaa tunneli on kapeampi kuin koko yksityisen aliverkon vapauttaminen, ja se selviää laitteen siirtymisestä uuteen osoitteeseen. Androidin VpnService-opas kuvaa tämän sovelluskohtaisen mallin; työpöytäasiakkaat ilmaisevat saman idean omilla profiiliasetuksillaan. Osoiteperusteiset vapautukset ovat varavaihtoehto, kun alusta ei tarjoa mitään kapeampaa, minkä vuoksi ne tarvitsevat terävämmän laajuusrivin.
Neljä poikkeustyyppiä, neljä poistoriskiä
Poikkeukset eivät ole yksi luokka, ja niiden poistamisella on erilaisia seurauksia. Yhden rivin jakaminen kahden tyypin kesken on se tapa, jolla tulostimen käytöstä poisto poistaa myös yhteydenmuodostuskyvyn.
| Kind | Typical example | Removal risk |
|---|---|---|
| Endpoint bootstrap | reaching the gateway before the tunnel exists | high: nothing comes up without it |
| Captive portal | hotel or airport sign-in page | medium: only matters on untrusted networks |
| Local device | printer, casting target, test instrument | low: one service at one address |
| Excluded application | an app that must not use the tunnel | medium: depends on the app's own behaviour |
Pidä bootstrap-, portaali-, laite- ja sovelluspoikkeukset erillisillä riveillä, vaikka ne käytännössä menisivätkin päällekkäin. Yksityisen alueen vapautus antaa hiljaisesti pääsyn jokaiselle naapurille siinä aliverkossa sen sijaan, että se antaisi sen yhden laitteen, johon halusit päästä, ja se on ero sen välillä, mitä voit puolustaa, ja sen välillä, mihin vain toivot.
Mitä ohitus tekee, kun tunneli katkeaa
Esitä kolme kysymystä ja kirjoita vastaukset, koska ne ratkaisevat, onko lukitus todellinen. Pysyykö poikkeus käyttökelpoisena, kun tunneli katkeaa: captive-portaalin kohdalla sen on pakko, muuten kukaan ei voi koskaan kirjautua sisään, kun taas yksityisen resurssin kohdalla sen ei yleensä pidä, muuten käytäntö on koristeellinen. Päteekö se kaikissa verkoissa vai vain aiotussa ympäristössä, koska kotiverkkoon rajattu sääntö käyttäytyy hyvin eri tavalla julkisessa verkossa, joka sattuu käyttämään samaa aluetta. Jokainen vastaus muuttaa sekä sääntöä että muistiinpanoa, joten vastaamatta jäänyt kysymys on päätös, jonka joku toinen tekee myöhemmin väärin.
Kolmas kysymys on, mitä tapahtuu kun kohde vaihtaa osoitettaan, missä verkkotunnuspohjaiset ja osoitepohjaiset vapautukset erkanevat. Verkkotunnuspohjaiset säännöt riippuvat siitä, milloin nimien selvitys tapahtuu ja miten asiakas soveltaa tulosta, joten ne voivat hiljaisesti lakkautua täsmäämästä näennäisesti liittymättömän muutoksen jälkeen, ja vika näyttää rikkinäiseltä VPN:ltä eikä vanhentuneelta vapautukselta.
Testaa, testaa uudelleen ja kirjoita poistovaihe
Kirjoita yksi vaaraton testi sallitulle polulle ja yksi lähellä oleva estetty tapaus: tulostimen sivu latautuu eikä saman aliverkon tiedostojako lataudu. Tämä pari todistaa, että poikkeus on kapea, ja se on pari, jonka arvioija voi toistaa ymmärtämättä alkuperäistä pyyntöä. Aseta sitten uudelleentestauksen liipaisimet, koska poikkeus, jota ei koskaan testata uudelleen, ajautuu pois siitä vaatimuksesta, jota varten se kirjoitettiin, ja ajautuminen pysyy näkymättömänä, kunnes jotain hajoaa.
Kirjaa lopuksi, miten sääntö poistetaan sen omistavan komponentin kautta, ja pidä salaisuudet poissa muistiinpanosta. Palvelun ja reitin kuvaaminen ei koskaan vaadi yksityistä avainta, salasanaa tai kenenkään selaushistoriaa, ja lyhyt ylläpidetty luettelo on parempi kuin väliaikainen sääntö, joka eli kirjoittajansa pidempään.