إنشاء مفتاح ربط

يتيح مفتاح الربط لنظام آخر، مثل نظام الموارد البشرية، استخدام واجهة REST البرمجية للأسطول. أنشئ مفتاحًا لكل نظام من شاشة الربط مع الأنظمة، وسلّمه لهذا النظام، وألغِه عندما لا يعود النظام بحاجة إلى الوصول.

لا ينشئ المفاتيح أو يلغيها إلا مدير النظام.

محتويات الشاشة

تضم نافذة مفتاح ربط جديد:

• المستخدم، مع أيقونة المعلومات وقائمة اختر مستخدمًا.
• اسم المفتاح، مع المثال «مثال: مزامنة نظام الموارد البشرية».
• الصلاحيات: المربعان read («قراءة كل القوائم والسجلات (طلبات GET).») وwrite:drivers («إنشاء السائقين وتحديثهم برقم الإقامة وتفعيلهم أو إيقافهم (مزامنة السائقين من نظام الموارد البشرية).»). ويكون read محددًا مسبقًا.
• ينتهي في، مع أيقونة المعلومات ومنتقي تاريخ يعرض بلا انتهاء إذا كان فارغًا.
• زرا إلغاء وإنشاء المفتاح.

كيفية إنشاء مفتاح

1. في شاشة الربط مع الأنظمة، اضغط مفتاح ربط جديد.
2. في المستخدم، اختر المستخدم الذي سيعمل المفتاح باسمه.
3. في اسم المفتاح، اكتب اسمًا يبيّن النظام الذي يستخدمه.
4. حدد الصلاحيات التي يحتاجها النظام.
5. إذا أردت أن يتوقف المفتاح في يوم محدد، فاختره في ينتهي في.
6. اضغط إنشاء المفتاح. تظهر رسالة «تم إنشاء مفتاح الربط. انسخه الآن، فلن يظهر مرة أخرى.».

كيفية نسخ المفتاح

بعد الإنشاء مباشرة، يظهر في أعلى الشاشة مربع أخضر بعنوان تم إنشاء المفتاح “…” وفيه المفتاح نفسه.

1. اضغط نسخ المفتاح. يعرض الزر تم النسخ للحظة.
2. الصق المفتاح في إعدادات النظام الآخر، أو احفظه في مكان آمن.
3. اضغط نسخته لإغلاق المربع.

تنبيه

يظهر المفتاح مرة واحدة فقط، ولا يمكن قراءته لاحقًا ولا حتى لمدير النظام. وإذا فُقد، فألغِه وأنشئ مفتاحًا جديدًا.

الحقول

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

كيفية إلغاء مفتاح

1. في قائمة المفاتيح، اضغط أيقونة السلة في آخر صف المفتاح.
2. اضغط إلغاء في نافذة التأكيد. يفقد أي نظام يستخدم المفتاح الوصول فورًا، ولا يمكن التراجع عن ذلك.

ملاحظة

يحق لكل مفتاح 60 طلبًا في الدقيقة. ويجد المطورون الطلبات والصيغ في مرجع الواجهة البرمجية.