رموز الوصول — الأمان واستكشاف الأخطاء
توضح هذه الصفحة نموذج التحقق المشترك القائم على التجزئة ونطاق المؤسسة، وفروق دورة الحياة بين رابط الاستبيان العام ورمز البوابة ورمز العارض.
سرّية الرمز
يظهر الرابط الخام لأي رمز مرة واحدة فقط، في الصفحة الصادرة، مباشرةً بعد إنشائه، مع زرّي نسخ وفتح.
- الرابط الخام لا يمكن استرجاعه لاحقًا أبدًا. إذا لم تنسخه، فعليك إنشاء رمز جديد.
- القيمة الخام لا تُخزَّن بصورتها الخام أبدًا. إذ يُحتفظ بقيمة مجزّأة (hash) منها فقط.
- تعرض صفحات القوائم والتفاصيل بيانات وصفية آمنة فقط — الاسم والنطاق والحالة ونافذة التوافر وسعة الاستخدام. ولا تعرض الرابط الخام أو قيمته المجزّأة أبدًا.
ولأن القيمة الخام لا يمكن استرجاعها، عامِل كل رابط صادر كسِرّ. شاركه فقط عبر قناة آمنة، وألغِه إذا كان قد يكون تعرّض للكشف.
انتهاء الصلاحية
انتهاء الصلاحية اختياري لـSingleSurvey وTenantActiveSurveys، وإلزامي لـResponseViewer: تحد رموز العارض العادية قيمة ViewerTokenMaxDays، وتحد الرموز التي تفعل التصدير القيمة الأقصر ViewerExportMaxDays. وقد يكون لرابط الاستبيان العام وقت بدء أيضًا. تفشل بيانات الاعتماد غير المتاحة بأمان.
رمز المرور
يمكنك اشتراط رمز مرور على أي رمز. لا تُحفظ إلا تجزئة SHA-256 وتتم المقارنة بزمن ثابت. ينبغي للأسطح العامة تجنب كشف حالة الرمز؛ بينما يميز محلل الجوال رمز المرور المطلوب أو غير الصالح بحالة HTTP 401 والرمز غير المتاح بحالة HTTP 410.
الإلغاء
يمكنك إلغاء أي رمز في أي وقت من لوحة التحكم. الإلغاء إجراء من نوع POST محميّ بمكافحة التزوير (antiforgery). بمجرد الإلغاء، لا يمكن للرمز فتح صفحته العامة بعد ذلك. ولا يؤثّر إلغاء رمز على أي رمز آخر.
النطاق
كل رمز محدّد النطاق بالمؤسسة التي أنشأته، ولا يكشف أبدًا بيانات مؤسسة أخرى:
- يفتح رابط الاستبيان العام استبيانًا واحدًا محددًا فقط.
- يغطّي رمز البوابة استبيانات المؤسسة النشطة والمنشورة حاليًا فقط.
- يغطّي رمز العارض جميع الاستبيانات المسموح بها، أو استبيانًا واحدًا محددًا إذا حدّدت نطاقه بهذه الطريقة.
ولا يكشف أي رمز أبدًا بيانات خارج نطاقه.
سلوك العارض للقراءة فقط
رمز العارض للقراءة فقط بصرامة. يعرض النتائج وفق الإمكانات التي فعّلتها، ولا يمكن للزائر مطلقًا تقديم أي شيء أو تعديله. تُرجع إمكانية "عرض الإجابات المقدَّمة الخاصة به" نتيجة فارغة لرابط عارض بلا حساب، لأن الرمز لا يحدّد هوية مُجيب.
حدود الخطة
لكل نوع رمز حدُّ خطة خاص به، يُطبَّق على الخادم:
| نوع الرمز | حد الخطة |
|---|---|
| رابط الاستبيان العام | الوصول العام للاستبيانات |
| رمز البوابة | رموز البوابة |
| رمز العارض | رموز المشاهدين |
يفرض الإنشاء الحد داخل معاملة حصة. وتحتفظ مصالحة تخفيض الخطة بأقدم الرموز النشطة المسموحة وتلغي الرموز الأحدث الزائدة، لذلك لا يوجد ضمان ببقاء كل الرموز الحالية بعد خفض الحد. ولا تستهلك الرموز المنتهية السعة.
استكشاف الأخطاء وإصلاحها
| العَرَض | السبب المحتمل | ما يجب فعله |
|---|---|---|
| "انتهت صلاحية هذا الرابط" | مرّ وقت انتهاء الرمز. | أنشئ رمزًا جديدًا وشاركه. |
| الصفحة لا تُفتح | تم إلغاء الرمز. | أنشئ رمزًا جديدًا إذا كان الوصول ما زال مطلوبًا. |
| "تعذّر الفتح" بعد إدخال رمز | رمز المرور خاطئ. | تحقّق من رمز المرور الذي شاركته، أو أصدر رمزًا جديدًا. |
| البوابة لا تعرض أي استبيانات | لا توجد لدى المؤسسة استبيانات نشطة ومنشورة حاليًا. | انشر استبيانًا واحدًا على الأقل أو فعّله. |
| "تم بلوغ الحد" عند الإنشاء | بلغت حد الخطة لذلك النوع من الرموز. | ألغِ رمزًا لم تعد بحاجة إليه، أو راجع حد خطتك. |
| لا يمكنك الوصول إلى صفحة الإنشاء | يفتقر حسابك في لوحة التحكم إلى صلاحية إنشاء الرموز. | اطلب من مسؤول المؤسسة إنشاء الرمز أو منحك الصلاحية. |
| الاستبيان المحدّد بالنطاق للعارض غير متاح | الاستبيان المحدد الذي حُدِّد نطاق رمز العارض عليه غير متاح. | تحقّق من النطاق، أو أنشئ رمزًا محدّد النطاق على استبيان متاح. |