Waafir
هذه الصفحة ترجمة آلية في انتظار المراجعة البشرية. قد تحتوي على أخطاء.

رموز الوصول الشخصية

رمز الوصول الشخصي (PAT) هو بيانات اعتماد تنشئها وتلصقها بنفسك. وهو مخصص لواجهة Waafir REST API والبرامج النصية، ولمساعد الذكاء الاصطناعي الذي لا يستطيع تسجيل الدخول: فمعظم المساعدات تتصل بلصق عنوان URL الخاص بـ Waafir وتسجيل الدخول، دون أي رمز على الإطلاق. على خوادم MCP الخاصة بـ Waafir، يحمل كل طلب إما اتصالًا أُنشئ بتسجيل الدخول أو رمز PAT صالحًا. لا يوجد وصول مجهول الهوية، ولا تُقبل جلسة متصفح عادية مسجّل الدخول فيها على هذه الواجهة (يُرفض الطلب المصادَق عليه بجلسة). يتصرف رمز PAT بصفتك أنت، داخل مؤسستك، ضمن حدود النطاق وغرف البيانات التي تختارها عند إصداره.

أين تُصدر رمزًا

افتح الإضافات ← الإعدادات ← رموز API. تتكون الصفحة من ثلاثة أجزاء: نموذج لإصدار رمز جديد، وقائمة برموزك الحالية (مع إجراء للإلغاء)، ومقتطف إعداد جاهز للاستخدام لربط مساعد باستخدام رمز.

لإصدار رمز، املأ النموذج:

  • الاسم — تسمية مقروءة تتيح لك التعرف على الرمز لاحقًا (على سبيل المثال، "Claude Desktop – laptop"). مطلوب.
  • النطاق — ما يُسمح للرمز بفعله. راجع أدناه.
  • نطاق غرف البيانات — اترك جميع غرف البيانات محددًا ليصل الرمز إلى كل غرفة بيانات يمكنك الوصول إليها، أو ألغِ تحديده واختر غرف بيانات معينة لقصر الرمز عليها وحدها.
  • انتهاء الصلاحية — التاريخ الذي يتوقف الرمز بعده عن العمل. ملؤه اختياري، لكنه ليس اختياريًا في الأثر: اتركه فارغًا وسيُصدر الرمز بصلاحية مدتها 90 يومًا. راجع انتهاء الصلاحية.

النطاقات

يحمل الرمز واحدًا من ثلاثة نطاقات، مرتبة تصاعديًا حسب الصلاحية:

النطاقيسمح بـالاستخدام النموذجي
readالعرض والقراءة — غرف البيانات والمجلدات والملفات وبيانات الملفات الوصفية والبحث وعناوين URL للتنزيل وعرض الأذونات؛ وقراءة النص المستخرج من المستند؛ وقراءة سلاسل أسئلة وأجوبة المستثمرين؛ والتحقق من حالة مهمة حجب أو ترجمة أو توقيع إلكتروني.مساعد للقراءة فقط يجيب عن أسئلة حول غرفة بيانات.
writeكل ما يسمح به read، إضافةً إلى عمليات التعديل: إنشاء المجلدات وإعادة تسميتها ونقلها وحذفها واستعادتها؛ وتحميل الملفات وإعادة تسميتها ونقلها وحذفها واستعادتها، بما في ذلك تحميل إصدار جديد من ملف والرجوع إلى إصدار سابق؛ وبدء حجب مستند أو ترجمته؛ وإنشاء مغلفات التوقيع الإلكتروني وإرسالها ورفضها وإبطالها. يحتاج إرسال مغلف (أو إضافة موقّعين إلى مغلف أُرسل بالفعل) أيضًا إلى الإرسال إلى أشخاص خارج مؤسستك، ويطلب منك مساعدك التأكيد قبل الإرسال. ويحتاج التوقيع (esign_sign) أيضًا إلى توقيع المستندات، ويُطلب تأكيده أولًا كذلك.مساعد ينظّم غرفة بيانات أو يتولى صيانتها.
adminكل ما يسمح به write، إضافةً إلى أدوات منح الأذونات الأربع: منح وصول مستخدم إلى الملفات وغرف البيانات أو إلغاؤه. لاحظ أن أدوات قراءة الأذونات الثلاث تحتاج إلى read فقط.مساعد يدير من يمكنه رؤية ماذا.

