Skip to main content
Ana səhifəBloqBələdçilərTracking API autentifikasiya xətası: 401/403 cavablarının 7 səbəbi və onları necə düzəltmək olar

Tracking API autentifikasiya xətası: 401/403 cavablarının 7 səbəbi və onları necə düzəltmək olar

17TRACK

İzləmə API-si autentifikasiya xətası adətən yeddi səbəbdən biri ilə bağlı olur: çatışmayan etimadnamə, yanlış formatlanmış autentifikasiya başlığı, etibarsız və ya ləğv edilmiş gizli açar, mühit uyğunsuzluğu, kifayət qədər icazənin olmaması, müddəti bitmiş token və ya etibarsız imza, yaxud sorğunu bloklayan təhlükəsizlik qaydası. 401 və ya 403 cavabını düzəltmək üçün əvvəlcə onun hansı sistem tərəfindən qaytarıldığını müəyyən edin, sonra sorğunu provayderin autentifikasiya tələbləri ilə müqayisə edin. Dəyişdirilməmiş etimadnamələrlə təkrar cəhdlər əsas problemi nadir hallarda həll edir.

İzləmə API-si autentifikasiya xətası: 401 və 403 cavablarının 7 səbəbi

Bu təlimat göndəriş izləməsini ecommerce platformasına, sifarişlərin idarə edilməsi sisteminə, anbar tətbiqinə və ya daxili idarə panelinə qoşan tərtibatçılar və inteqrasiya komandaları üçündür. Bütün inteqrasiyada etimadnamələri dəyişdirmək əvəzinə, uğursuz olan bir sorğu ilə başlayın.

Əvvəlcə 401 ilə 403-ü fərqləndirin

HTTP tərifləri tam diaqnoz deyil, başlanğıc nöqtəsidir. 401 Unauthorized sorğuda hədəf resurs üçün etibarlı autentifikasiya etimadnamələrinin olmadığını bildirir. 403 Forbidden serverin sorğunu başa düşdüyünü, lakin onu yerinə yetirməkdən imtina etdiyini bildirir. 403 mütləq autentifikasiyanın uğurlu olduğunu sübut etmir: şlüz və ya təhlükəsizlik xidməti tətbiq etimadnamələri qiymətləndirməzdən əvvəl sorğunu rədd edə bilər.

RFC 9110-a əsasən, 401 cavabı yaradan server WWW-Authenticate sorğusunu daxil etməlidir. Bu başlıq mövcud olduqda onu yoxlayın, lakin cavab məzmununu və provayderin xəta sənədlərini də oxuyun. İmplementasiyalar xətaları həmişə eyni şəkildə göstərmir.

Müşahidə etdiyiniz halƏvvəlcə nəyi araşdırmalı
Çatışmayan və ya etibarsız etimadnamə mesajı ilə 401Etimadnamənin əlavə edilməsi, başlıq formatı və etimadnamənin etibarlılığı
Kifayət qədər icazənin olmadığını bildirən 403Əhatə dairələri, hesab girişi, tenant və resursun sahibliyi
HTML təhlükəsizlik səhifəsi ilə 403Şlüz, proksi, firewall və ya giriş siyasəti
JSON daxilində xəta olduğu halda HTTP uğuruProvayderin tətbiq səviyyəli xəta sahələri

Jurnallarınızda nəqliyyat statusunu və tətbiq statusunu ayrı saxlayın. code adlı JSON sahəsi avtomatik olaraq HTTP statusu deyil və uğurlu HTTP mübadiləsi tələb olunan izləmə əməliyyatının uğurlu olduğu demək deyil.

Təhlükəsiz diaqnostik qeyd yaradın

Hər hansı dəyişiklik etməzdən əvvəl UTC vaxt möhürünü, HTTP metodunu, host adını, yolu, cavab statusunu, provayderin xəta mesajını, sorğu identifikatorunu və yerləşdirmə mühitini qeyd edin. Cavabın izləmə provayderindən, öz backend-inizdən, yoxsa vasitəçi sistemdən gəldiyini də yazın.

Autentifikasiya başlıqlarının adlarını və dəyərlərin mövcud olub-olmadığını qeyd edin, lakin tam API açarlarını, bearer tokenlərini, yeniləmə tokenlərini və imzalama üçün istifadə olunan gizli açarları heç vaxt jurnala yazmayın. Redaktə edilməmiş sorğu izlərini ixrac etməkdən çəkinin. İzləmə nömrələri və göndəriş məlumatları da təşkilatınızın məlumatların idarə edilməsi qaydalarına əsasən redaktə tələb edə bilər.

