رفتن به محتوا
دانشیارمستندات
ورود
  • معرفی
  • شروع سریع
  • دانشیار چیست؟
  • صفحهٔ اپ‌ها
  • داخل یک اپ
  • فضای کاری: فایل‌ها و گفت‌وگو
  • اشتراک‌گذاری و اعضا
  • یادداشت و ضبط صدا
  • تمرین زبان
  • رزرو نوبت
  • خودکارسازی
  • صفحهٔ خواندن فایل
  • پروفایل شما
  • کیف پول
  • گفتگوهای مشتریان
  • کلیدهای API
  • احراز هویت
  • اپ، فضای کاری، سند
  • پردازش سند
  • گفت‌وگو و نشست‌ها
  • ارجاع‌ها
  • مهارت‌ها
  • قراردادها
  • فضاهای کاری
  • سندها
  • گفت‌وگو
  • مهارت‌ها
  • خطاها
  • دستیار پشتیبانی مشتری
  • پایگاه دانش داخلی
  • چت‌بات مستندات
  • دستیار آموزشگاه
  • ابزارک سایت
  • تنظیمات ابزارک
  • راهنمای فریم‌ورک‌ها
  • امنیت
  • رفع اشکال
  • پرسش‌های پرتکرار
  1. مستندات
  2. امنیت و راهنما
  3. امنیت

امنیت

هر کدام از دو کلید شما کجا می‌تواند باشد، چه چیزی از آن محافظت می‌کند، و چک‌لیست پیش از راه‌اندازی.

دانشیار سه نوع اعتبارنامه دارد و هرکدام فقط در یک جا امن است.

کلید سرور و کلید مرورگر

با این جدول تصمیم بگیرید هرکدام کجا برود:

جایی که می‌فرستیدشچه کسی از آن استفاده می‌کندقاعده
X-API-Keyسرور شما، وقتی REST API (/v1) را صدا می‌زند.محرمانه. در متغیر محیطی سرور یا یک ابزار نگهداری رمزها نگهش دارید. هیچ‌وقت آن را به مرورگر نفرستید.
data-api-keyابزارک در صفحه‌های عمومی شما.عمومی؛ هر کسی می‌تواند ببیندش. یک کلید جداگانهٔ ابزارک (pk_…) است که فقط می‌تواند سؤال بپرسد.
Authorization: Bearerکنسول دانشیار، بعد از ورود.کنسول خودش مدیریتش می‌کند. با /v1 کار نمی‌کند و هیچ‌وقت لازم نیست کپی‌اش کنید.

امن کردن کلید ابزارک

کلید ابزارک عمومی است، اما فقط می‌تواند سؤال بپرسد. نه با REST API کار می‌کند، نه فایل‌ها را فهرست یا دانلود می‌کند، نه نشان می‌دهد پاسخ از کدام سند آمده، و نه چیزی را تغییر می‌دهد.

سایت دیگری نمی‌تواند از آن استفاده کند: هم مرورگر و هم سرور ما دامنه‌های مجاز شما را بررسی می‌کنند. اما اسکریپتی بیرون از مرورگر هنوز می‌تواند خودش را جای سایت شما جا بزند؛ پس این چهار کار را بکنید:

  1. محدودیت‌هایی را که از شما محافظت می‌کنند بشناسید: تعداد سؤال برای هر بازدیدکننده و هر اپ محدود است، هر سؤال حداکثر ۲٬۰۰۰ نویسه است و هزینهٔ هر پاسخ از کیف پول شما کم می‌شود. ابزارک را فقط برای همان فضای کاری‌ای روشن کنید که در سایت گذاشته‌اید.
  2. فقط اسنادی را بارگذاری کنید که از انتشارشان مشکلی ندارید. هیچ‌وقت پروندهٔ بیمار یا فایل خصوصی در آن نگذارید.
  3. فقط سایت‌های واقعی خودتان را به دامنه‌های مجاز اضافه کنید. بقیهٔ سایت‌ها به‌طور پیش‌فرض مسدودند.
  4. هیچ‌وقت کلید محرمانه (sk_…) را در کد ابزارک یا هیچ کد سمت کاربر نگذارید. اگر از کلید ابزارک سوءاستفاده شد، برای کلید ابزارک «ساخت کلید جدید» را بزنید.

دامنه‌های مجاز از چه چیزی محافظت می‌کنند

