Nordlet

← Blag

Agallamh API Cuntasaíochta a Sheasann le Iniúchadh

Treoir phraiticiúil ar na rialuithe slándála agus iniúchta a dteastaíonn ó API airgeadais sula mtiomáineann gnóthaí san Ísiltír a dtiomantas dá gcuid leabhar.

Nordlet Team · · 11 min léite

Ní insíonn API cuntasaíochta a thugann 200 OK ar scríobh íocaíochta aon rud beagnach duit. Ní dhearbhaíonn sé gur taifead an leabhar mór an iontráil, go raibh údarás ag an ngníomhaire é a dhéanamh, gur rith an méid bailíochtú, nó gur cheadaigh éinne a raibh údarás aige é. I gcás gnóthaí san Ísiltír, áit a súileann an t-údarás cánach go mbeidh taifid in-athnuaite agus ar choinneáil ar feadh seacht mbliana, is san achar sin idir "d'éirigh leis an iarratas" agus "tá na leabhair ceart" a théann iniúchtaí ar strae.

Is sprioc dearaidh oibríochtúil é a bheith réidh d'iniúchadh, ní teastas é. Ciallaíonn sé go gcoinníonn an API slabhra iomlán: gníomhaire fíordheimhnithe chuig gníomh údaráis chuig athrú stáit bailíochtaithe chuig ceadú chuig toradh an leabhair mhóir chuig fianaise frithsheasmhach in aghaidh an tampered. Baineann gach rud thíos le an slabhra sin a thógáil go saoránach seachas a ghlacadh leis go gclúdaíonn fíordheimhniú agus TLS é.

Cad a fhágann go bhfuil API cuntasaíochta "réidh d'iniúchadh"

Ní mór d'iniúchóir a athchruthaíonn idirbheart sraith shonrach ceisteanna a fhreagairt. Cé a thionscain é? Ar tugadh cead dóibh? An rith an t-athrú bailíochtú cuntasaíochta? Cé a cheadaigh é? Cad a thaifead an leabhar mór? An féidir an taifead sin a athrú i ndiaidh an ghnímh gan rian a fhágáil?

Mura féidir le d'API na sé cinn go léir a fhreagairt óna loganna féin agus ónár múnla sonraí, níl sé réidh d'iniúchadh, is cuma cé chomh glan agus a bhíonn an cód. Láimhseálann formhór na n-APIanna an chéad cheist go maith agus an chuid eile go holc.

Titimid na rialuithe a dhúnann an t-achar i roinnt grúpaí: stát cuntasaíochta sainráite, údarú sraitheach, fíordheimhniú scópáilte, scríbhinní dí-fhágacha (idempotent), bailíochtú taobh an fhreastalaí, deighilt dualgas, agus logáil atá frithsheasmhach in aghaidh an tampered. Neartaíonn siad a chéile. Laghdaíonn údarú lag log iniúchta láidir, toisc nach féidir leat a bheith cinnte a thuilleadh go raibh aon ghnó ag an ngníomhaire logáilte an gníomh a dhéanamh.

Múnlaigh stáit cuntasaíochta sula múnlaíonn tú críochphointí

Is é an botún dearaidh is coitianta ná gach taifead airgeadais a chóireáil mar oibiacht inathraithe go saor le create, read, update, delete. Ní oibríonn an chuntasaíocht ar an mbealach sin, agus tabharfaidh iniúchóir faoi deara láithreach má tá iontráil dialainne postáilte in ann a bheith forscríobh go ciúin.

Ní mór meaisín stáit sainráite a bheith ag gach acmhainn ábhartha go hairgeadais. De ghnáth téann iontráil dialainne nó íocaíocht trí:

draft → submitted → approved → posted → settled

Ní chuireann ceartúcháin an cosán sin ar ais. Faigheann iontráil postáilte atá mícheart aischur nasctha nó coigeartú cúitimh. Fanann an ceann bunaidh slán.

