Jak naprawić kody statusu REST 401 i 500?

Problem 1: Użytkownik nie może uzyskać dostępu do REST (kod statusu 401)​

Ten problem jest związany z uwierzytelnianiem. Wskazuje, że użytkownik nie ma uprawnień do dostępu do żądanych zasobów.

Rozwiązanie: Sprawdź uwierzytelnianie​

• Sprawdź Metody uwierzytelniania dla ADONIS lub Metody uwierzytelniania dla ADOIT (Basic, Token itp.). Dla ADOGRC prosimy korzystać z Przewodnika dla ADONIS.
• Podczas korzystania z uwierzytelniania podstawowego (basic authentication), skonfiguruj parametr basicauth_ip_restrictions poprzez określenie adresów IP, które mają prawo wysyłać żądania do REST API używając uwierzytelniania podstawowego. Więcej informacji znajduje się w sekcji „Jak używać ograniczeń IP” w podręczniku administracyjnym. Każdą regułę należy ująć w cudzysłów.
• Ograniczenia obowiązujące przy korzystaniu z uwierzytelniania podstawowego są opisane w BOC Developer Portal w artykule „Basic Authentication”.
• Sprawdź, czy IDM jest włączone. Konieczne są konkretne kroki konfiguracyjne, aby ustawić klienta webowego dla tego mechanizmu uwierzytelniania. Prosimy o kontakt z opiekunem klienta w celu uzyskania instrukcji.

Problem 2: Użytkownik nie może uzyskać dostępu do REST (kod statusu 401) w SaaS​

Korzystasz z produktu BOC, który jest hostowany w chmurze BOC (SaaS). Dostęp do REST środowiska był wcześniej możliwy, ale teraz nie możesz się do niego dostać.

Rozwiązanie: Odblokuj adres IP​

Środowiska hostowane mają dodatkowe ograniczenie dostępu: własną białą listę adresów IP. Zdarza się, że infrastruktura firmy ulega zmianie, a BOC nie jest o tym poinformowane (np. klient wysyłający żądanie ma teraz inny adres IP).

Spróbuj ponownie wykonać żądanie i prześlij znacznik czasu (datę i godzinę) żądania do wsparcia technicznego BOC. Sprawdzimy wtedy, czy Twój adres IP został zablokowany i w razie potrzeby rozszerzymy białą listę adresów IP.

Uwaga: Dostosowania białej listy adresów IP są dokonywane tylko wtedy, gdy żądanie pochodzi od osoby upoważnionej.

Problem 3: Żądania zwracają kod statusu 500 (wewnętrzny błąd serwera).​

Niektóre żądania REST działają poprawnie na kliencie, podczas gdy inne zwracają kod statusu 500 (wewnętrzny błąd serwera).

Rozwiązanie: Dostosuj limit czasu​

Zwykle dzieje się tak w przypadku (ale nie tylko) oprogramowania klienckiego firm trzecich, takiego jak Excel i PowerBI.

Takie aplikacje zazwyczaj mają skonfigurowany jakiś limit czasu, aby zapewnić lepsze doświadczenie użytkownika. Typowa wartość to 100 sekund. Po przekroczeniu limitu czasu aplikacja przerywa operację i zgłasza ogólny „błąd 500”.

Jednak niektóre żądania REST do oprogramowania BOC Management Office mogą trwać znacznie dłużej niż 100 sekund. Konkretna długość zależy od wielu czynników i może się różnić.

Dostosuj wartość limitu czasu w dotkniętym oprogramowaniu klienckim, aby rozwiązać błąd. Może być konieczne wykonanie kilku prób z różnymi wartościami, aż zostanie znalezione odpowiednie ustawienie.