Problemi yenidən yaratmaq üçün provayder tərəfindən sənədləşdirilmiş, aşağı təsirli əməliyyatdan istifadə edin. Yalnız autentifikasiyanı yoxlamaq üçün göndərişləri təkrar qeydiyyatdan keçirməyin, abunəliklər yaratmayın və ya webhook parametrlərini dəyişdirməyin.

İzləmə API-si 401/403 cavablarının 7 səbəbi

1. Etimadnamə API-yə heç vaxt çatmır

Gizli açar yerləşdirmə konsolunda mövcud ola bilər, lakin işləyən tətbiq üçün əlçatan olmaya bilər. Yayılmış uğursuzluq nöqtələrinə çatışmayan mühit dəyişəni, yanlış gizli açar istinadı, konfiqurasiya dəyişdirildikdən sonra yenidən başladılmamış worker və ya boş dəyərləri buraxan sorğu qurucusu daxildir.

Proksi autentifikasiya başlığını da silə bilər. Yönləndirmələrə diqqət yetirin, çünki HTTP klienti həssas başlıqları başqa hosta ötürməyə bilər.

  • Yoxlayın: Sorğunu son etibarlı çıxış nöqtəsində yoxlayın. Tələb olunan başlığın mövcud olduğunu və boş olmayan dəyər ehtiva etdiyini təsdiqləyin.
  • Düzəldin: Gizli açarın xəritələndirilməsini və ya sorğunun qurulmasını düzəldin, sonra tələb olunarsa təsirlənmiş prosesi yenidən yükləyin.
  • Təsdiqləyin: Eyni əməliyyatı yalnız tərtibatçının noutbukundan deyil, yerləşdirilmiş tətbiq vasitəsilə də icra edin.

Yerli sorğular işləyir, lakin fon tapşırıqları uğursuz olursa, əvvəlcə onların icra zamanı konfiqurasiyalarını müqayisə edin. Tətbiq və onun tapşırıq worker-ləri gizli açarları fərqli mexanizmlərlə ala bilər.

2. Autentifikasiya formatı yanlışdır

İzləmə API-ləri eyni autentifikasiya sxemini qəbul etmir. Provayder xüsusi API açarı başlığı, OAuth bearer tokeni və ya imzalanmış sorğu tələb edə bilər. Endpoint başqa başlıq gözləyirsə, etibarlı açarı Authorization: Bearer daxilində yerləşdirmək kömək etməyəcək.

Digər xətalara gizli açara dırnaq işarələrinin köçürülməsi, provayderin tələb etmədiyi prefiksin əlavə edilməsi, təkrarlanan autentifikasiya başlıqlarının göndərilməsi və ya başqa autentifikasiya metoduna aid SDK konfiqurasiya sahəsindən istifadə daxildir.

  • Yoxlayın: Faktiki sorğunu dəqiq endpoint və API versiyası üçün rəsmi nümunə ilə müqayisə edin.
  • Düzəldin: Sənədləşdirilmiş başlıq adına, dəyər formatına və autentifikasiya sxeminə uyğunlaşdırın. Gizli açarı alternativ olaraq URL-ə yerləşdirməyin.
  • Təsdiqləyin: Etimadnamələri redaktə etməklə minimal sorğunu SDK tərəfindən yaradılan sorğu ilə müqayisə edin.

HTTP semantikasına əsasən başlıq sahələrinin adları böyük-kiçik hərfə həssas deyil. Buna görə yalnız hərflərin registrini dəyişmək adi düzəliş deyil. Düzgün sahəyə, dəyərə və ötürülmə yoluna diqqət yetirin.

3. Açar yanlışdır, ləğv edilib və ya artıq ardıcıl şəkildə yerləşdirilmir

Kopyalanmış açar natamam ola bilər, başqa hesaba aid ola bilər və ya təhlükəsizlik dəyişikliyi zamanı ləğv edilmiş ola bilər. Etimadnamələrin rotasiyası da aralıqlı xətalara səbəb ola bilər: bəzi tətbiq instansiyaları yeni gizli açardan istifadə edərkən digərləri köhnə açarla işləyə bilər.

Hər API açarının avtomatik müddətinin bitdiyini düşünməyin. Müddətin bitməsi və rotasiya qaydaları provayderdən və etimadnamə növündən asılıdır.

  • Yoxlayın: Səlahiyyətli hesab konsolunda etimadnamənin statusunu təsdiqləyin və tətbiqlər, worker-lər və planlaşdırılmış tapşırıqlar üzrə yerləşdirilmiş gizli açar versiyasını müqayisə edin.
  • Düzəldin: Etibarlı etimadnaməni gizli açarların idarə edilməsi prosesiniz vasitəsilə yerləşdirin. Məlumatın ifşa olunduğundan şübhələnirsinizsə, insident prosedurunuza əməl edin və təhlükəyə məruz qalmış etimadnaməni ləğv edin.
  • Təsdiqləyin: Yerləşdirmədən sonra təsirlənmiş hər icra yolunu yoxlayın. Bir uğurlu sorğu bütün instansiyaların yeniləndiyini sübut etmir.

