مخططات السياسات

يتم تمثيل سياسات Chrome في صورة مخطّطات السياسات من خلال Schema Service API. لكل مخطط سياسة اسم فريد لتعريفه، وتعريف لحقول الإعدادات وأنواعها، ووصف يمكن قراءته عن الإعدادات باللغة الإنجليزية.

على سبيل المثال، نوضّح في ما يلي كيفية تمثيل Schema Service API لإعداد يسمح لزر تسجيل الخروج بالظهور في لوحة النظام في Chrome. يمكن تمثيل هذا الإعداد المبسّط bool showLogoutButtonInTray. انقر على "عرض مثال" أدناه لمعرفة كيف تمثل واجهة برمجة تطبيقات خدمة Schema هذا الإعداد.

عرض مثال

{
  "name": "customers/C0202nabg/policySchemas/chrome.users.ShowLogoutButton",
  "policyDescription": "Show logout button in tray.", // description of the policy
  "definition": { // definition of the settings (fields names and types)
    "messageType": [
      {
        "name": "ShowLogoutButton",
        "field": [
          {
            "name": "showLogoutButtonInTray", // the setting showLogoutButtonInTray
            "number": 1,
            "label": "LABEL_OPTIONAL",
            "type": "TYPE_BOOL" // the setting showLogoutButtonInTray is of type boolean
          }
        ]
      }
    ]
  },
  "fieldDescriptions": [ // human readable descriptions of the settings and their values
    {
      "field": "showLogoutButtonInTray",
      "knownValueDescriptions": [
        {
          "value": "true",
          "description": "Show logout button in tray." // description for showLogoutButtonInTray=true
        },
        {
          "value": "false",
          "description": "Do not show logout button in tray." // description for showLogoutButtonInTray=false
        }
      ]
    }
  ],
  "schemaName": "chrome.users.ShowLogoutButton" //  unique name to identify the policy
}
  

أسماء مخططات السياسات

name للمخطط هو معرّفه الفريد، بالتنسيق التالي: {namespace}.{leafName}.

في المثال أعلاه، اسم المخطط الكامل هو chrome.users.ShowLogoutButton. مساحة الاسم هي chrome.users. واسم الورقة هو ShowLogoutButton.

يتم تجميع السياسات ذات النطاق المشابه ضمن مساحة الاسم نفسها. على سبيل المثال، تبدأ جميع مخططات سياسات المستخدم بمساحة الاسم chrome.users.، وتكون جميع مخططات سياسات الطابعات مسبوقة بمساحة الاسم chrome.printers..

مساحات الاسم

مساحة الاسم	المفتاح	إذن دور المشرف المطلوب
chrome.users.LEAF_NAME		الخدمات > إدارة Chrome > الإعدادات > إدارة إعدادات المستخدمين
chrome.users.apps.LEAF_NAME	key="app_id"	الخدمات > إدارة Chrome > الإعدادات > إدارة إعدادات المستخدمين > إدارة إعدادات التطبيقات
chrome.users.appsconfig.LEAF_NAME		الخدمات > إدارة Chrome > الإعدادات > إدارة إعدادات المستخدمين > إدارة إعدادات التطبيقات
chrome.devices.LEAF_NAME		الخدمات > إدارة Chrome > الإعدادات > إدارة إعدادات أجهزة ChromeOS
chrome.devices.managedguest.LEAF_NAME		الخدمات > إدارة Chrome > الإعدادات > إدارة إعدادات أجهزة ChromeOS
chrome.devices.managedguest.apps.LEAF_NAME	key="app_id"	الخدمات > إدارة Chrome > الإعدادات > إدارة إعدادات أجهزة ChromeOS
chrome.devices.kiosk.LEAF_NAME		الخدمات > إدارة Chrome > الإعدادات > إدارة إعدادات أجهزة ChromeOS
chrome.devices.kiosk.apps.LEAF_NAME	key="app_id"	الخدمات > إدارة Chrome > الإعدادات > إدارة إعدادات أجهزة ChromeOS
chrome.devices.kiosk.appsconfig.LEAF_NAME	key="app_id"	الخدمات > إدارة Chrome > الإعدادات > إدارة إعدادات أجهزة ChromeOS
chrome.printers.LEAF_NAME	key="printer_id"	الخدمات > إدارة Chrome > الإعدادات > إدارة الطابعات
chrome.printservers.LEAF_NAME	key="print_server_id"	الخدمات > إدارة Chrome > الإعدادات > إدارة الطابعات
chrome.networks.globalsettings.LEAF_NAME		الخدمات > إعدادات الجهاز المشترك
chrome.networks.wifi.LEAF_NAME	key="network_id"	الخدمات > إعدادات الجهاز المشترك
chrome.networks.ethernet.LEAF_NAME	key="network_id"	الخدمات > إعدادات الجهاز المشترك
chrome.networks.vpn.LEAF_NAME	key="network_id"	الخدمات > إعدادات الجهاز المشترك
chrome.networks.certificates.LEAF_NAME	key="network_id"	الخدمات > إعدادات الجهاز المشترك

