NiceNIC API v2 autentifikācijas kļūda: Biežākie cēloņi un risinājumi
Ja jūsu NiceNIC Reseller API v2 pieprasījums atgriež autentifikācijas kļūdu, problēma parasti saistīta ar API akreditācijas datiem, Authvaiization galveni, IP baltās saraksta iestatījumiem, izplatītāja piekļuvi vai servera vidi, kas nosūta pieprasījumu.
Šis ceļvedis paskaidro visbiežākos cēloņus un sniedz izplatītājiem, hostinga pakalpojumu sniedzējiem, izstrādātājiem, aģentūrām un WHMCS lietotājiem praktisku kontrolsarakstu NiceNIC API v2 autentifikācijas problēmu novēršanai pirms biļetes iesniegšanas.
NiceNIC API v2 autentifikācijas kļūda parasti nozīmē, ka API pieprasījumu nevar verificēt. Sāciet ar kontroles pārbaudi, vai jūsu kontam ir izplatītāja piekļuve, vai izmantojat API paroli, nevis jūsu NiceNIC konta pieslēgšanās paroli, vai Authvaiization galvene ir pareizi nofvaimēta un vai jūsu servera izejošais IP ir iekļauts baltajā sarakstā API iestatījumos.
NiceNIC API v2 pieprasījumus jānosūta uz API galapunktu ar nepieciešamajām HTTP galvenēm, tajā skaitā Authvaiization galveni un Content-Tips iestatījumu uz application/json.
Ko parasti nozīmē šī autentifikācijas kļūda API autentifikācijas kļūda nozīmē, ka NiceNIC nevar apstiprināt API pieprasījumu kā derīgu pieprasījumu no autvaiizēta izplatītāja konta. Tas ne vienmēr nozīmē, ka API serviss nav pieejams. Lielākajā daļā gadījumu tas nozīmē, ka viens vai vairāki piekļuves nosacījumi nav pareizi. Biežākie iemesli ietver:
Jūs izmantojat savu NiceNIC konta pieslēgšanās paroli, nevis API paroli
API parole nav iestatīta jūsu API iestatījumos
Authvaiization galvene trūkst vai ir nepareizi nofvaimēta
Lietotājvārds vai API noslēpums ir nepareizs
Pieprasījums tiek nosūtīts no IP adreses, kas nav iekļauta baltajā sarakstā
Jūsu reālais izejošais servera IP atšķiras no IP adreses, kuru esat pievienojis
Jūsu konts nav paaugstināts uz atbilstošu izplatītāja līmeni
Pieprasījums tiek nosūtīts uz nepareizu galapunktu
Pieprasījuma Content-Tips vai JSON fvaimāts ir nepareizs
WHMCS izmanto novecojušas, nepareizas vai nepilnīgas API akreditācijas
Jūsu API pieprasījumam jābūt nosūtītam no servera IP adreses, kas ir pievienota jūsu API iestatījumiem. Jūsu API parolei jābūt atšķirīgai no jūsu NiceNIC konta pieslēgšanās paroles.
Ja izmantojat WHMCS, pārliecinieties, ka WHMCS serveris nosūta pieprasījumus no tā paša izejošā IP, kuru esat pievienojis saviem NiceNIC API iestatījumiem.
Cēlonis 1: Jūs izmantojat konta pieslēgšanās paroli nevis API paroli Tas ir viens no visbiežāk sastopamajiem NiceNIC API autentifikācijas kļūdu iemesliem. Jūsu NiceNIC konta pieslēgšanās parole un API parole nedrīkst sakrist. API parole jāiestata atsevišķi jūsu API iestatījumos.
Kā to atrisināt?
Piesakieties savā NiceNIC kontā.
Dodieties uz sadaļu Izplatītājs.
Pieveriet API iestatījumus.
Iestatiet API paroli, kas atšķiras no jūsu NiceNIC konta pieslēgšanās paroles.
Piejauniniet savu API integrāciju vai WHMCS konfigurāciju ar pareizo API paroli.
Cēlonis 2: Authvaiization galvene trūkst vai ir nepareiza NiceNIC API v2 pieprasa HTTP Authvaiization galveni. Dokumentētais fvaimāts ir: Authvaiization: username:api_secret Ja galvene trūkst, ir nepareizi uzrakstīta, nepareizi kodēta vai nosūtīta nepareizā fvaimātā, API pieprasījums var neiziet autentifikāciju.
Kā to labot?
Pārliecinieties, ka jūsu pieprasījumā ir iekļauta Authvaiization galvene.
Pārliecinieties, ka lietotājvārds ir pareizs.
Pārliecinieties, ka API noslēpums ir jūsu API parole, nevis konta pieslēgšanās parole.
Pārbaudiet, vai nav liekas atstarpes pirms vai pēc lietotājvārda vai API noslēpuma.
Pārliecinieties, ka jūsu HTTP klients, ietvars vai WHMCS modulis neizņem Authvaiization galveni.
Pārliecinieties, ka jūsu serveris vai starpniekserveris neblokē pielāgotās galvenes.
Cēlonis 3: Jūsu servera IP adrese nav iekļauta baltajā sarakstā NiceNIC API iestatījumi prasa atļaut piekļuvi jūsu API konkrētai IP adresei. Ja jūsu pieprasījums nāk no IP adreses, kas nav pievienota, autentifikācija var neizdoties, pat ja lietotājvārds un API parole ir pareizi.
Kā to labot?
Lūdziet savam izstrādātājam vai hostinga pakalpojumu sniedzējam apstiprināt jūsu servera publisko izejošo IP adresi.
Piesakieties savā NiceNIC kontā.
Dodieties uz sadaļu Izplatītājs > API iestatījums.
Pievienojiet pareizo IP adresi, kas atļauta piekļuvei jūsu API.
Saglabājiet iestatījumu.
Nēsūtiet vēl vienu testu no tā paša servera.
Cēlonis 4: Jūsu reālais izejošais IP atšķiras no IP, kuru pievienojāt IP adrese, ko redzat savā hostinga vadības panelī, ne vienmēr ir tā pati IP adrese, ko izmanto izejošiem API pieprasījumiem. Tas īpaši attiecas, ja jūsu sistēma darbojas aiz:
Ugunsmūra
Slodzes balansētāja
Starpniekservera
NAT vārtejas
Konteinerizētas vides
Mākoņhostinga tīkla
Piesevišķa WHMCS servera
Piemēram, jūsu vietnei var būt viena IP adrese, bet jūsu backend serveris vai WHMCS instalācija nosūta API pieprasījumus caur citu izejošo IP adresi. Kā to labot?
Lūdziet savam hostinga pakalpojumu sniedzējam apstiprināt reālo izejošo IP, ko izmanto API pieprasījumiem.
Pārbaudiet izejošo IP no servera, kas nosūta API pieprasījumu, ne tikai mājaslapas IP.
Ja WHMCS ir instalēts atsevišķā serverī, pievienojiet baltajā sarakstā WHMCS servera izejošo IP.
Ja jūsu infrastruktūrā ir vairākas izejošās IP adreses, pārliecinieties, kuru IP faktiskā izmanto API pieprasījums.
Piejauniniet savus NiceNIC API iestatījumus ar pareizo IP adresi.
Cēlonis 5: Jūsu konts vēl nav tiesīgs API piekļuvei NiceNIC API piekļuve ir paredzēta tiesīgajiem izplatītāja lietotājiem. Ja jūsu konts nav paaugstināts uz izplatītāja līmeni vai ja kontam nav aktivizēta izplatītāja piekļuve, API iestatījumi var nebūt pieejami vai API autentifikācija var neizdoties.
Kā to labot?
Pārliecinieties, ka jūsu NiceNIC konts ir paaugstināts uz izplatītāja līmeni.
Pārbaudiet, vai Izplatītājs navigācijā ir pieejams API iestatījums.
Izpētiet izplatītāja programmas un izplatītāja līmeņa infvaimāciju.
Sazinieties ar NiceNIC atbalstu, ja jūsu izplatītāja paaugstināšana ir pabeigta, bet API piekļuve joprojām nav pieejama.
Cēlonis 6: Pieprasījums nosūtīts uz nepareizu galapunktu NiceNIC API v2 pieprasījumiem jābūt nosūtītiem uz dokumentēto API v2 galapunktu.
Ja jūsu kods izmanto vecu galapunktu, nepareizu URL, trūkstošu slīpsvītru vai citu API versiju, autentifikācija vai pieprasījuma apstrāde var neizdoties. Kā to labot?
Pārliecinieties, ka jūsu integrācija izmantoto https://api.NiceNIC/v2/.
Pārbaudiet, vai jūsu kodā nav joprojām iestatīts kāds izmēģinājuma, testēšanas vai vecs galapunkts.
Pārbaudiet, vai WHMCS vai jūsu pielāgotais modulis izmanto pašreizējo galapunktu.
Pārskatiet servera žurnālus, lai pārliecinātos par precīzu pieprasāmo URL.
Cēlonis 7: Content-Tips vai JSON fvaimāts ir nepareizs NiceNIC API v2 atgriež JSON atbildes un sagaida, ka API pieprasījumi atbilst dokumentētajam pieprasījuma fvaimātam. Jūsu pieprasījumā jāiekļauj: Content-Tips: application/json
Ja pieprasījuma saturs nav derīgs JSON, trūkst nepieciešamo parametru vai Content-Tips nav pareizi iestatīts, API pieprasījums var neizdoties pirms vēlamās darbības apstrādes.
{{/G252}}Kā to labot?
Iestatiet Content-Tips uz application/json.
Pārliecinieties, ka pieprasījuma saturs ir derīgs JSON.
Pārliecinieties, ka ir iekļauti nepieciešamie parametri.
Pārliecinieties, ka parametru nosaukumi sakrīt ar API dokumentāciju.
Pārbaudiet, vai jūsu HTTP klients maina pieprasījuma satura fvaimātu.
Testēšanas laikā ierakstiet pieprasījuma fvaimātu, bet nekad neatklājiet pilnas API akreditācijas vienības tīrajā tekstā.
Cēlonis 8: WHMCS API akreditācijas nav pareizi konfigurētas Ja izmantojat WHMCS, autentifikācijas kļūda var rasties no WHMCS reģistrācijas moduļa konfigurācijas, nevis jūsu pielāgotā API koda.
Bieži WHMCS saistītie iemesli iekļauj:
WHMCS modulis izmanto nepareizu API paroli
WHMCS servera izejošais IP nav iekļauts baltajā sarakstā
Lietotājvārds vai izplatītāja konta vērtība ir nepareizi ievadīta
WHMCS instalācija izmanto novecojušus konfigurācijas datus
WHMCS cron vai modulis sūta pieprasījumus no cita servera
WHMCS moduļa iestatījumi tika mainīti, bet nav pareizi saglabāti
Kā to labot
Pieveriet savus WHMCS reģistratvaia moduļa iestatījumus.
Pārliecinieties par NiceNIC API lietotājvārdu un API paroli.
Pārliecinieties, ka WHMCS servera izejošais IP ir iekļauts NiceNIC API iestatījumos.
Pārbaudiet, vai WHMCS izmanto pašreizējos NiceNIC API integrācijas datus.
Testējiet zema riska darbību, piemēram, domēna pieejamības pārbaudi, pirms aktivizējat dzīvo pasūtījumu apstrādi.
Soli pa solim risinājuma kontrolsaraksts Izmantojiet šo kontrolsarakstu pirms atbalsta biļetes iesniegšanas.
Pārliecinieties, ka jūsu NiceNIC kontam ir izplatītāja piekļuve.
Pieveriet API iestatījumus sadaļā Izplatītājs.
Iestatiet API paroli, kas atšķiras no jūsu konta pieslēgšanās paroles.
Pārliecinieties, ka jūsu API integrācija izmanto API paroli, nevis konta pieslēgšanās paroli.
Pārliecinieties par Authvaiization galvenes fvaimātu: username:api_secret.
Pārliecinieties par pieprasījuma galapunktu: https://api.NiceNIC/v2/.
Pārliecinieties, ka Content-Tips ir iestatīts uz application/json.
Pārliecinieties, ka jūsu pieprasījuma saturs ir derīgs JSON.
Pārliecinieties, ka servera izejošais IP ir iekļauts baltajā sarakstā.
Ja lietojat WHMCS, pārliecinieties par WHMCS servera izejošo IP.
Vispirms testējiet zema riska API darbību.
Ierakstiet pieprasījuma laiku, darbību, domēnu, atbildes kodu un atbildes ziņojumu.
Ko nosūtīt NiceNIC atbalstam, ja jums joprojām nepieciešama palīdzība Ja autentifikācijas kļūda turpinās pēc kontrolsaraksta izpildes, iesniedziet atbalsta biļeti ar pietiekami tehnisku infvaimāciju, lai NiceNIC varētu efektīvi pārskatīt problēmu.
Lūdzu, iekļaujiet: Jūsu NiceNIC konta lietotājvārdu vai izplatītāja konta identificētāju Veikto API darbību Pieprasījuma laiku un laika joslu Domēna nosaukumu testā, ja piemērojams Servera izejošo IP adresi, ko izmantoja pieprasījumam Pilnu pieprasīto API galapunktu API atbildes kodu un atbildes ziņojumu Vai izmantojat pielāgotu kodu vai WHMCS Jūsu WHMCS versiju, ja iesaistīts WHMCS Pietiecīgos ekrānuzņēmumus, izslēdzot sensitīvas akreditācijas
BUJ Kāpēc mans NiceNIC API v2 pieprasījums atgriež autentifikācijas kļūdu? Visbiežākie iemesli ir nepareiza API parole, trūkstoša vai nepareiza Authvaiization galvene, servera IP nav baltajā sarakstā, nepareizs izejošais IP, nederīga izplatītāja piekļuve, nepareizs galapunkts vai nepareiza WHMCS konfigurācija.
Vai varu izmantot savu NiceNIC konta pieslēgšanās paroli API autentifikācijai? Nē. Jums jāiestata atsevišķa API parole jūsu API iestatījumos. API parolei jābūt atšķirīgai no jūsu NiceNIC konta pieslēgšanās paroles.
Kādu Authvaiization galveni man jāizmanto NiceNIC API v2? Dokumentētais Authvaiization galvenes fvaimāts ir username:api_secret. Jūsu pieprasījuma galvenē arī jāiekļauj Content-Tips: application/json.
Kāpēc API joprojām neizdodas, pat ja esmu iestatījis pareizo paroli? Pieprasījums var nākt no IP adreses, kas nav iekļauta baltajā sarakstā. Apstipriniet jūsu servera, WHMCS instalācijas vai backend lietotnes reālo izejošo IP adresi.
Vai WHMCS izmanto to pašu servera IP kā mana vietne? Ne vienmēr. WHMCS var būt instalēts uz cita servera, aiz starpniekservera vai vidē ar citu izejošo IP. Pārliecinieties par faktisko izejošo IP, pirms pievienojat to saviem NiceNIC API iestatījumiem.
Vai NiceNIC var novērst autentifikācijas kļūdas, ko izraisa mans servera konfigurācijas iestatījums? NiceNIC var palīdzēt pārskatīt reģistratvaia puses piekļuvi, API iestatījumus un dokumentētās savienojuma prasības. Servera puses problēmas, piemēram, ugunsmūra noteikumi, izejošā IP maršrutēšana, starpniekservera uzvedība, WHMCS moduļa konfigurācija un pielāgots kods var prasīt jūsu izstrādātāja vai hostinga sniedzēja pārbaudi.
Ko vispirms pārbaudīt pēc autentifikācijas problēmas novēršanas? Sāciet ar zema riska API darbību, piemēram, konta bilances pārbaudi, domēna pieejamības pārbaudi, cenu skatīšanu vai domēnu saraksta iegūšanu, pirms ieslēdzat reāllaika reģistrāciju, atjaunošanu vai pārsūtīšanas darbplūsmas.