النطاق تراكمي — فالنطاق الأعلى يشمل كل ما دونه. ويذكر مرجع الأدوات لكل خادم الحد الأدنى من النطاق الذي تتطلبه كل أداة.

من يمكنه إصدار كل نطاق

لا يمكن أن يحمل الرمز أبدًا صلاحية تفوق صلاحية الشخص الذي يصدره:

  • يمكن لأي عضو نشط في مؤسستك إصدار read وكذلك write.
  • لا يمكن إصدار admin إلا من قِبل مالك أو مسؤول المؤسسة. إذا لم تكن مالكًا أو مسؤولًا، فلن يظهر خيار admin في أداة اختيار النطاق.
  • لا يمكن للمستثمرين (ولا للأدوار الأخرى من خارج فريق الصفقة) إصدار رموز على الإطلاق.

وبعد الإصدار، تطبّق أدوات الأذونات في admin سقفًا ثانيًا عند الاستدعاء: يجب أن يكون مالك الرمز نفسه مسؤولًا أو مديرًا في المؤسسة حتى ينجح منح الإذن. نطاق الرمز هو سقف الرمز؛ ودور المالك هو سقف الشخص، ويجب أن يجتاز إجراء الإدارة كليهما — وهي بالضبط القاعدة التي تطبقها واجهة المنتج. لا يوجد عبر MCP مسار أكثر تساهلًا من المسار عبر المنتج.

السماح لرمز بتوقيع المستندات

يحتاج التوقيع إلى رمز مفعّل فيه خيار توقيع المستندات. تختاره عند إنشاء الرمز في الإضافات ← الإعدادات، لرمز write أو admin، بحيث لا يستطيع التوقيع نيابةً عنك إلا مساعد وثقت به. ويطلب إنشاء الرمز بالفعل رمز المصادقة الثنائية عندما تكون المصادقة الثنائية مفعّلة لديك، لذا يغطي هذا التحقق كل توقيع يجريه الرمز. وتعرض قائمة الرموز يمكن التوقيع على كل رمز من هذا النوع.

يعرض عليك مساعدك المستندات والموقّع والحقول أولًا، ولا يوقّع إلا عندما تؤكد. والرمز الذي لا يتضمن توقيع المستندات لا تُعرض له esign_sign في قائمة أدواته، ويُرفض إذا استدعاها. ولا تستطيع الرموز التي أُنشئت قبل وجود هذا الخيار التوقيع: أنشئ رمزًا جديدًا مع تفعيل توقيع المستندات.

السماح لرمز بقراءة محتوى المستندات

تحتاج قراءة مستند بالكامل، أو سؤال الذكاء الاصطناعي عن المستندات، إلى رمز مفعّل فيه خيار قراءة محتوى المستند. تختاره عند إنشاء الرمز في الإضافات ← الإعدادات، بأي نطاق. وتعرض قائمة الرموز محتوى المستند على كل رمز من هذا النوع. ويشمل ذلك:

  • get_file_text، النص الكامل المستخرج من مستند؛
  • get_file_download_url، رابطًا لتنزيل ملف؛
  • esign_download_signed، ملف PDF موقّعًا بالتوقيع الإلكتروني؛
  • رابط التنزيل الذي يُرجعه translate_file_status لترجمة مكتملة؛
  • GET /api/v1/files/{fileId}/content، بايتات المستند عبر REST API؛
  • POST /api/viewer/token وPOST /api/viewer/artifact-access و POST /api/viewer/artifact-access/unlock، التي تُصدر رمز العارض أو ملف تعريف الارتباط الذي يبث عارض المستندات داخل المنتج المستند بناءً عليه؛
  • أدوات الذكاء الاصطناعي التي تكتب أنت سؤالها أو مُدخلها، لأن الإجابة قد تكرر ما يقوله المستند: dataroom_ask وdataroom_draft_answer وdataroom_compare_files وdataroom_generate_update؛
  • POST /api/v1/chat، إجابة الذكاء الاصطناعي نفسها عبر REST API؛
  • حقل quote لكل حقيقة يُرجعها GET /api/v1/facts.