ملاحظة: يمكنك منح أدوار المشرف مباشرةً إلى حساب خدمة.

مفاتيح مخطط السياسة

تتطلّب بعض السياسات سياقًا إضافيًا ليتم عرضها أو تعديلها. مثال:

• لتعديل سياسة أحد التطبيقات، عليك تحديد التطبيق من خلال تعبئة key="app_id".
• لتعديل سياسة إعدادات الطابعة في وحدة تنظيمية، عليك تحديد الطابعة من خلال تعبئة key="printer_id".

تحتوي مخطّطات السياسات هذه على قسم additionalTargetKeyNames يصف المفاتيح والقيم التي سيتم تمريرها في طلبات البيانات من واجهة برمجة التطبيقات.

لمزيد من التفاصيل، يمكنك الانتقال إلى مقالة نماذج التعليمات البرمجية.

عرض مثال

{
  "name": "customers/C0202nabg/policySchemas/chrome.printers.AllowForUsers",
  "policyDescription": "Allows a printer for users in a given organization.",
  "additionalTargetKeyNames": [
    {
      "key": "printer_id",
      "keyDescription": "Id of printer as visible in Admin SDK printers API."
    }
  ],
  "definition": {
    "messageType": [
      {
        "name": "AllowForUsers",
        "field": [
          {
            "name": "allowForUsers",
            "number": 1,
            "label": "LABEL_OPTIONAL",
            "type": "TYPE_BOOL"
          }
        ]
      }
    ]
  },
  "fieldDescriptions": [
    {
      "field": "allowForUsers",
      "description": "Controls whether a printer is allowed for users in a given organization."
    }
  ],
  "schemaName": "chrome.printers.AllowForUsers"
}
  

سياسات التطبيقات

بعض مساحات الاسم أعلاه مخصّصة لسياسة التطبيقات، مثل سياسات تطبيقات المستخدمين، وتطبيقات Kiosk، وتطبيقات جلسات الضيوف المُدارة، وسياسات ضبط تطبيقات Kiosk. تتطلب سياسات التطبيقات سمة app_id.

يتكوّن app_id من خلال الجمع بين نوع التطبيق ومعرّفه. مثال:

• يمثل chrome:mkaakpdehdafacodkgkpghoibnmamcme تطبيق Chrome "رسومات Google"
• يمثّل android:com.google.android.calendar تطبيق "تقويم Google" المتوافق مع Android.
• يمثل web:https://canvas.apps.chrome تطبيق الويب "لوحة الرسم"

الحقول المتعدّدة القيم

تمثّل الحقول التي تحمل التصنيف LABEL_REPEATED حقولاً متعددة القيم، مثل القوائم أو الصفائف. يمكنك تحديد قيم متعددة لهذه الحقول. لمزيد من التفاصيل، يمكنك الاطّلاع على نماذج التعليمات البرمجية.

حالة مخطط السياسة

تتضمّن كل سياسة عنصر policyApiLifecycle لتمثيل حالتها الحالية. يحتوي هذا العنصر على الحقول التالية مع تفاصيل عن حالة السياسة:

• ويعرض حقل policyApiLifecycleStage المراحل الواردة في الجدول التالي التي تصف الحالة الراهنة للسياسة بشكل أفضل.
• يقدّم الحقل description مزيدًا من التفاصيل عن الحالة الحالية لهذه السياسة.
• يعرض الحقل endSupport التاريخ النهائي المؤيّد للسياسة في حال تحديد تاريخ.
• لا يمكن ضبط deprecatedInFavorOf إلا إذا كانت policyApiLifecycleStage API_DEPRECATED. وهي تعرض مساحات الاسم المؤهلة بالكامل للسياسات الجديدة التي تم إيقاف السياسة الحالية لصالحها.
• يتجاوب الحقل scheduledToDeprecatePolicies مع deprecatedInFavorOf. وهي تعرض مساحات الاسم المؤهلة بالكامل للسياسات القديمة التي سيتم إيقافها بسبب طرح هذه السياسة.

