Diffiniwch y llawdriniaeth VPN cyn cymharu APIau

Mae tudalen cynnyrch yn dweud bod ganddo API, ac mae'r cyfarfod integreiddio yn stopio ar yr ail gwestiwn. Pa lawdriniaeth, ar ba wrthrych, gan bwy, a beth sy'n cyfrif fel llwyddiant? Mae ateb y pedwar hyn cyn cymharu cynnyrch fel arfer yn dileu hanner yr ymgeiswyr. Mae hefyd yn troi'r gymhariaeth sy'n weddill yn rhywbeth y gall prawf ei setlo.

Disodlwch yr honiad bod ganddo API ag un llawdriniaeth

Cludiant yw API, nid gallu. Gall pwynt terfyn REST, soced lleol a throellawr llinell orchymyn i gyd gael eu galw'n API, ac nid ydynt yn cynnig llawdriniaethau cyfatebol.

Ysgrifennwch y llawdriniaeth fel brawddeg cyn agor y ddogfennaeth.

Mae dechrau cysylltiad lleol yn weithred ochr cleient gyda defnyddiwr o'i flaen. Mae cyhoeddi proffil dyfais yn weithred ddarparu gyda rhestr eiddo y tu ôl iddi. Mae analluogi mynediad defnyddiwr yn weithred weinyddol gyda llwybr archwilio. Mae'r tri hyn fel arfer yn byw mewn cydrannau gwahanol, yn eiddo i dimau gwahanol, gydag awdurdod gwahanol.

Pedwar maes sy'n gwneud y contract yn brofadwy

Llenwch bedwar maes ar gyfer pob llawdriniaeth: y gwrthrych, y weithred, y galwr a'r amod llwyddiant. Dymuniad yw contract sydd â maes ar goll.

Y tabl yw'r daflen waith gyfan:

Yr amod llwyddiant yw'r maes y mae pobl yn ei hepgor, a hwnnw sy'n penderfynu a yw'r integreiddiad yn gweithio. Nid yw gosodiad wedi'i gadw yn dwnnel gweithredol, ac nid yw cyfrif wedi'i analluogi yn sesiwn wedi'i diweddu.

Os oes angen gwahanol alwyr ar ddwy lawdriniaeth, dau integreiddiad ydynt. Mae eu bwmio i un cyfrif gwasanaeth fel arfer yn golygu rhoi mwy o awdurdod nag sydd ei angen ar y naill na'r llall.

Cydweddwch y rhyngwyneb â'i haen wirioneddol

Mae rhyngwyneb rheoli cymunedol OpenVPN yn siarad â daemon dros TCP neu soced Unix. Mae ei orchmynion yn cynnwys arsylwadau cyflwr a signalau daemon.

Mae hynny'n ei wneud yn sianel reoli daemon, nid yn API tanysgrifiad a gynhelir nac yn wasanaeth cofrestru defnyddwyr. Mae darllen ei ddogfennaeth yn ofalus yn eich arbed rhag adeiladu yn erbyn haen nad yw'n berchen ar y gwrthrych.

Mae'r ddogfennaeth honno hefyd yn dweud nad oes gan y protocol unrhyw amgryptio ei hun. Gall pwy bynnag sy'n cyrraedd y soced reoli'r daemon, felly triniwch ef fel rheolaeth sensitif yn hytrach na ffrwd metrigau. Clymwch ef i loopback neu soced Unix, a'i roi y tu ôl i drefniant cyfyngedig os oes angen galwr o bell. Mae ei amlygu i'r rhyngrwyd er cyfleustra yn troi sianel reoli yn ddigwyddiad.

Pennwch ymddygiad ar ôl yr alwad

Nid yw derbyn yr un peth â chwblhau. Gall y daemon ddychwelyd cyn i'r twnnel godi, felly arhoswch am y digwyddiad cwblhau neu fethu dogfennol a'i gysylltu â'r cais a anfonwyd gennych.

Penderfynwch beth mae'r galwr yn ei wneud os collir yr ymateb. Nid yw ailadrodd creu neu ailgysylltu'n ddall yr un peth â gwirio a yw'r cais cyntaf eisoes wedi gweithredu.

Mae tri gweithred wahanol o leiaf yn rhan o dynnu mynediad: rhwystro mewngofnodi yn y dyfodol, terfynu sesiwn fyw, ac adalw'r cymhwyster. Gofynnwch am y rhai y mae'r polisi wir yn eu hangen, a dweud yn y contract pa un yw pa un. Peidiwch â labelu un diweddariad cyfrif llwyddiannus yn adalwad llwyr heb dystiolaeth. Mae'r gwahaniaeth yn bwysig yn ystod digwyddiad, pan fo'r cloc yn rhedeg.

Profwch y contract gyda pheilot

Dylai peilot bach cymeradwy gwmpasu llwyddiant, gwrthodiad, ymyrraeth ac ailgynnig, ac yna'r llawdriniaeth gymhwysiad y dylid ei chaniatáu neu ei gwrthod.

Ar gyfer rhyngwyneb ar lefel daemon, mae dau orchymyn yn arfer arsylwi a signal:

echo state | nc -w 2 127.0.0.1 7505
echo signal SIGTERM | nc -w 2 127.0.0.1 7505

Rhowch yn unig yr awdurdod y mae'r llawdriniaeth yn ei angen. Cadwch gyfrinachau allan o logiau arferol, a logiwch ddigon o fanylion preifat i ddweud pa darged a gafodd ei effeithio a sut y daeth i ben.

Ysgrifennwch y llwybr adfer ar gyfer yr achos pan fo'r API rheoli ei hun i lawr. Dewiswch y rhyngwyneb sy'n berchen ar y gwrthrych a'i gylch bywyd; nid yw honiadau awtomeiddio ar dudalen cynnyrch yn ddewis arall.