Dəstəkləndiyi halda yerləşdirmələri fərqləndirmək üçün məxfi olmayan etimadnamə identifikatorundan və ya gizli açar menecerinin versiyasından istifadə edin. Müştəridən və ya həmkardan tam açarı dəstək müraciətinə yerləşdirməsini heç vaxt istəməyin.

4. Etimadnamə və endpoint fərqli mühitlərə aiddir

Bəzi xidmətlər istehsal və test etimadnamələrini, regional endpoint-ləri, hesabları və ya tenant-ları ayırır. Etibarlı etimadnamə yanlış hosta və ya hesab kontekstinə təqdim edildikdə uğursuz ola bilər. Bu yoxlama yalnız provayder belə fərqləri sənədləşdirdikdə tətbiq olunur.

Digər ehtimal köhnəlmiş əsas URL-dir. İnteqrasiya autentifikasiya konfiqurasiyası daha yeni API üçün yeniləndiyi halda köhnə endpoint-dən istifadə edə bilər.

  • Yoxlayın: Tam təyinatı nəzərdən keçirin: sxem, host adı, API versiyası, yol və tələb olunan hesab və ya tenant identifikatoru.
  • Düzəldin: Etimadnaməni nəzərdə tutulan mühit və endpoint ilə uyğunlaşdırın. Hər mühitin URL və gizli açar konfiqurasiyasını birlikdə saxlayın.
  • Təsdiqləyin: İşləyən yerləşdirmədə həll edilmiş təyinatı təsdiqləyin və klientin yönləndirmələri izləyib-izləmədiyini yoxlayın.

Həqiqi etimadnamə ilə təxmin edilən hostların siyahısını yoxlamaqdan çəkinin. Yalnız provayder tərəfindən sənədləşdirilmiş endpoint-lərdən istifadə edin.

5. Autentifikasiya uğurludur, lakin icazə kifayət deyil

Etimadnamə çağıranı müəyyən edə, lakin tələb olunan əməliyyata icazə verməyə bilər. Göndəriş hadisələrini oxumaq, izləmə nömrələrini qeydiyyatdan keçirmək, abunəlikləri dəyişdirmək və hesabı idarə etmək fərqli giriş hüquqları tələb edə bilər.

Resursun sahibliyi də vacibdir. Bir iş məkanında görünən göndəriş digəri ilə əlaqəli etimadnamə vasitəsilə əlçatan olmaya bilər. Bəzi sistemlər xəta təfərrüatlarını qəsdən məhdudlaşdırır, buna görə yalnız 403 resursun mövcud olub-olmadığını müəyyən etmir.

  • Yoxlayın: Əhatə dairələrini, rolları, hesaba üzvlüyü, resurs sahibliyini və endpoint-ə xas giriş tələblərini yoxlayın.
  • Düzəldin: İnteqrasiya üçün yalnız tələb olunan icazəni verin və ya düzgün səlahiyyətli hesabdan istifadə edin.
  • Təsdiqləyin: Uğursuz əməliyyatı hesabın idarə etdiyi məlum olan resurs üzərində yoxlayın.

OAuth bearer tokenləri üçün RFC 6750 invalid_token ilə insufficient_scope arasında fərq qoyur. Provayder bu konvensiyaya əməl etdikdə birincisi tokenin etibarlılığına, ikincisi isə avtorizasiyaya işarə edir. Hər izləmə API-sinin OAuth və ya bu xəta sahələrindən istifadə etdiyini düşünməyin.

6. Tokenin müddəti bitib və ya sorğunun imzası etibarsızdır

Vaxtdan asılı autentifikasiya yanlış statik açardan əlavə uğursuzluq halları yaradır. OAuth giriş tokeninin müddəti bitə bilər. İmzalanmış sorğu vaxt möhürü qəbul edilən intervaldan kənarda olduqda və ya server fərqli imza hesabladıqda rədd edilə bilər.