دامنه‌های مجاز دو بار بررسی می‌شوند. مرورگر یک قاعدهٔ frame-ancestors را روی صفحهٔ ابزارک اجرا می‌کند و سرور ما هم هر سؤال را با فهرست مقایسه می‌کند. همهٔ سایت‌ها به‌طور پیش‌فرض مسدودند: فهرست خالی به هیچ سایتی اجازه نمی‌دهد.

  • جلوی این را می‌گیرد: سایت دیگری ابزارک شما را به بازدیدکننده‌های خودش نشان دهد یا از صفحه‌هایش API ابزارک را صدا بزند و از کیف پول شما خرج کند.
  • به‌طور کامل جلوی این را نمی‌گیرد: اسکریپتی بیرون از مرورگر (مثلاً curl) که کلید ابزارک را کپی کند و نشانی صفحه را جعل کند. هیچ کلید عمومی‌ای نمی‌تواند جلوی این را بگیرد. محدودیت تعداد درخواست — برای هر بازدیدکننده و هر اپ — هزینه‌اش را برای شما محدود می‌کند.

نوشتن دامنه‌ها: دامنه‌های مجاز.

محدودیت تعداد درخواست

ابزارک سه محدودیت دارد: ۲۰ سؤال در ساعت برای هر نشانی IP، ۵۰۰ سؤال در روز برای هر اپ، و ۶۰ بار بارگذاری در ساعت برای هر نشانی IP. جزئیات در محدودیت‌ها و هزینه آمده است.

REST API (/v1) فقط برای بارگذاری فایل (۶۰ بار در ساعت) و پردازش دوباره (۳۰ بار در ساعت) محدودیت دارد؛ بقیهٔ درخواست‌ها هنوز محدودیتی ندارند. اگر آن را پشت مسیر خودتان گذاشته‌اید، همان‌جا برای هر کاربر محدودیت بگذارید تا یک نفر نتواند همهٔ اعتبارتان را خرج کند.

CORS

CORS یک قاعدهٔ مرورگر است و تعیین می‌کند کدام سایت‌ها می‌توانند با JavaScript یک API را صدا بزنند.

  • ابزارک به تنظیم CORS از طرف شما نیازی ندارد؛ داخل iframe و روی سایت خود دانشیار اجرا می‌شود.
  • صدا زدن /v1 با JavaScript سایت خودتان، با CORS مسدود می‌شود. این عمدی است: آن را از سرورتان صدا بزنید.
  • اگر سایتتان Content-Security-Policy می‌فرستد، سایت ابزارک را در script-src و frame-src مجاز کنید؛ وگرنه مرورگر اسکریپت و iframe را مسدود می‌کند.

عوض کردن و باطل کردن کلیددر نقشهٔ راه: به‌زودی

صفحهٔ اپ را در کنسول باز کنید. هر کلید — ابزارک و محرمانه — دکمه‌های «ساخت کلید جدید» و «حذف» خودش را دارد. کلید قدیمی همان لحظه باطل می‌شود.

اگر کلیدی لو رفت، فوراً همان کلید را دوباره بسازید. کلید محرمانهٔ جدید در سرورتان قرار می‌گیرد و کلید ابزارک جدید در کد ابزارک. تا وقتی جایگزینش نکنید، آن بخش کار نمی‌کند.

چک‌لیست پیش از راه‌اندازی

  1. کلید محرمانه (sk_…) فقط در متغیرهای محیطی سرور است؛ نه در Git و نه در هیچ کد سمت کاربر.
  2. ابزارک اپ جداگانهٔ خودش را دارد که فقط اسناد عمومی در آن است.
  3. فهرست دامنه‌های مجاز فقط سایت‌های واقعی شما را دارد و دامنهٔ آزمایشی جامانده‌ای در آن نیست.
  4. مسیر گفت‌وگوی خودتان، اگر دارید، محدودیت تعداد درخواست دارد و برای هر کاربر یک external_user_id می‌فرستد.
  5. Content-Security-Policy سایتتان اسکریپت و iframe ابزارک را مجاز می‌کند.
  6. می‌دانید اگر کلیدی لو رفت با چه کسی تماس بگیرید.
قبلیراهنمای فریم‌ورک‌هابعدیرفع اشکال

در این صفحه

  • کلید سرور و کلید مرورگر
  • امن کردن کلید ابزارک
  • دامنه‌های مجاز از چه چیزی محافظت می‌کنند
  • محدودیت تعداد درخواست
  • CORS
  • عوض کردن و باطل کردن کلید
  • چک‌لیست پیش از راه‌اندازی

همهٔ نمونه‌های این مستندات روی API واقعی اجرا می‌شوند. اگر نمونه‌ای کار نکرد، به ما بگویید؛ آن یک باگ در مستندات است.

خدماتدربارهٔ ماگفت‌وگو با ما