--- title: "إدارة المسؤولين باستخدام واجهة برمجة التطبيقات Cato" slug: "managing-admins-with-the-cato-api" updated: 2026-07-30T02:31:09Z published: 2026-07-30T02:31:09Z canonical: "knowledge.catonetworks.com/managing-admins-with-the-cato-api" --- > ## Documentation Index > Fetch the complete documentation index at: https://knowledge.catonetworks.com/llms.txt > Use this file to discover all available pages before exploring further. # إدارة المسؤولين باستخدام واجهة برمجة التطبيقات Cato تتناول هذه المقالة واجهات برمجة التطبيقات المختلفة من Cato التي تتيح لك إدارة المسؤولين وأدوار المسؤولين لتطبيق إدارة Cato. تدعم واجهة برمجة التطبيقات هذه إدارة المسؤولين لكل من حسابات الموزعين والحسابات العادية. ## إضافة مسؤول تكوين واجهة برمجة التطبيقات تقوم واجهة برمجة التطبيقات لتكوين `addAdmin` بإنشاء مسؤولين جدد للحساب في تطبيق إدارة Cato. ### إضافة مسؤول إدخال المعلمة - معرف الحساب (إلزامي) ### إضافة مسؤول الوسيطات هذه هي الحجج لواجهة برمجة التطبيقات لتكوين `addAdmin`: - الاسم الأول: الاسم الأول للمسؤول (بحد أقصى 255 حرفًا) - هذا الحقل إلزامي - الاسم الأخير: الاسم الأخير للمسؤول (بحد أقصى 255 حرفًا) - هذا الحقل إلزامي - البريد الإلكتروني: عنوان البريد الإلكتروني الفريد لكل مسؤول (بحد أقصى 255 حرفًا) - هذا الحقل إلزامي - كلمة المرور لا تنتهي صلاحيتها أبدًا: قيمة منطقية (صح/خطأ). إذا تم تعيين القيمة على صح، فلن تنتهي صلاحية كلمة مرور المسؤول أبدًا - هذا الحقل إلزامي - تمكين المصادقة المتعددة العوامل (MFA): قيمة منطقية (صح/خطأ). إذا تم تعيين القيمة على صح، يجب على المسؤول استخدام رمز MFA لتسجيل الدخول إلى تطبيق إدارة كاتو - هذا الحقل إلزامي - الأدوار المدارة: مصفوفة من updateAdminRoleInput. يحدد دور أو أكثر الذي يتم تعيينه للمسؤول. بالنسبة لمسؤولي البائعين، يحدد هذا الحقل الأدوار التي تم تعيينها للمسؤول لحسابات المدارة. إذا لم يتم تحديد هذا الحقل لنداء API، يتم تعيين دور المشاهد (ID 2) للمسؤول - استخدم المعرف 1 لتعيين دور المحرر للمسؤول - أدوار بائع: مصفوفة من updateAdminRoleInput (متعلق فقط بمسؤولي البائعين). يعرف الأدوار التي تم تعيينها للمسؤول لحساب البائع. إذا لم يتم تعريف هذا الحقل لنداء واجهة برمجة التطبيقات، فقد تم تعيين دور العارض للمسؤول لحساب البائع. بمجرد إنشاء المسؤول، يكون التدفق هو نفسه كما لو كان المسؤول قد تم إنشاؤه في تطبيق إدارة كاتو. إذا تم تعريف الحساب للسماح للمسؤولين بتسجيل الدخول باستخدام اسم المستخدم وكلمة المرور، فسوف يتلقى المسؤول بريدًا إلكترونيًا ترحيبيًا يتضمن رابطًا لتفعيل الحساب وتعيين كلمة المرور. | ![image1.png](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/8788772690717(1).png?sv=2026-02-06&spr=https&st=2026-11-22T13%3A48%3A12Z&se=2026-11-22T14%3A48%3A12Z&sr=b&sp=r&sig=hE4l2oWJB1YLlJ3r4gaeAq0Bw8H0u4E8f5Ww1dabLPo%3D) | | --- | ### مثال على واجهة برمجة التطبيقات لإضافة مسؤول ```plaintext mutation  {  admin(accountId:"xxxxxx") {    addAdmin(input: {      firstName :"dani2",      lastName :"din2"      email: "danidin5@4catonetworks.com",      passwordNeverExpires: true,      mfaEnabled: false,      managedRoles: [{ role: { id: 2} }, {role: {id:3}}]    }) {        adminID    }  } } ``` | ![image2.png](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/8788805455517(1).png?sv=2026-02-06&spr=https&st=2026-11-22T13%3A48%3A12Z&se=2026-11-22T14%3A48%3A12Z&sr=b&sp=r&sig=BHQcDGXmn3ca7tu5zBMvHh%2BL1I6ltWiqPWzxZwYT2Dg%3D) | | --- | | ![image3.png](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/8788805492637(1).png?sv=2026-02-06&spr=https&st=2026-11-22T13%3A48%3A12Z&se=2026-11-22T14%3A48%3A12Z&sr=b&sp=r&sig=PudL%2Bkl06ppLfLfPbQ82dwKBacTng%2FoOY0KuJi7lz6I%3D) | | --- | ## تحديث مسؤول تكوين واجهة برمجة التطبيقات تمكنك واجهة برمجة التطبيقات لتكوين `updateAdmin` من تحديث معلومات المسؤول (لا يمكن تحديث البريد الإلكتروني ومعرف المسؤول). ### تحديث مسؤول إدخال المعالم - معرف الحساب (إلزامي) ### تحديث مسؤول الوسيطات - معرف المسؤول (إلزامي) - الاسم الأول: الاسم الأول للمسؤول - الاسم الأخير: الاسم الأخير للمسؤول - كلمة المرور لا تنتهي صلاحيتها أبدًا: قيمة منطقية (صح/خطأ). إذا تم تعيين القيمة على **صح**، فلن تنتهي صلاحية كلمة مرور المسؤول أبدًا - تمكين المصادقة المتعددة العوامل (MFA): قيمة منطقية (صح/خطأ). إذا تم تعيين القيمة على **صح**، يجب على المسؤول استخدام رمز MFA لتسجيل الدخول إلى تطبيق إدارة كاتو - الأدوار المدارة: مصفوفة من `updateAdminRoleInput`. يحدد دور أو أكثر الذي يتم تعيينه للمسؤول. بالنسبة لمسؤولي البائعين، يحدد هذا الحقل الأدوار التي تم تعيينها للمسؤول لحسابات المدارة. - أدوار بائع: مصفوفة من `updateAdminRoleInput` (متعلق فقط بمسؤولي البائعين). يعرف الأدوار التي تم تعيينها للمسؤول لحساب البائع. ### مثال على واجهة برمجة التطبيق لتحديث المسؤول ```plaintext mutation {  admin(accountId: "26") {    updateAdmin(      adminID: "28876"      input: {        firstName: "sample"        lastName: "admin"        passwordNeverExpires: true        managedRoles: [{ role: { id: 1 } }]      }    ) {      adminID    }  } } ``` ![updateAdmin.png](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/8788805514781(1).png?sv=2026-02-06&spr=https&st=2026-11-22T13%3A48%3A12Z&se=2026-11-22T14%3A48%3A12Z&sr=b&sp=r&sig=%2B5dGWChLCyz7cE%2B1Os4qONWaca8m1p226BomVp0aNSY%3D) ## إزالة مسؤول تمكنك واجهة برمجة التطبيقات لتكوين `removeAdmin` من حذف مسؤول من الحساب. ### إزالة مسؤول الوسائط - معرف الحساب (إلزامي) - معرف المسؤول (إلزامي) ### مثال على واجهة برمجة التطبيقات لإزالة مسؤول ```plaintext mutation  {  admin(accountId:"XXX") {    removeAdmin(adminID:YYY    ) {        adminID    }  } } ``` ## مسؤولو واجهة برمجة المؤشر للقراءة فقط يُرجع الاستعلام عن واجهة برمجة التطبيقات للقراءة فقط `admins` البيانات المتعلقة بجميع المسؤولين في الحساب، بما في ذلك: المعرف، البريد الإلكتروني، الاسم الأول، الأسم الأخير، passwordNeverExpires، mfaEnabled، والأدوار. ### مسؤولو إدخال المعالم - معرف الحساب (إلزامي) ### وسائط مسؤولو أرجومنت - المعرف: معرف Cato للمسؤول - الاسم الأول: الاسم الأول للمسؤول - الاسم الأخير: الاسم الأخير للمسؤول - البريد الإلكتروني: عنوان البريد الإلكتروني - كلمة المرور لا تنتهي صلاحيتها أبدًا: قيمة منطقية (صح/خطأ). إذا تم تعيين القيمة على **صح**، فلن تنتهي صلاحية كلمة مرور المسؤول أبدًا - تمكين المصادقة المتعددة العوامل (MFA): قيمة منطقية (صح/خطأ). إذا تم تعيين القيمة على **صح**، يجب على المسؤول استخدام رمز MFA لتسجيل الدخول إلى تطبيق إدارة كاتو - الأدوار المدارة: مصفوفة من updateAdminRoleInput. يحدد دور أو أكثر الذي يتم تعيينه للمسؤول. بالنسبة لمسؤولي البائعين، يحدد هذا الحقل الأدوار التي تم تعيينها للمسؤول لحسابات المدارة. - أدوار بائع: مصفوفة من updateAdminRoleInput (متعلق فقط بمسؤولي البائعين). يعرف الأدوار التي تم تعيينها للمسؤول لحساب البائع. ### مثال على واجهة برمجة واجهة للمسؤولين ```plaintext query {  admins(accountID: XXXX) {    items {      id      email      firstName      lastName      modifyDate      creationDate      passwordNeverExpires      mfaEnabled      managedRoles {        role {          id          name        } resellerRoles {        role {          id          name        }      }    }  } } ``` ![admins.png](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/8788772828573(1).png?sv=2026-02-06&spr=https&st=2026-11-22T13%3A48%3A12Z&se=2026-11-22T14%3A48%3A12Z&sr=b&sp=r&sig=cVE5e7zMlqfv91KIj3ANCt0Ot1GfivSAlNsRdwG%2BWz0%3D) ## الحصول على تعديل مسؤول لقراءة فقط لواجهة برمجة التطبيقات يُرجع الاستعلام عن واجهة برمجة التطبيقات للقراءة فقط `getAdmin` معلومات حول مسؤول حساب مفرد، مثل: البريد الإلكتروني، الاسم الأول، الاسم الأخير، passwordNeverExpires، mfaEnabled، والأدوار ### الحصول على إدخال معالم مسؤول - معرف الحساب (إلزامي) - معرف المسؤول (إلزامي) ### الحصول على وسيطات تعديل المسؤول - الاسم الأول: الاسم الأول للمسؤول - الاسم الأخير: الاسم الأخير للمسؤول - البريد الإلكتروني: عنوان البريد الإلكتروني - كلمة المرور لا تنتهي صلاحيتها أبدًا: قيمة منطقية (صح/خطأ). إذا تم تعيينها على صح، فلن تنتهي صلاحية كلمة مرور المسؤول أبدًا - تمكين المصادقة المتعددة العوامل (MFA): قيمة منطقية (صح/خطأ). إذا تم تعيينها على صح، يجب على المسؤول استخدام رمز MFA لتسجيل الدخول إلى تطبيق إدارة كاتو - الأدوار المدارة: مصفوفة من updateAdminRoleInput. يحدد دور أو أكثر الذي يتم تعيينه للمسؤول. بالنسبة لمسؤولي البائعين، يحدد هذا الحقل الأدوار التي تم تعيينها للمسؤول لحسابات المدارة. - أدوار بائع: مصفوفة من updateAdminRoleInput (متعلق فقط بمسؤولي البائعين). يحدد الأدوار التي تم تعيينها للمسؤول لحساب البائع. ### مثال على واجهة برمجة التطبيقات للحصول على المسؤول ```plaintext query {  getAdmin(accountId: "XXX", adminID: YYY) {    id    firstName    lastName    email    passwordNeverExpires    mfaEnabled    creationDate    managedRoles {      role {        id        name      }    }    resellerRoles {      role {        id        name      }    }  } } ``` ![getAdmin.png](https://support.catonetworks.com/hc/article_attachments/8788772860701) ## أدوار الحساب لواجهة برمجة التطبيقات لقراءة فقط يعيد الاستعلام عن واجهة برمجة التطبيقات للقراءة فقط `accountRoles` جميع الأدوار المحددة للحساب (سواء الأدوار المخصصة أو المعرفة مسبقًا). يتطلب للعملاء الذين يستخدمون واجهة برمجة التطبيقات `addAdmin`، لأن هذه الواجهة تظهر معرفات الأدوار (يستخدمها addAdmin API). ### إدخال معالم أدوار الحساب - معرف الحساب - accountType - العادي (للأدوار العادية أو حسابات المدارة) - بائع (للأدوار حسابات البائع) #### وسائط أدوار الحساب ```plaintext   المعرف: معرف ID! (معرف الدور)   الاسم: نص! (اسم الدور)   الوصف: نص (الوصف)   معرفة مسبقة: منطقية! (هل هي دور معرف مسبقًا أو مخصص) ``` | ![image4.png](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/8788772888605(1).png?sv=2026-02-06&spr=https&st=2026-11-22T13%3A48%3A12Z&se=2026-11-22T14%3A48%3A12Z&sr=b&sp=r&sig=%2Fp55R9VnpGX4XpUii%2BPN%2B435wn48sH3nYrUS8Rdz0Q4%3D) | | --- | ### مثال استعلام أدوار الحساب ```plaintext طلب{  accountRoles(accountID:XXX, accountType:REGULAR)  {    items    {      id      name      isPredefined      description    }    total  } } ``` ## تحديث تكوين واجهة برمجة التطبيقات لـ updateAdminRoleInput تمكنك واجهة برمجة التطبيقات لتكوين `updateAdminRoleInput` من تحديث الإعدادات لدور المسؤول لتطبيق إدارة Cato. ```plaintext إدخال updateAdminRoleInput {  الدور: updateAccountRoleInput!  الكيانات المسموح بها: [entityInput!] } ```