Sraith rialacha in-oibrithe:

  • Is féidir dréachtaí a chur in eagar ag úsáideoirí údaraithe.
  • Is féidir taifid curtha isteach a chur in eagar ach amháin ag róil cheadaithe, nó a thabhairt ar ais chuig dréacht.
  • Teastaíonn leasú rialaithe agus ceadú úr ó thaifid cheadaithe.
  • Ní féidir taifid postáilte a fhorscríobh nó a scriosadh, ach a aischur nó a choigeartú.
  • Teastaíonn údarú ardaithe, cúis ráite, agus imeacht iniúchta ó athruithe tréimhse dúnta.

Ba chóir d'iarracht ar aistriú neamhdhleathach, abair eagarthóireacht a dhéanamh ar iontráil postáilte, earráid chobhsaí a thabhairt ar ais agus taifead iniúchta a scríobh fós. Is fianaise í an iarracht mhijas freisin.

Seo mar a thuilleann leabhar mór iontrála dúbailte do-athraithe a áit. Tá leabhar mór Nordlet tógtha sa chaoi is go dtitíonn gach idirbheart mar iontráil chothrom, bhuan, le cothromaíocht curtha i bhfeidhm ag truicear bunachair sonraí ag am an chommitála, agus tarlaíonn ceartúcháin trí aischur seachas athscríobh. Braitheann an srian sin sriantach le linn forbairt agus tiontaíonn sé ina rud a bhfuil muinín ag d'chuntasóir as le linn iniúchta.

Údaraigh gach iarratas, ní hamháin gach fíordheimhniú

Cruthaíonn an fíordheimhniú cé atá ag glaoch. Ní insíonn sé aon rud faoi cé acu an gceadaítear don ghlaoiteoir sin teagmháil a dhéanamh le sonrasc, dialann, nó eintiteas dlíthiúil áirithe. Cuireann an OWASP API Security Project údarú briste ar leibhéal na n-oibiachtaí ag barr a liosta riosca go díreach toisc go nochtann APIanna aitheantais oibiachta a fhágann go bhfuil rochtain tras-tionónta éasca nuair a bhíonn seiceálacha in easnamh.

Ba chóir gach iarratas chuig API airgeadais a údaraíodh in aghaidh cumaisc fachtóirí, ní hamháin chomhartha:

  • gníomhaire fíordheimhnithe
  • feidhmchlár cliant nó cuntas seirbhíse
  • tionónta
  • eintiteas dlíthiúil
  • ID acmhainne
  • oibríocht iarrtha
  • stát reatha na hacmhainne
  • méid nó tairseach idirbhirt

Is mó a bhaineann dhá rialach phraiticiúla ná an chuid eile. Ar an gcéad dul síos, díorthaigh comhthéacs tionónta agus úsáideora ón bhféiniúlacht fhíordheimhnithe, agus diúltaigh d'aon éileamh tionónta nó ról soláthraithe ag an gcliant a thagann salach air sin. Níor cheart go mbeadh cead ag glaoiteoir riamh a chruthú cén chuideachta a bhfuil siad ag gníomhú ar a son. Ar an dara dul síos, úsáid diúltú-de-réir-réamhshocrú. Mura gcuireann aon pholasaí gníomh in iúl go sainiúil, teipeann air.

Tástáil an dá threo. Rochtain chothrománach, áit a sroicheann tionónta amháin sonraí tionónta eile, agus rochtain ingearach, áit a sroicheann úsáideoir gnáth feidhmeanna ceadaithe, postála, nó easpórtála. Tá an dá cheann coitianta agus is tubaisteach an dá cheann i sonraí cuntasaíochta.

Tá rólmhúnla Nordlet, le róil úinéara, riaracháin, cuntasóra, bainisteora, forbróra, agus amharcóra thar chuideachtaí iolracha faoi chuntas amháin, ann chun an deighilt seo a dhéanamh infheidhmithe seachas mianta. Níor cheart go mbeadh ról forbróra atá in ann dréacht-sonrasc a chruthú in ann íocaíochtaí a scaoileadh.

Scópáil comharthaí chuig cumais ghnó, ní chuig briathra CRUD