يُرفض الرمز الذي لا يتضمن هذا الخيار من تلك الأدوات (GRANT_REQUIRED) ومن مسارات REST تلك (PAT_GRANT_REQUIRED)، ويُرجع translate_file_status الحالة مع download_withheld_reason: content_grant_required بدلًا من الرابط. ويُرجع GET /api/v1/facts وdataroom_list_facts كل حقيقة دون حقل quote، مع اقتطاع value إلى 20 كلمة وضبط value_truncated. ولا يزال بإمكان الرمز العرض والبحث، وقراءة ملخص المستند باستخدام get_file_metadata أو dataroom_summarise_file. ولا تستطيع الرموز التي أُنشئت قبل وجود هذا الخيار قراءة محتوى المستندات: أنشئ رمزًا جديدًا مع تفعيل قراءة محتوى المستند. ولا تتأثر رموز الخدمة بذلك.

يمكن لكل رمز الحصول على 10 روابط تنزيل كحد أقصى في الدقيقة. وبعد ذلك، يُرفض get_file_download_url (RATE_LIMITED) ويُرجع translate_file_status الحالة مع download_withheld_reason: rate_limited؛ اطلب مجددًا بعد دقيقة.

السماح لرمز بالإرسال إلى أشخاص خارج مؤسستك

إن إنشاء رابط مشاركة، وإضافة عارض للقطة، ودعوة عضو فريق أو مستثمر، وتمديد وصول مستثمر أو إعادته (dataroom_extend_investor_access وdataroom_reinstate_investor_access) كلها تمنح الوصول لشخص من خارج مؤسستك، لذا تحتاج إلى رمز مفعّل فيه خيار الإرسال إلى أشخاص خارج مؤسستك (وهو الإذن نفسه الذي يرسل تحديثات المستثمرين وإجابات الأسئلة والأجوبة وطلبات التوقيع الإلكتروني). تختاره عند إنشاء رمز write أو admin في الإضافات ← الإعدادات. وتعرض قائمة الرموز يمكن الإرسال خارجاً على كل رمز من هذا النوع.

يعرض عليك مساعدك أولًا من يسمح الرابط الجديد بدخوله، وقاعدة اتفاقية عدم الإفصاح (NDA)، وتاريخ انتهاء الصلاحية، ولا ينشئه إلا عندما تؤكد. ولا يحتاج إلغاء رابط أو عارض إلى أي إذن.

ويغطي الإذن أيضًا منح شخص من خارج فريق الصفقة (المالكين والمسؤولين والأعضاء) وصولًا، أو وصولًا أوسع، إلى غرفة أو مستند. ويعني "من الخارج" أي شخص ليس عضوًا نشطًا في فريق الصفقة لدى مؤسسة الغرفة: المستثمرين، والضيوف، والأشخاص الذين لديهم دعوة معلّقة، وأعضاء مؤسسة أخرى. وبدون الإذن، يُرفض الرمز (GRANT_REQUIRED على MCP) في الحالات التالية:

  • منح إذن قراءة أو تنزيل لشخص كهذا: set_file_permissions، dataroom_set_folder_permissions، dataroom_bulk_set_file_permissions؛
  • إزالة حظر مفروض على شخص كهذا، مما يعيد وصوله: revoke_file_permission، dataroom_revoke_folder_permission، dataroom_bulk_revoke_file_permissions؛
  • منح وصول إلى الغرفة لشخص كهذا، بأي مستوى: invite_user_to_dataroom؛
  • تغيير دور عضو دوره الحالي ليس من فريق الصفقة، مما يرقّيه: dataroom_team_change_member_role؛
  • تغيير خاص بمستثمر يوسّع الوصول: dataroom_set_investor_permissions من عارض إلى منزِّل، أو إيقاف اتفاقية عدم الإفصاح، أو تفعيل المراقبة أو التحديثات.

