Skilgreindu VPN-aðgerðina áður en þú ber saman API
Stjórnun tenginga, útdeiling sniða, notendastjórnun og athugun eru mismunandi API. Neftu fyrst hlutinn, aðgerðina og skilyrði árangurs.
Vörusíða segir að það sé API, og samþættingarfundurinn stöðvast á annarri spurningu. Hvaða aðgerð, á hvaða hlut, kölluð af hverjum, og hvað telst árangur? Að svara þessum fjórum áður en vara er borin saman eyðir venjulega helmingi umsækjenda. Það gerir einnig eftirstandandi samanburð að einhverju sem prófun getur ráðið.
Skiptu fullyrðingunni um API út fyrir eina aðgerð
API er flutningur, ekki geta. REST-endapunktur, staðbundið socket og skel fyrir skipanalínu geta öll kallast API, og þau bjóða ekki jafngildar aðgerðir.
Skrifaðu aðgerðina sem setningu áður en þú opnar skjölin.
Að hefja staðbundna tengingu er aðgerð á biðlara með notanda fyrir framan. Að gefa út tækjasnið er útdeilingaraðgerð með skrá yfir tæki að baki. Að slökkva á aðgangi notanda er stjórnsýsluaðgerð með endurskoðunarferli. Þessar þrjár lifa venjulega í mismunandi hlutum, í eigu mismunandi teyma, með mismunandi heimild.
Fjögur svæði sem gera samninginn prófanlegan
Fylltu út fjögur svæði fyrir hverja aðgerð: hlutinn, aðgerðina, kallarann og skilyrði árangurs. Samningur með vanti svæði er ósk.
Taflan er allt vinnublaðið:
| Field | Question | Example |
|---|---|---|
| Object | What is being acted on? | One enrolled device |
| Action | Observe, create, change, start, stop, or revoke? | Revoke |
| Caller | Which identity calls it? | Deployment service |
| Success | What observable state proves it? | Future sign-in denied |
Skilyrði árangurs er svæðið sem fólk sleppir, og það ræður hvort samþættingin virkar. Vistuð stilling er ekki virk göng, og óvirkur reikningur er ekki lokið lota.
Ef tvær aðgerðir þurfa mismunandi kallara eru það tvær samþættingar. Að sameina þær í einn þjónustureikning þýðir venjulega að veita meiri heimild en hvorug þeirra þarf.
Lagaðu viðmótið að raunverulegu lagi þess
Stjórnviðmót samfélagsins fyrir OpenVPN talar við daemon um TCP eða Unix-socket. Skipanir þess fela í sér athugun á stöðu og merki til daemonsins.
Það gerir það að stjórnrás daemonsins, ekki hýst áskriftar-API eða skráningaþjónustu notenda. Vönduð lestur skjalanna sparar þér að byggja á lagi sem á ekki hlutinn.
Sömu skjöl segja að samskiptareglan beri ekki eigin dulkóðun. Hver sem nær socketinu getur stjórnað daemoninum, svo meðhöndlaðu það sem viðkvæma stjórn en ekki mæligagnastreymi. Taktu það við loopback eða Unix-socket, og settu það bak við takmarkað fyrirkomulag ef fjarkallari þarf þess. Að afhjúpa það á internetinu til hægðar gerir stjórnrás að atviki.
Tilgreindu hegðun eftir kallið
Samþykki er ekki það sama og lok. Daemoninn getur snúið til baka áður en göngin rísa, svo bíddu eftir skjalfestum lokum eða bilunaratburði og tengdu hann beiðninni sem þú sendir.
Ákveddu hvað kallarinn gerir ef svarið týnist. Að endurtaka stofnun eða endurtengingu blindandi er ekki það sama og að athuga hvort fyrsta beiðnin hafi þegar haft áhrif.
Að fjarlægja aðgang er að minnsta kosti þrjár mismunandi aðgerðir: loka fyrir framtíðarinnskráningu, stöðva virka lotu og afturkalla skírteinið. Biddu um þær sem stefnan krefst í raun, og segðu í samningnum hver er hver. Ekki merkja eina farsæla reikningsuppfærslu sem fulla afturköllun án sönnunar. Munurinn skiptir máli í atviki, þegar klukkan er í gangi.
Prófaðu samninginn með prufu
Lítil samþykkt prufa ætti að ná yfir árangur, höfnun, truflun og endurtekið tilraun, og síðan forritaaðgerðina sem á að leyfa eða synja.
Fyrir viðmót á daemonstigi þjálfa tvær skipanir athugun og merki:
echo state | nc -w 2 127.0.0.1 7505
echo signal SIGTERM | nc -w 2 127.0.0.1 7505Veittu aðeins þá heimild sem aðgerðin krefst. Haltu leyndarmálum utan venjulegra annála, og skráðu nægar einkaupplýsingar til að segja hvaða skotmark varð fyrir áhrifum og hvernig það endaði.
Skrifaðu endurheimtunarleiðina fyrir það tilvik að stjórn-APIið sjálft er niðri. Veldu viðmótið sem á hlutinn og lífsferil hans; sjálfvirknigfullyrðingar á vörusíðu eru ekki staðgengill.