I gcás rochtana tarmligthe, úsáid treoir shlándála reatha OAuth 2.0 seachas pasfhocail ath-inúsáidte nó eochracha API statacha leathana. Is í RFC 9700 an Chleachtas Reatha is Fearr agus leagann sí amach riachtanais shoiléire do chliaint agus d'fhreastalaí údaraithe: URIanna athsheolta bailíochtaithe, PKCE nuair is infheidhme, seiceálacha eisiúna agus lucht féachana, saolréanna gairid comharthaí rochtana, agus rothlú comharthaí athnuachana le revocation.

Is ansin a thaispeánann an smaointeoireacht shonrach don chuntasaíocht an cinneadh scópála. Tá scóip ghinearálta mar read agus write gar do bheith gan úsáid chun dualgais a deighilt. Ba chóir go mapáilfeadh scóip chuig cumais:

  • Is scóip ar leith iad journal:create agus journal:approve.
  • Ní thugann cruthú treorach íocaíochta cead chun í a scaoileadh.
  • Tá cead easpórtála ar leith ón gcead léite, toisc gur cosán sceite sonraí é an t-easpórtáil mórchóir.

Bí beacht faoin áit a suíonn táirge ar an scála sin. Tá scóip in aghaidh an mhodúil ag eochracha API Nordlet mar sales:read agus sales:write, seiceáilte ar gach gníomh, rud a scarann modúil agus léamh ó scríobh ach ní cruthú ó cheadú; nuair a bhíonn an scoilteadh níos mine sin ag teastáil uait inniu, cuir i bhfeidhm é i do sheirbhís féin roimh an nglao.

I gcás oibríochtaí ardluacha, is fiú a mheas an mbaineann an FAPI 2.0 Security Profile leis. Dearadh é d'APIanna a chosain sonraí airgeadais íogaire agus tairgeann sé ráthaíochtaí níos láidre ná bonnlíne OAuth. Ní bheidh an próifíl iomlán de dhíth ar fhormhór na n-imeascadh cuntasaíochta SMB, ach is iad scaoileadh íocaíochta agus sreabhadh nasc bainc na háiteanna le é a mheas.

Baineann síniú isteach gan phasfhocal Nordlet trí naisc ríomhphoist aon-uaire an fhadhb pasfhocail ath-inúsáidte d'úsáideoirí daonna, rud atá ina chreidiúint amháin níos lú le rothlú, le scaoileadh, nó le fioscaireacht.

Déan scríbhinní airgeadais dí-fhágach

Teipeann ar líonraí i lár iarratais. Cuireann cliant treoir íocaíochta, titeann an nasc sula dtiocfaidh an freagra, agus déanann an cliant iarracht arís. Gan chosaint, tá dá íocaíocht agat anois.

Réitíonn eochracha dí-fhágachta (idempotency keys) seo. Cuireann an cliant eochair uathúil le gach scríobh; taifeadann an freastalaí an eochair agus a toradh. Tugann iarracht arís leis an eochair chéanna an toradh bunaidh ar ais seachas an dara hiontráil a chruthú. Glacann Nordlet le ceanntásc Idempotency-Key ar gach gníomh mutáitithe, ag athsheinm an fhreagra stóráilte ar iarracht arís leis an bpalaid chéanna agus ag diúltú don eochair chéanna le palaid athraithe, agus tabharfaidh aon API cuntasaíochta a shipeálann an ghné seo iontrálacha leabhair mhóir dúblacha ar deireadh a chaithfidh duine éigin a réiteach de láimh.

Péireáil seo le bailíochtú taobh an fhreastalaí. Ná cuir muinín sa chliant riamh chun a sheiceáil go bhfuil dochair cothrom le creidmheasanna, go bhfuil ráta CBL bailíochta don tír agus don tréimhse, nó go bhfuil cuntas ann. Ritheann bailíochtú ar an bhfreastalaí, roimh an aistriú stáit, agus táirgeann scríobh dhiúltaithe earráid chobhsaí agus taifead iniúchta.

Loganna iniúchta frithsheasmhach in aghaidh an tampered agus coinneáil san Ísiltír