لا تحتاج حالات الحظر، وإنهاء إذن ممنوح، والأذونات الممنوحة لفريق الصفقة الخاص بك إلى أي إذن. ولا يشمل ذلك المحتوى الذي يوضع حيث يملك الشخص وصولًا بالفعل (التحميل، والنقل، والنشر). ولا يحتاج إرفاق اتفاقية عدم إفصاح خاصة بشركة مستثمرة وقّعتها تلك الشركة إلى أي إذن.

ينطبق الإذن نفسه على استدعاءات REST التالية التي تُجرى برمز وصول شخصي:

  • يُرفض POST /api/share-links (إنشاء رابط) وPOST /api/snapshots/{id}/viewers بالخطأ 403 PAT_GRANT_REQUIRED بدونه؛
  • يُرفض POST /api/investors/invite (الذي ينشئ رابطًا شخصيًا ويرسله بالبريد الإلكتروني) بالطريقة نفسها؛
  • يُرفض PATCH /api/investors/{id}/extend وPATCH /api/investors/{id}/access (إعادة وصول مستثمر أو الموافقة على طلب وصول) بالطريقة نفسها؛ أما إلغاء وصول مستثمر (DELETE /api/investors/{id}/access) فلا يحتاج إلى أي إذن؛
  • يُرفض POST /api/team وPOST /api/v1/team وPOST /api/team/resend (إذ ترسل دعوة الفريق رابط انضمام بالبريد الإلكتروني) بالطريقة نفسها؛
  • يُرفض PATCH /api/share-links/{id} لأي تعديل على إعدادات وصول الرابط (تفعيله، أو وضعه، أو نطاقاته، أو انتهاء صلاحيته، أو اتفاقية عدم الإفصاح، سواء وسّع التعديل تلك الإعدادات أو ضيّقها)؛ أما تعطيل الرابط فمسموح دائمًا؛
  • يجيب GET /api/share-links دون url وtoken لكل رابط، مع وسم urlWithheld: true، وحقل urlWithheldReason يوضح السبب؛
  • يُرفض POST /api/v1/grants لمنح إذن قراءة أو تنزيل لشخص من خارج فريق الصفقة؛ ويُرفض DELETE /api/v1/grants/{id} عندما يكون الإذن حظرًا مفروضًا على ذلك الشخص؛ ويُرفض PATCH /api/v1/team/{id} عندما لا يكون الدور الحالي للعضو من فريق الصفقة.

تقرأ هذه الفحوصات المسار بالطريقة التي يوجّهه بها الخادم، لذا لا تتجاوزها شرطة مائلة في النهاية أو حرف مرمّز بالنسبة المئوية. والمسار الذي لا يمكن فك ترميزه، أو الذي يحمل مقطع ./.. أو / مرمّزًا داخل مقطع، لا يمكن مطابقته مع أي من الاستدعاءات التي يغطيها الإذن. لذلك فإن رمز الوصول الشخصي الذي يفتقر إلى أي إذن لكل طلب، سواء هذا الإذن أو قراءة محتوى المستند أو قراءة تحليلات المشاركة، يُرفض له كل مسار من هذا النوع بالخطأ 403 PAT_PATH_MALFORMED، أيًا كان الاستدعاء.

لا تحمل الرموز التي أُنشئت قبل وجود هذا الإذن هذا الإذن، لذا تفقد هذه الاستدعاءات إلى أن تنشئ رمز write أو admin جديدًا مع تفعيل الخيار. ولا يمكن لرمز read أن يحمل هذا الإذن.

السماح لرمز بقراءة تحليلات المشاركة