İmza uyğunsuzluğu bir sorğu məzmununun imzalanıb digərinin göndərilməsi, yolun fərqli kodlaşdırılması, sorğu parametrlərinin dəyişdirilməsi və ya yanlış imzalama gizli açarından istifadə nəticəsində yarana bilər. Bu yoxlamalar yalnız imzalanmış sorğuları sənədləşdirən API-lərə aiddir.

  • Yoxlayın: Tokenin müddətini və yeniləmə nəticələrini yoxlayın. İmzalar üçün sənədləşdirilmiş kanonik sorğunu göndərilən dəqiq bayt və sahələrlə müqayisə edin.
  • Düzəldin: Dəstəklənən proses vasitəsilə tokenləri yeniləyin və ya əldə edin, sistem vaxtını sinxronlaşdırın və imzalanan sorğu komponentlərini yekunlaşdırdıqdan sonra imza yaradın.
  • Təsdiqləyin: Yeni token əldə etdikdən dərhal sonra deyil, növbəti token yeniləmə sərhədində də test edin.

Çoxworker-li sistemlərdə token yeniləmələrini əlaqələndirin ki, worker-lər işlək etimadnamələrin üzərinə təkrarən yazmasın və rəqabətli yeniləmə cəhdlərinə səbəb olmasın. Yeniləmə tokenlərini adi sorğu jurnallarından ayrıca qoruyun.

7. Şlüz, firewall və ya şəbəkə siyasəti sorğunu bloklayır

403 izləmə tətbiqindən kənarda da yarana bilər. Mümkün səbəblərə IP icazə siyahısının uyğunsuzluğu, çıxış proksisi siyasəti, veb tətbiq firewall qaydası və ya öz avtorizasiyasını tələb edən giriş şlüzü daxildir.

HTML imtina səhifəsi, tanış olmayan cavab başlığı və ya şlüzə xas sorğu identifikatoru rədd edən təbəqəni müəyyənləşdirməyə kömək edə bilər. Bunlar sübut deyil; şlüz jurnalları və ya provayderin dəstək komandası ilə təsdiqləyin.

  • Yoxlayın: Uğursuz yerləşdirmənin ictimai çıxış IP-sini və şəbəkə marşrutunu işlədiyi məlum olan mühitlə müqayisə edin.
  • Düzəldin: Məsul infrastruktur komandası vasitəsilə müvafiq icazə siyahısını, proksi konfiqurasiyasını və ya dar əhatəli təhlükəsizlik qaydasını düzəldin.
  • Təsdiqləyin: Siyasət dəyişdirildikdən sonra sorğunu ilkin icra mühitindən təkrarlayın.

TLS sertifikatı yoxlamasını söndürməyin və təhlükəsizlik nəzarətlərindən geniş şəkildə yan keçməyin. Brauzer CORS xətalarının da ayrıca diaqnozu lazımdır: rədd edilmiş sorğunun preflight OPTIONS sorğusu, yoxsa faktiki API çağırışı olduğunu yoxlayın. Uzunmüddətli izləmə API-si gizli açarları brauzer kodunda açıqlanmamalıdır.

Xətanı təcrid etmək üçün minimal sorğudan istifadə edin

Uğursuz çağırışı sənədləşdirilmiş endpoint-ə, metoda, tələb olunan autentifikasiyaya və ən kiçik etibarlı məzmuna qədər azaldın. Aşağıdakı, işlək provayderə xas sorğu deyil, ümumi diaqnostik şablondur:

curl --include \
  --request "$DOCUMENTED_METHOD" \
  --url "$DOCUMENTED_ENDPOINT" \
  --header "$DOCUMENTED_AUTH_HEADER: $DOCUMENTED_AUTH_VALUE"

Əməliyyat tələb edirsə, lazımi məzmun tipini və gövdəni əlavə edin. Bundan yalnız nəzarət olunan mühitdə istifadə edin: komanda arqumentləri, terminal yazıları və diaqnostik alətlər gizli açarları ifşa edə bilər. Çıxışını qoruya və redaktə edə bilmirsinizsə, ətraflı izlərdən çəkinin.

Minimal sorğu uğurlu, lakin tətbiq uğursuz olursa, SDK konfiqurasiyasını, başlığın qurulmasını, yönləndirmələri, proksi davranışını və icra zamanı gizli açarlarını yoxlayın. Hər ikisi uğursuz olursa, etimadnamənin etibarlılığını, endpoint seçimini, icazələri və şəbəkə siyasətini araşdırın. Nəticənin səbəbi göstərməsi üçün hər dəfə yalnız bir dəyişəni dəyişdirin.

Yoxlamaların 17TRACK inteqrasiyasına tətbiqi

