
به طور خیلی اتفاقی به یه مخزن Github رسیدم که استار خیلی زیادی داشت و داخلش چکلیستی از موارد امنیتی مهمی رو که باید در حین طراحی، پیادهسازی و دپلوی APIها رعایت کرد، قرار داده بود.
چون کوتاه بود و با خوندنش حس کردم خیلی مفیده، تصمیم گرفتم ترجمش کنم. بعد از این که ترجمه کردم و چند بار مرور و ویرایش کردم، مشکل راستبهچپ کردن فایل مارکداون رو حل کردم و بعد دیدم که متاسفانه وقتی با ترفندی که توی استک اورفلو پیدا کرده بودم، فایل مارکداون رو راستبهچپ میکنم، checkboxها میافته روی متن! واقعا از دست Github عصبانی بودم و در نهایت با کلی آزمون و خطا و با کمک ;nbsp& مشکل رو حل کردم :)
توی pull requestهای مخزن دیدم که دوتا پولرکوئست فعال برای ترجمهی فارسی وجود داره! یکی از پولرکوئستها که جدیدتر هم بود ترجمهی خوبی نداشت و مترجم، فایل مارکداونش رو راستبهچپ نکرده بود! پولرکوئست دومی ترجمهی خوبی داشت (و از بخشهایی از ترجمش برای بهتر کردن ترجمهی خودم هم استفاده کردم) و فایل مارکداونش هم راستبهچپ بود ولی مشکل روهمافتادن checkboxها رو حل نکرده بود. پس خودم یه پولرکوئست جدید درست کردم و موارد بالارو داخلش توضیح دادم.
لینک مخزن گیتهاب چکلیست. نگاه کنید و اگه خوشتون اومد استار کنید.
در ادامهی نوشته ترجمهی خود چکلیست رو هم قرار میدم چون ویرگول نوشته رو حذف کرد به دلیل تبلیغات و لینکسازی! اما توجه داشته باشید که چکلیست در واقع یه چیز پویاست که میتونه تغییر کنه و موارد مختلفی به اون اضافه یا کم بشه و اگه واقعا میخواین نسخهی بروزش رو ببینید باید از گیتهاب اینکارو بکنید.
چکلیستی از مهمترین کارهای لازم برای حفظ امنیت در زمان طراحی، تست و انتشار API.
Basic Auth یا همان اصالتسنجی برای دسترسیهای اولیه استفاده نکن. به جای آن از روشهای استاندارد احراز هویت استفاده کن (مثلا JWT یا OAuth).احراز هویت، تولید توکن و ذخیره پسوورد چرخ را دوباره اختراع نکن. از استانداردها استفاده کن.تعداد ماکسیمم تلاش مجدد و تعداد دفعات ورود را قرار بده.JWT Secret استفاده کن تا حملهی بروتفورس به توکن بسیار سخت باشد.HS256 یا RS256).TTL یا RTTL) را تا حد ممکن کوتاه کن.redirect_uri را در سمت سرور اعتبارسنجی کن تا تنها به URLهای مجاز اجازه داده شود.response_type=token را نده).state با یک هش تصادفی استفاده کن تا از CSRF روی پروسهی احراز هویت OAuth جلوگیری کنی.HSTS استفاده کن تا از حملهی SSL Strip جلوگیری شود.GET برای خواندن، POST برای ایجاد کردن، PUT/PATCH برای جایگزین یا بروزرسانی و DELETE برای حذف یک رکورد، و در صورتیکه متد درخواستی برای منبع درخواستشده مناسب نیست با 405 Method Not Allowed پاسخ بده.content-type را در هدر Accept رکوئست (مذاکره محتوا یا Content Negotiation) اعتبارسنجی کن تا فقط به فرمتهای مورد پشتیبانی اجازه داده شود (مثلا application/xml، application/json و ...).content-type در دادهی پستشده را اعتبارسنجی کن (مثلا application/x-www-form-urlencoded، multipart/form-data، application/json و ...).XSS، SQL-Injection و Remote Code Execution).Quota، Spike Arrest یا Concurrent Rate Limit) فعال شوند و منابع APIها را به صورت داینامیک دپلوی کن.user/654321/orders از /me/orders استفاده کن.UUID استفاده کن.XXE (XML External entity attack) جلوگیری شود.Billion Laughs/XML bomb توسط exponential entity expansion attack جلوگیری شود.X-Content-Type-Options: nosniff را ارسال کن.X-Frame-Options: deny را ارسال کن.'Content-Security-Policy: default-src 'none را ارسال کن.X-Powered-By، Server و X-AspNet-Version.content-type را برای جواب اجباری کن. اگر application/json برمیگردانی، پس content-type پاسخ application/json است.دادههای اعتبارسنجی، پسووردها و توکنهای امنیتی را برنگردان.200 OK، 400 Bad Request، 401 Unauthorized و 405 Method Not Allowed.برای همکاری و کمک میتوانی به راحتی این مخزن را fork کنی، تغییرات مورد نظرت را اعمال کنی و یک pull request ثب کنی. اگر سوالی داشتی به آدرس [email protected] ایمیل بزن.