يتيح خيار قراءة تحليلات المشاركة للرمز قراءة من شاهد أي المستندات، ومتى، ولكم من الوقت: أدوات المشاركة، وبيانات المشاركة في قائمة المستثمرين. لا تفعّله إلا لمساعد ينبغي أن يرى ذلك. ويمكن لأي نطاق أن يحمله.

ينطبق الإذن نفسه على قراءات النشاط عبر REST: GET /api/v1/activity (موجز النشاط والتدقيق الخاص بالمؤسسة)، و/api/v1/activity/rollups، و/api/v1/activity/engagement، و/api/v1/activity/engagement/documents و/api/v1/activity/engagement/document/pages. وبدونه يُرفض رمز الوصول الشخصي بالخطأ 403 PAT_GRANT_REQUIRED. ولا تتأثر رموز الخدمة والجلسات المسجّل الدخول فيها بذلك.

لا تملك الرموز التي أُنشئت قبل وجود هذه الخيارات أيًّا منها: أنشئ رمزًا جديدًا مع تفعيل الخيار.

قصر الرمز على غرف بيانات محددة

افتراضيًا، يمكن للرمز الوصول إلى كل غرفة بيانات يستطيع مالكه الوصول إليها. يؤدي إلغاء تحديد جميع غرف البيانات واختيار غرف معينة إلى قصر الرمز على قائمة السماح تلك: يُرفض أي استدعاء أداة يشير إلى غرفة بيانات خارج القائمة، ولا يرى الرمز المقيّد حتى أسماء غرف البيانات التي لا يستطيع فتحها. استخدم ذلك لمنح عميل ذكاء اصطناعي وصولًا إلى صفقة واحدة دون كشف بقية محفظتك.

انتهاء الصلاحية

تنتهي صلاحية كل رمز. لا يوجد رمز PAT دائم: فالرمز الذي لم تكن صلاحيته تنتهي أبدًا كان هو نفسه الثغرة الأمنية التي وُجد هذا السلوك لسدّها، لأن بيانات الاعتماد المنسية تبقى صالحة إلى الأبد. يؤدي تعيين تاريخ انتهاء الصلاحية إلى توقف الرمز عن العمل بعد ذلك التاريخ — ويُرفض الطلب الذي يحمل رمزًا منتهي الصلاحية تمامًا كما يُرفض الرمز الملغى، بالخطأ HTTP 401.

  • اترك الحقل فارغًا وستحصل على 90 يومًا، تُحتسب من لحظة إصدار الرمز. الفراغ يعني استخدام القيمة الافتراضية، لا عدم انتهاء الصلاحية أبدًا.
  • عيّن تاريخًا وسيُحترم بدقة، حتى سقف قدره 365 يومًا من تاريخ الإصدار.
  • اطلب أكثر من 365 يومًا وسيُرفض الطلب، ولن يُختصر بصمت — فالإصدار لا يعيد إليك أبدًا رمزًا بصلاحية أقصر مما طلبت دون إعلامك. ويُرفض التاريخ الذي مضى بالطريقة نفسها.

لذلك إذا كان من المفترض أن يستمر تكامل ما في العمل، فعيّن تاريخ انتهاء الصلاحية عن قصد وضع تذكيرًا في تقويمك لاستبدال الرمز قبل انقضائه — فالحقل الفارغ سيوقف ذلك التكامل بصمت بعد نحو ثلاثة أشهر من إعداده. لا يوجد إجراء لتجديد رمز قائم أو تدويره، ولا أي تحذير قبل انتهاء صلاحيته: فاستبداله يعني إصدار رمز جديد، وتحديث إعدادات عميلك، وإلغاء الرمز القديم. وفي المقابل، تكون الصلاحية القصيرة مناسبة تمامًا لرمز تصدره لمهمة لمرة واحدة.

تعرض قائمة الرموز في الإضافات ← الإعدادات تاريخ انتهاء صلاحية كل رمز، لتتمكن من رؤية ما يوشك على الانقضاء.