Is é an log iniúchta an ciseal fianaise, agus tá riachtanais éagsúla aige ó shonraí gnáthghhnó. Ba chóir dó cinneadh an údaráis, leagan an pholasaí, an gníomhaire, an oibiacht, an oibríocht, an stát roimhe seo agus nua, agus an cód cúise a thaifeadadh, gan rúin nó dintiúir íocaíochta iomlána a thaifeadadh riamh.

An mhaoin ríthábhachtach ná frithsheasmhacht in aghaidh an tampered. Más féidir le riarthóir taifid iniúchta a chur in eagar nó a scriosadh go ciúin, ní chruthúníonn an log aon rud. Tugann stóráil chloí amháin (append-only), slabhraithe criptiúcháin, nó coinneáil scríobh-amháin aghaidh air seo go léir. Is é an pointe gur chóir go mbeadh modhnú inbhraite.

Tuilleann coinneáil a pholasaí féin, ar leith ó scriosadh taifid ghnó. San Ísiltír, is é seacht mbliana an tréimhse choinneála ghinearálta do thaifid riaracháin, agus do thaifid a bhaineann le maoin dhochorraithe sroicheann sé deich mbliana. Níor cheart go mbeadh cead ag d'oibríochtaí gnáthscriosta sonraí agus scriosta GDPR taifid nó fianaise iniúchta a shárú a gclúdaíonn rialachán coinneála dlíthiúil fós iad. Sainmhínigh coinneáil dhlíthiúil, cartlannú, agus rialacha scriosta le haghaidh fianaise iniúchta go neamhspleách, agus mapáil iad chuig na dlínsí ina n-oibríonn tú.

Tacaíonn glasáil tréimhse leis seo ag an gciseal cuntasaíochta. Nuair a bhíonn mí dúnta, ní féidir iontrálacha ann a athrú gan údarú ardaithe agus cúis logáilte. Cuireann Nordlet glasáil tréimhse i bhfeidhm ionas go bhfanann míonna dúnta dúnta, ag diúltú d'aon phostáil dátaithe laistigh de thréimhse ghlasáilte fiú tríd an API, rud atá ar cheann de na chéad rud a sheiceálann iniúchóir ón Ísiltír.

Slánaigh na himeall-línte: webhookanna, easpórtálacha, agus imeascadh

De ghnáth is é an croí-API an chuid is fearr a chosaint den chóras. Sceitheann na himeall-línte.

Riosca iarratais bhréagaithe iad webhookanna. Ba chóir eachtra mar sale_invoice.paid a shíniú ionas gur féidir leis an nglacadóir a fhíorú gur tháinig sé uait, agus ba chóir do ghlacadóirí seachadadh a chóireáil mar ag-laghad-uair amháin agus ID an eachtra a úsáid le haghaidh dí-dúblála. Síníonn Nordlet gach seachadadh webhook le síniú HMAC thar an gcolainn amh agus déanann sé iarracht arís ar sheachadadh a theip le cúiteamh easpóna 그렇게, mar sin caithfidh glacadóir an síniú a fhíorú agus dí-dúbláil a dhéanamh de réir ID eachtra seachas glacadh le seachadadh díreach uair amháin.

Is cosán sceite sonraí mórchóir iad easpórtálacha. Tarraingíonn easpórtálacha tuairisce i XLSX, PDF, nó JSON méideanna móra sonraí airgeadais in oibríocht amháin, mar sin teastaíonn a gcead féin, teorainneacha ráta, agus logáil iniúchta uathu. Ba chóir déileáil le himeascadh tríú páirtí a chaitear mar ionchur neamhiontaofa, bailíochtaithe ar an mbealach céanna a bhailíochtaíonn tú iarratais dhíreacha cliant.

Seicliosta réide d'iniúchadh do API cuntasaíochta san Ísiltír