17TRACK Tracking API inteqrasiyası üçün rəsmi API sənədlərindən başlayın və çağırdığınız əməliyyat üçün autentifikasiya təlimatlarını və sorğu formatını uyğunlaşdırın. Əlaqəsiz API-dən kopyalanmış autentifikasiya nümunəsini tətbiq etməyin və istehlakçı izləmə səhifəsinə girişin API avtorizasiyasını təsdiqlədiyini düşünməyin.

Sənədləşdirilmiş sorğunu serverinizdən çıxan sorğu ilə müqayisə edin, sonra həm HTTP cavabını, həm də sənədləşdirilmiş cavab sahələrini yoxlayın. Eskalasiya zəruridirsə, redaktə edilmiş nümunə, vaxt möhürü, endpoint, cavab təfərrüatları və mövcud olduqda sorğu identifikatoru göndərin. API gizli açarını hesabata daxil etməyin.

Kor-koranə təkrar cəhdləri dayandırın və bərpanı təsdiqləyin

Autentifikasiya xətaları məhdudiyyətsiz təkrar cəhd dövrü deyil, diaqnostika başlatmalıdır. Açıq şəkildə müddəti bitmiş token üçün nəzarətli yeniləmə və məhdud sayda təkrar cəhd uyğun ola bilər. Çatışmayan icazələr, ləğv edilmiş etimadnamələr və ya bloklanmış şəbəkə yolu üçün təkrar cəhdlər konfiqurasiyanı düzəltməyəcək.

Yazma əməliyyatını yenidən icra etməzdən əvvəl provayderin idempotentlik və ya dublikatların idarə edilməsi davranışını yoxlayın. Vasitəçi ilkin nəticəni qeyri-müəyyən etdikdə bu vacibdir.

Bərpa ilkin yerləşdirmədən nəzərdə tutulan əməliyyat uğurla tamamlandıqda, bütün müvafiq worker-lər düzgün konfiqurasiyadan istifadə etdikdə və monitorinq davam edən autentifikasiya xətalarının olmadığını göstərdikdə tamamlanmış sayılır. Etimadnamələri açıqlamadan təsirlənmiş endpoint-i və mühiti müəyyən edən xəbərdarlıqlarla HTTP statusunu və tətbiq səviyyəli xətaları ayrı izləyin.

FAQ

Sorğu niyə yerli mühitdə işləyir, lakin istehsalda uğursuz olur?

Gizli açar versiyalarını, əsas URL-ləri, çıxış proksilərini, çıxış IP-lərini, sistem saatlarını və icra zamanı konfiqurasiyasını müqayisə edin. Yerli uğur bir sorğu yolunun işlədiyini göstərir; istehsalın eyni sorğunu göndərdiyini və ya eyni icazələrə malik olduğunu göstərmir.

Dərhal yeni API açarı yaratmalıyam?

Mövcud etimadnamə etibarsız, ləğv edilmiş və ya potensial olaraq ifşa olunmuş deyilsə, xeyr. Əvvəlcə onun tələb olunan formatda düzgün endpoint-ə çatdığını yoxlayın. Lazımsız rotasiya mövcud açardan asılı olan digər xidmətlərdə xətalara səbəb ola bilər.

Yanlış izləmə nömrəsi 401 və ya 403 yarada bilərmi?

Etibarsız izləmə nömrəsi adətən autentifikasiyanın etibarsız olduğuna sübut deyil, yoxlama və ya resurs səviyyəsində məsələdir. Bununla belə, göndərişə giriş hesab sahibliyi ilə məhdudlaşdırıla bilər. Yalnız nömrəyə əsasən diaqnoz qoymaq əvəzinə provayderin sənədləşdirilmiş xəta təfərrüatlarından istifadə edin.

403 API abunəliyimin müddətinin bitdiyi deməkdir?

Xeyr. Abunəlik və ya hüquq məhdudiyyətləri yalnız provayder bunları sənədləşdirirsə və ya konkret mesaj qaytarırsa mümkün səbəblərdən biridir. İcazələr, hesab konteksti və təhlükəsizlik siyasətləri də rədd edilməyə səbəb ola bilər. Yalnız HTTP statusuna əsasən ödəniş problemi nəticəsinə gəlməyin.

Dəstək müraciətinə nələri daxil etməliyəm?

UTC vaxt möhürünü, metodu, endpoint-i, mühiti, HTTP statusunu, redaktə edilmiş cavab gövdəsini, sorğu identifikatorunu və problemin minimal sorğu ilə təkrarlanıb-təkrarlanmadığını daxil edin. Son yerləşdirmələri və ya etimadnamə dəyişikliklərini təsvir edin. Gizli açarları çıxarın və diaqnostika üçün lazım olmayan göndəriş məlumatlarını redaktə edin.

Mənbələr