مراحل دورة الحياة

مسرح	الوصف
API_UNSPECIFIED	الحالة الحالية للسياسة غير معروفة. محجوزة، لا تستخدمها.
API_PREVIEW	تعذّر تطبيق السياسة حتى الآن. يمكن نقل هذه المرحلة إلى "API_CURRENT" أو "API_DEVELOPMENT".
API_DEVELOPMENT	لم يتم وضع اللمسات الأخيرة على السياسة بعد، وقد يتم إدخال تغييرات قد تؤدي إلى أعطال. يمكن نقل هذه المرحلة إلى "API_CURRENT" أو "API_DEPRECATED".
API_CURRENT	السياسة بتنسيق رسمي، ولكن قد يتم إدخال تغييرات غير نهائية. يمكن نقل هذه المرحلة إلى "API_DEPRECATED".
API_DEPRECATED	تم إيقاف هذه السياسة نهائيًا وقد تتم إزالتها في المستقبل. يجب أن يتوقف المشرفون عن استخدام هذه السياسة.

عرض مثال

{
  "name": "customers/C0202nabg/policySchemas/chrome.users.OutdatedPolicy",
  "policyDescription": "Just for demo, this is an outdated policy.",
  "definition": {
    "messageType": [
      {
        "name": "OutdatedPolicy",
        "field": [
          {
            "name": "outdatedField",
            "number": 1,
            "label": "LABEL_OPTIONAL",
            "type": "TYPE_BOOL"
          }
        ]
      }
    ]
  },
  "fieldDescriptions": [
    {
      "field": "outdatedField",
      "description": "This is an outdated field"
    }
  ],
  "schemaName": "chrome.users.OutdatedPolicy",
  "policyApiLifecycle": { // policy's current lifecycle status
    "policyApiLifecycleStage": "API_DEPRECATED",
    "description": "This policy is deprecated. Please stop using it",
    "endSupport": {
      "year": 2021,
      "month": 2,
      "day": 29
    }
    "deprecatedInFavorOf": "chrome.users.NewPolicy"
  }
}

{
  "name": "customers/C0202nabg/policySchemas/chrome.users.NewPolicy",
  "policyDescription": "Just for demo, this is a new policy.",
  "definition": {
    "messageType": [
      {
        "name": "NewPolicy",
        "field": [
          {
            "name": "newField",
            "number": 1,
            "label": "LABEL_OPTIONAL",
            "type": "TYPE_BOOL"
          }
        ]
      }
    ]
  },
  "fieldDescriptions": [
    {
      "field": "newField",
      "description": "This is an new field"
    }
  ],
  "schemaName": "chrome.users.NewPolicy",
  "policyApiLifecycle": { // policy's current lifecycle status
    "policyApiLifecycleStage": "API_CURRENT,
    "scheduledToDeprecatePolicies": "chrome.users.OutdatedPolicy"
  }
}
  

إشعارات مخطط السياسات

تم ربط سياسة notices ببعض السياسات بها والتي تم ضبط acknowledgement_required على true لقيم معيّنة لحقول سياسات معيّنة. بالنسبة إلى هذه السياسات، عليك ضبط حقل إقرار خاص على true قبل أن تتمكّن من ضبط القيمة.

لمزيد من التفاصيل، يمكنك الاطّلاع على نماذج الرموز.

المنصّات المعتمدة

supportedPlatforms هي قائمة تشير إلى أنّ السياسة لن تسري إلا على الأجهزة أو المستخدمين على هذه الأنظمة الأساسية. يتم سرد جميع المنصات المتوافقة في الجدول التالي.

المنصّة المتوافقة

النظام الأساسي	الوصف
PLATFORM_UNSPECIFIED	نظام أساسي غير محدَّد. محجوزة، لا تستخدمها.
CHROME_OS	ChromeOS
CHROME_BROWSER	متصفِّح Chrome لنظام التشغيل macOS/Windows/Linux
CHROME_BROWSER_FOR_ANDROID	متصفح Chrome لنظام التشغيل Android
CHROME_BROWSER_FOR_IOS	متصفح Chrome لنظام التشغيل iOS

الخطوات التالية

• تفعيل Chrome Policy API وتفويض الطلبات
• سرد مخططات السياسات من خلال واجهة برمجة التطبيقات