العرض لمرة واحدة

عند إصدار رمز، تُعرض القيمة الخام — التي تبدأ بـ waafir_pat_ — مرة واحدة فقط، فور الإنشاء مباشرةً. لا تخزّن Waafir الرمز الخام أبدًا، بل تخزّن تجزئة أحادية الاتجاه له فقط، لذا لا يمكن استرجاعه أو عرضه مرة أخرى.

  • انسخه الآن والصقه مباشرةً في إعدادات عميلك. تحتوي لوحة العرض على زر للنسخ.
  • إذا فقدته، فلا يمكنك استعادته — ألغِ ذلك الرمز وأصدر رمزًا جديدًا.
  • تعامل معه ككلمة مرور: فهو يمنح نطاقه لأي شخص يحمله.

بعد العرض، لا تعرض قائمة الرموز إلا بادئة قصيرة غير سرية (على سبيل المثال waafir_pat_ab12…) لتتمكن من التمييز بين رموزك دون أن يكون السرّ قابلًا للاسترجاع.

إلغاء رمز

في قائمة الرموز في الإضافات ← الإعدادات، استخدم إجراء إلغاء بجوار أي رمز. يسري الإلغاء فورًا — يُرفض الطلب التالي الذي يستخدم الرمز. ألغِ الرمز فور فقدان جهاز، أو مغادرة متعاقد، أو ببساطة عندما لا تعود بحاجة إلى الوصول. تبقى الرموز الملغاة ظاهرة في القائمة (موسومة بأنها ملغاة) حفاظًا على سجل ما كان موجودًا؛ ولا يمكن إعادة تفعيلها أبدًا.

عندما ينتهي الرمز من تلقاء نفسه

يعمل الرمز من خلال عضويتك في المؤسسة، لذا ينتهي بانتهاء تلك العضوية. لا تحتاج إلى إلغائه بنفسك في الحالات التالية:

  • عندما تغادر المؤسسة، أو يزيلك مسؤول. يُلغى كل رمز تملكه في تلك المؤسسة في تلك اللحظة. أما الرموز التي تملكها في مؤسسات أخرى فتستمر في العمل.
  • عندما يحذف أحد مسؤولي Waafir حسابك. تُلغى رموزك في جميع المؤسسات.
  • عندما يحذف أحد مسؤولي Waafir المؤسسة. يُلغى كل رمز فيها، بما في ذلك رموز الخدمة الخاصة بها.

عمليات الإلغاء هذه دائمة. فإعادة دعوتك، أو استعادة حسابك أو المؤسسة، لا تعيد أي رمز: أصدر رمزًا جديدًا.

رمز الخدمة ملك للمؤسسة، لا للمسؤول الذي أنشأه، لذا يستمر في العمل عندما يغادر ذلك المسؤول. ولا ينهيه مبكرًا إلا إلغاؤه أو حذف المؤسسة.

سجل الرموز في سجل التدقيق

كل رمز يُصدر أو يُلغى يكتب صفًا في سجل التدقيق الخاص بالمؤسسة: من قام بذلك، واسم الرمز، ونطاقه، وأذوناته، وتاريخ انتهاء صلاحيته، وعدد غرف البيانات المقصور عليها، وسبب إلغائه (من قِبل مالكه، أو بسبب انتهاء عضوية، أو بسبب حذف حساب أو مؤسسة). ولا يُسجَّل الرمز نفسه ولا تجزئته ولا بادئته أبدًا. تظهر الصفوف في سجل النشاط الكامل، لا في ملخص لوحة المعلومات.

إذا تعذّر على Waafir تسجيل رمز جديد في سجل التدقيق، فلن يُصدر الرمز وسترى الرسالة "The token wasn't created because we couldn't record it. Try again." (لم يُنشأ الرمز لأنه تعذّر علينا تسجيله. حاول مرة أخرى.)

التالي: أعدّ عميلك باستخدام الرمز الذي أصدرته للتو.