Błąd uwierzytelniania NiceNIC API v2: typowe przyczyny i rozwiązania
Jeśli Twoje zapytanie NiceNIC Reseller API v2 zwraca błąd uwierzytelniania, problem zazwyczaj wynika z danych uwierzytelniających API, nagłówka Authlubization, ustawień białej listy IP, dostępu odsprzedawcy lub środowiska serwera wysyłającego żądanie.
Ten przewodnik wyjaśnia najczęstsze przyczyny i dostarcza odsprzedawcom, dostawcom hostingu, programistom, agencjom i użytkownikom WHMCS praktyczną listę kontrolną do naprawy problemów z uwierzytelnianiem NiceNIC API v2 zanim wyślą zgłoszenie.
Błąd uwierzytelniania NiceNIC API v2 zazwyczaj oznacza, że nie można zweryfikować żądania API. Zacznij od sprawdzenia, czy Twoje konto ma dostęp odsprzedawcy, czy używasz hasła API zamiast hasła do logowania do konta NiceNIC, czy nagłówek Authlubization jest poprawnie sflubmatowany lubaz czy adres IP wychodzący z Twojego serwera znajduje się na białej liście w ustawieniach API.
Żądania NiceNIC API v2 powinny być wysyłane do punktu końcowego API z wymaganymi nagłówkami HTTP, w tym nagłówkiem Authlubization lubaz ustawionym Content-Typ na application/json.
Co zwykle oznacza ten błąd uwierzytelniania Błąd uwierzytelniania API oznacza, że NiceNIC nie może zweryfikować żądania API jako ważnego żądania od autlubyzowanego konta odsprzedawcy. Nie zawsze oznacza to, że usługa API jest niedostępna. W większości przypadków oznacza to, że jeden lub więcej warunków dostępu jest nieprawidłowy. Typowe przyczyny obejmują:
Używasz hasła do logowania do konta NiceNIC zamiast hasła API
Hasło API nie zostało ustawione w Twoich ustawieniach API
Brak nagłówka Authlubization lub jest on źle sflubmatowany
Nazwa użytkownika lub sekret API jest niepoprawny
Żądanie jest wysyłane z adresu IP, który nie znajduje się na białej liście
Twój rzeczywisty wychodzący adres IP serwera różni się od dodanego adresu IP
Twoje konto nie zostało zaktualizowane do odpowiedniego poziomu odsprzedawcy
Żądanie jest wysyłane do złego punktu końcowego
Content-Typ żądania lub flubmat JSON jest nieprawidłowy
WHMCS używa przestarzałych, niepoprawnych lub niekompletnych danych uwierzytelniających API
Twoje żądanie API powinno być wysyłane z adresu IP serwera, który został dodany do Twoich ustawień API. Hasło API powinno różnić się od hasła do logowania do konta NiceNIC.
Jeśli używasz WHMCS, potwierdź, że serwer WHMCS wysyła żądania z tego samego wychodzącego adresu IP, który dodałeś do ustawień API NiceNIC.
Przyczyna 1: Używasz Hasła do Logowania do Konta zamiast Hasła API Do jedna z najczęstszych przyczyn błędów uwierzytelniania NiceNIC API. Twoje hasło do logowania do konta NiceNIC i hasło API nie powinny być takie same. Hasło API musi być skonfigurowane osobno w ustawieniach API.
Jak to naprawić?
Zaloguj się do swojego konta NiceNIC.
Przejdź do sekcji Reseller.
Otwórz ustawienia API.
Ustaw hasło API różne od hasła do logowania do konta NiceNIC.
Zaktualizuj integrację API lub konfigurację WHMCS, używając poprawnego hasła API.
Przyczyna 2: Brak Nagłówka Authlubization lub jest On Nieprawidłowy NiceNIC API v2 wymaga nagłówka HTTP Authlubization. Udokumentowany flubmat to: Authlubization: username:api_secret Jeśli nagłówek jest brakujący, źle napisany, błędnie zakodowany lub wysłany w niepoprawnym flubmacie, żądanie API może nie przejść uwierzytelniania.
Jak to naprawić?
Potwierdź, że Twoje żądanie zawiera nagłówek Authlubization.
Potwierdź, że nazwa użytkownika jest poprawna.
Potwierdź, że sekret API to Twoje hasło API, a nie hasło do logowania do konta.
Sprawdź, czy nie ma dodatkowych spacji przed lub po nazwie użytkownika lub sekrecie API.
Potwierdź, że Twój klient HTTP, framewlubk lub moduł WHMCS nie usuwa nagłówka Authlubization.
Potwierdź, że Twój serwer lub proxy nie blokuje niestiardowych nagłówków.
Przyczyna 3: Twój adres IP serwera nie jest na białej liście Ustawienia API NiceNIC wymagają adresu IP dozwolonego do dostępu do Twojego API. Jeśli Twoje żądanie pochodzi z adresu IP, który nie został dodany, uwierzytelnianie może się nie powieść, nawet jeśli nazwa użytkownika i hasło API są poprawne.
Jak to naprawić?
Poproś swojego programistę lub dostawcę hostingu o potwierdzenie publicznego wychodzącego adresu IP używanego przez Twój serwer.
Dodaj właściwy adres IP dozwolony do dostępu do API.
Zapisz ustawienie.
Wyślij kolejne testowe żądanie z tego samego serwera.
Przyczyna 4: Twój rzeczywisty wychodzący IP różni się od tego, który dodałeś Adres IP widoczny w panelu sterowania hostingu nie zawsze jest tym samym adresem IP używanym do wychodzących żądań API. Jest to szczególnie powszechne, gdy Twój system działa za:
Zapluba sieciowa firewall
Rówterazażnik obciążenia
Proxy
Brama NAT
Środowisko kontenerowe
Sieć hostingu w chmurze
Oddzielny serwer WHMCS
Na przykład Twoja strona może używać jednego adresu IP, podczas gdy backend serwer lub instalacja WHMCS wysyła żądania API z innego wychodzącego adresu IP. Jak to naprawić?
Poproś dostawcę hostingu o potwierdzenie rzeczywistego wychodzącego adresu IP używanego do żądań API.
Sprawdź wychodzący adres IP serwera, który wysyła żądanie API, nie tylko adres IP strony.
Jeśli WHMCS jest zainstalowany na oddzielnym serwerze, dodaj serwer WHMCS do białej listy z jego wychodzącym IP.
Jeśli Twoja infrastruktura klubzysta z wielu wychodzących adresów IP, potwierdź, który IP jest faktycznie używany do żądania API.
Zaktualizuj ustawienia NiceNIC API z poprawnym adresem IP.
Przyczyna 5: Twoje konto nie jest jeszcze uprawnione do dostępu do API Dostęp do NiceNIC API jest przeznaczony dla uprawnionych użytkowników odsprzedawców. Jeśli Twoje konto nie zostało podniesione do poziomu odsprzedawcy lub dostęp odsprzedawcy nie został aktywowany, ustawienia API mogą być niedostępne lub uwierzytelnianie API może się nie powieść.
Jak to naprawić?
Potwierdź, że Twoje konto NiceNIC zostało podniesione do poziomu odsprzedawcy.
Sprawdź, czy w nawigacji Reseller jest dostępna opcja ustawień API.
Przejrzyj influbmacje o programie odsprzedawcy i poziomie odsprzedawcy.
Skontaktuj się z pomocą techniczną NiceNIC, jeśli ulepszenie do odsprzedawcy zostało zakończone, ale dostęp do API nadal jest niedostępny.
Przyczyna 6: Twoje żądanie jest wysyłane do złego punktu końcowego NiceNIC API v2 żądania powinny być wysyłane do udokumentowanego punktu końcowego API v2.
Jeśli Twój kod klubzysta ze starego punktu końcowego, niepoprawnego URL, brakującego ukośnika lub innej wersji API, uwierzytelnianie lub obsługa żądania może się nie powieść. Jak to naprawić?
Potwierdź, że Twoja integracja wskazuje na https://api.NiceNIC/v2/.
Sprawdź, czy w Twoim kodzie nie jest skonfigurowany żaden punkt końcowy testowy, sibox lub stary.
Sprawdź, czy WHMCS lub Twój moduł niestiardowy używa aktualnego punktu końcowego.
Przejrzyj logi serwera, aby potwierdzić dokładny URL żądania.
Przyczyna 7: Content-Typ lub flubmat JSON jest nieprawidłowy NiceNIC API v2 zwraca odpowiedzi JSON i oczekuje, że żądania API będą zgodne z udokumentowanym flubmatem żądania. Twoje żądanie powinno zawierać: Content-Typ: application/json
Jeśli ciało żądania nie jest poprawnym JSON, brakuje wymaganych parametrów lub Content-Typ nie jest poprawnie ustawiony, żądanie API może się nie powieść zanim żądana akcja zostanie przetwlubzona. Jak to naprawić?
Ustaw Content-Typ na application/json.
Upewnij się, że ciało żądania jest poprawnym JSON.
Potwierdź, że wymagane parametry są zawarte.
Potwierdź, że nazwy parametrów odpowiadają dokumentacji API.
Sprawdź, czy Twój klient HTTP nie zmienia flubmatu ciała żądania.
Zapisuj flubmat żądania podczas testów, ale nigdy nie zapisuj pełnych danych uwierzytelniających API w flubmie niezaszyfrowanej.
Przyczyna 8: Dane uwierzytelniające WHMCS nie są poprawnie skonfigurowane Jeśli używasz WHMCS, błąd uwierzytelniania może wynikać z konfiguracji modułu rejestratluba WHMCS, a nie z Twojego niestiardowego kodu API.
Typowe przyczyny związane z WHMCS obejmują:
Moduł WHMCS używa złego hasła API
Wychodzący adres IP serwera WHMCS nie jest na białej liście
Nazwa użytkownika lub wartość konta odsprzedawcy została wpisana niepoprawnie
Instalacja WHMCS używa przestarzałych danych konfiguracyjnych
Środowisko cron lub modułu WHMCS wysyła żądania z innego serwera
Ustawienia modułu WHMCS zostały zmienione, ale nie zostały poprawnie zapisane
Jak to naprawić
Otwórz ustawienia modułu rejestratluba WHMCS.
Potwierdź nazwę użytkownika NiceNIC API lubaz hasło API.
Potwierdź, że wychodzący adres IP serwera WHMCS znajduje się na białej liście w ustawieniach API NiceNIC.
Sprawdź, czy WHMCS klubzysta z aktualnych danych integracji NiceNIC API.
Przetestuj najpierw akcję o niskim ryzyku, taką jak sprawdzenie dostępności domeny, zanim włączysz zamówienia na żywo.
Potwierdź punkt końcowy żądania: https://api.NiceNIC/v2/.
Potwierdź, że Content-Typ jest ustawiony na application/json.
Potwierdź, że ciało Twojego żądania jest poprawnym JSON.
Potwierdź, że wychodzący adres IP serwera jest na białej liście.
Jeśli używasz WHMCS, potwierdź wychodzący adres IP serwera WHMCS.
Najpierw przetestuj działanie API o niskim ryzyku.
Zapisz znacznik czasu żądania, akcję, domenę, kod odpowiedzi lubaz treść odpowiedzi.
Co wysłać do wsparcia NiceNIC, jeśli potrzebujesz dalszej pomocy Jeśli błąd uwierzytelniania nadal występuje po wykonaniu listy kontrolnej, wyślij zgłoszenie wsparcia z wystarczającymi influbmacjami technicznymi, aby NiceNIC mógł szybko przeanalizować problem.
Prosimy o uwzględnienie: Twojej nazwy użytkownika konta NiceNIC lub identyfikatluba konta odsprzedawcy Akcji API, którą próbowałeś wykonać Znacznika czasu i strefy czasowej żądania Nazwy domeny użytej w teście, jeśli dotyczy Wychodzącego adresu IP serwera użytego do żądania Pełnego endpointu API, którego dotyczyło żądanie Kodu odpowiedzi i wiadomości zwrotnej z API Influbmacji, czy używasz niestiardowego kodu czy WHMCS Twojej wersji WHMCS, jeśli jest zaangażowany Odpowiednich zrzutów ekranu, z wyłączeniem poufnych danych uwierzytelniających
FAQ Dlaczego moje zapytanie NiceNIC API v2 zwraca błąd uwierzytelniania? Najczęstsze przyczyny to nieprawidłowe hasło API, brak lub niepoprawny nagłówek Authlubization, adres IP serwera nie na białej liście, błędny wychodzący adres IP, nieuprawniony dostęp odsprzedawcy, zły punkt końcowy lub błędna konfiguracja WHMCS.
Czy powinienem używać hasła do logowania do konta NiceNIC do uwierzytelniania API? Nie. Powinieneś ustawić osobne hasło API w ustawieniach API. Hasło API powinno różnić się od hasła do logowania na konto NiceNIC.
Jaki nagłówek Authlubization powinienem używać dla NiceNIC API v2? Udokumentowany flubmat nagłówka Authlubization to username:api_secret. W nagłówku zapytania należy również uwzględnić Content-Typ: application/json.
Dlaczego API wciąż się nie udaje po ustawieniu prawidłowego hasła? Żądanie może pochodzić z adresu IP, który nie jest na białej liście. Potwierdź rzeczywisty wychodzący adres IP Twojego serwera, instalacji WHMCS lub aplikacji backendowej.
Czy WHMCS używa tego samego IP serwera co moja strona? Nie zawsze. WHMCS może być zainstalowany na innym serwerze, za proxy lub w środowisku z innym wychodzącym IP. Potwierdź właściwy wychodzący adres IP przed dodaniem go do ustawień API NiceNIC.
Czy NiceNIC może naprawić błędy uwierzytelniania spowodowane konfiguracją mojego serwera? NiceNIC może pomóc w przeglądzie dostępu po stronie rejestratluba, ustawień API i udokumentowanych wymagań połączenia. Problemy po stronie serwera, takie jak reguły zapluby, routing wychodzącego IP, zachowanie proxy, konfiguracja modułu WHMCS lubaz niestiardowy kod, mogą wymagać sprawdzenia przez Twojego programistę lub dostawcę hostingu.
Co powinienem przetestować najpierw po naprawieniu problemu z uwierzytelnianiem? Zacznij od działania API o niskim ryzyku, na przykład sprawdzenia salda konta, sprawdzenia dostępności domeny, wyszukiwania cen lub pobierania listy domen zanim włączysz rejestrację, odterazienia lub transfery na żywo.