Úsáid é seo sula n-éilíonn tú go bhfuil imeascadh réidh d'iniúchadh:

  • Meaisín stáit sainráite ar gach acmhainn airgeadais; ní féidir iontrálacha postáilte a fhorscríobh
  • Údarú ar leibhéal na n-oibiachtaí agus an eintitis dlíthiúil ar gach iarratas, diúltú-de-réir-réamhshocrú
  • Comhthéacs tionónta agus róil díorthaithe ón gcomhartha, ní ó éilimh chliaint
  • OAuth 2.0 de réir RFC 9700; scóip bunaithe ar chumais; cruthú agus ceadú ar leith
  • Deighilt dualgas curtha i bhfeidhm i róil, ní hamháin doiciméadaithe
  • Eochracha dí-fhágachta ar gach scríobh airgeadais
  • Bailíochtú cuntasaíochta agus CBL taobh an fhreastalaí roimh aistriú stáit
  • Log iniúchta cloí amháin, frithsheasmhach in aghaidh an tampered le cóid chúise
  • Rialacha coinneála agus coinnála dlíthiúla mapáilte chuig tréimhsí na hÍsiltíre (seacht mbliana, deich gcinn don mhaoin)
  • Glasáil tréimhse ar mhíonna dúnta
  • Webhookanna sínithe le dí-dúbláil; easpórtálacha scópáilte, teoranta ráta, logáilte

An rud a thógfaimis ar dtús

Dá mbeimis ag leabú cuntasaíochta i gcuideachta san Ísiltír amárach, thosóimis leis an múnla stáit agus an t-údarú ar leibhéal na n-oibiachtaí, sula scríobhfaimis críochphointe gnó amháin. Cuireann an dá chinneadh sin srian ar gach rud thíos, agus tá athfheistiú orthu i gcóras a chaith le hiontrálacha leabhair mhóir mar shraitheanna in-eagarthóireachta fíor-phianmhar. Tagann dí-fhágacht agus an log iniúchta ina dhiaidh sin, toisc go bhfuil siad saor le cur leis go luath agus costasach le cur leis tar éis do shonraí a bheith ag sreabhadh.

Leanann an chuid eile - comharthaí scópáilte, webhookanna sínithe, glasáil tréimhse - níos éasca nuair a choinníonn an bonn. Is féidir gach ceann acu a chleachtadh in aghaidh cuideachta bosca aischuir sula dteagmhaíonn aon cheann acu le sonraí táirgthe.

FAQ

An ciallaíonn API réidh d'iniúchadh go bhfuil an gnó comhlíontach?

Ní hionann, agus is fiú a bheith beacht faoi seo. Is maoin dearaidh den chóras í an réide d'iniúchadh: tá an leabhar mór, na rialuithe, agus an slabhra fianaise tógtha sa chaoi is gur féidir le hiniúchadh éirí leis. Is measúnú neamhspleách é comhlíonadh le creat sonrach cánach, cuntasaíochta, nó slándála a mapálann na rialuithe sin chuig caighdeán ainmnithe. Déanann API atá tógtha go maith obair chomhlíonta níos éasca; ní chuireann sé áit uirthi.

Cé chomh fada a chaithfear taifid cuntasaíochta a choinneáil san Ísiltír?

Is é seacht mbliana an oibleagáid ginearálta do thaifid riaracháin, ag sínte go deich mbliana do thaifid atá ceangailte le maoin dhochorraithe. Tóg rialacha coinneála agus coinnála dlíthiúla nach féidir le d'oibríochtaí gnáthscriosta a shárú.

An leor eochair API statach d'imeascadh airgeadais?

I gcás uathoibrithe freastalaí go freastalaí le scóp cúng is féidir leis oibriú, ach tá eochracha statacha ath-inúsáidte deacair le rothlú agus contúirteach nuair a sceitear iad. I gcás rochtana tarmligthe agus d'aon sreabhadh daonna, is é OAuth 2.0 le comharthaí gairid-saolré, scópáilte de réir cumais an rogha is láidre.

Cén fáth a bhfuil tábhacht mhór ag baint le dí-fhágacht don chuntasaíocht go sonrach?

Toisc gur trioblóid é scríobh dúblach i bhformhór na gcóras, agus is uimhir mhícheart í scríobh dúblach sa chuntasaíocht sna leabhair a chaithfidh duine éigin a aimsiú agus a aischur. Déanann eochracha dí-fhágachta iarrachtaí arís sábháilte seachas contúirteach.

Léamh breise