نوشته George Curta ·
URL بکاند API رد شد (فهرست مجاز SSRF)
برنامه از ذخیره URL بکاند API خودداری می‌کند، یا درخواست‌ها با خطای URL غیرمجاز شکست می‌خورند.
چرا این اتفاق می‌افتد
هر دو برنامه پیش از هر درخواست، URL بکاند API پیکربندیشده را در برابر یک فهرست مجاز میزبان اعتبارسنجیشده در زمان اجرا (UrlGuard) اعتبارسنجی میکنند. این محافظت SSRF وجود دارد تا یک URL مخرب یا اشتباه پیکربندیشده هرگز نتواند توکن Bearer برنامه را به میزبانی تحت کنترل مهاجم برساند. فقط anonym.legal و anonymize.business (میزبان DEV) مجاز هستند — هر میزبان دیگری عمداً رد میشود.
چگونه رفع کنیم
- 1.دقیقاً از https://anonym.legal (تولید) یا https://anonymize.business (DEV) به‌عنوان URL بکاند API استفاده کنید.
- 2.هرگونه مسیر اضافی، پورت یا اشتباه تایپی را از URL حذف کنید — فهرست مجاز دقیقاً با نام میزبان مطابقت می‌کند.
- 3.اگر فکر می‌کنید یک میزبان معتبر رد میشود، با پشتیبانی تماس بگیرید — فهرست مجاز عمداً توسط کاربر قابل ویرایش نیست.
اعلان "نسخه جدیدی در دسترس است"
تنظیمات مدیریتی برنامه اعلانی نشان می‌دهد که نسخه جدیدتری وجود دارد.
چرا این اتفاق می‌افتد
هر دو برنامه به‌طور دوره‌ای نسخه جدیدتر را بررسی میکنند و در صورت وجود، یک اعلان ساده مدیریتی همراه با لینک به تغییرات نسخه نمایش میدهند. این یک اعلان بهروزرسانی دستی است، نه یک بهروزرسانی خودکار — هیچ‌چیز به‌خودی‌خود روی نمونه Nextcloud شما نصب نمیشود.
چگونه رفع کنیم
- 1.لینک تغییرات نسخه در اعلان را دنبال کنید تا ببینید چه چیزی تغییر کرده است.
- 2.بایگانی برنامه جدید را از صفحه GitHub releases دانلود کنید.
- 3.در apps/ استخراج کنید و occ upgrade را اجرا کنید — همان مراحل نصب دستی نصب اولیه — در زمان دلخواه خود.
خطای ۴۰۳: "پلن Basic یا بالاتر"
فراخوانی‌های API از برنامه با وضعیت ۴۰۳ و پیامی درباره نیاز به پلن Basic یا بالاتر شکست می‌خورند.
چرا این اتفاق می‌افتد
هر دو برنامه Nextcloud نیازمند حساب anonym.legal با پلن Basic یا بالاتر هستند. پلن رایگان شامل دسترسی API که این برنامهها به آن وابستهاند نمیشود، بنابراین بکاند به‌جای شکست بی‌صدا، ۴۰۳ را همراه با پیام "Nextcloud integration requires Basic plan or higher. Please upgrade your plan." بازمی‌گرداند.
چگونه رفع کنیم
- 1.تأیید کنید توکن پیکربندیشده متعلق به کدام حساب anonym.legal است.
- 2.آن حساب را به پلن Basic یا بالاتر ارتقا دهید.
- 3.درخواست را دوباره امتحان کنید — پس از ارتقای حساب، نیازی به نصب مجدد یا پیکربندی مجدد نیست.
توکن یکپارچهسازی نمیتواند کلیدهای رمزگذاری را بخواند — این یک باگ است؟
درخواستی که تلاش می‌کند با توکن پیکربندیشده مواد کلید رمزگشاییشده را بازیابی کند رد میشود.
چرا این اتفاق می‌افتد
نه — این عمدی است. توکنی که این برنامهها استفاده میکنند یک توکن محدود به یکپارچهسازی است، که عمداً محدودتر از یک توکن کامل API حساب است: میتواند محتوا را تحلیل و ناشناس کند، اما هر اندپوینتی که مواد کلید رمزگشاییشده را بازمی‌گرداند برای یک توکن محدود به یکپارچهسازی ۴۰۳ برمی‌گرداند، به‌طوری که یک سرور Nextcloud به‌خطرافتاده هرگز نتواند برای رمزگشایی تاریخچه رمزگذاری برگشت‌پذیر شما استفاده شود.
چه باید کرد
- 1.این رفتار مورد انتظار است، نه باگی که باید رفع شود — این برنامهها هرگز برای گردش کار تحلیل/ناشناس‌سازی/بازگردانی خود به مواد کلید رمزگشاییشده نیاز ندارند.
- 2.اگر گردش کاری واقعاً به دسترسی کامل حساب نیاز دارد، از یک توکن API با محدوده کامل خارج از این برنامهها، در محیطی که خودتان کنترل می‌کنید استفاده کنید.
همچنان به کمک نیاز دارید؟
اگر هیچ‌یک از راه‌حل‌های بالا کار نکرد، با ما تماس بگیرید و ما به شما در حل این مشکل کمک خواهیم کرد.