Giản đồ chính sách

Các chính sách của Chrome được biểu thị dưới dạng lược đồ chính sách bằng Schema Service API. Mỗi giản đồ chính sách có một tên duy nhất để xác định, định nghĩa về các trường cài đặt và loại của các trường đó và một nội dung mô tả các chế độ cài đặt mà con người có thể đọc được bằng tiếng Anh.

Ví dụ: bên dưới là cách Schema Service API biểu thị chế độ cài đặt cho phép nút đăng xuất xuất hiện trong khay hệ thống của Chrome. Cách trình bày đơn giản hoá của chế độ cài đặt này sẽ là bool showLogoutButtonInTray. Hãy nhấp vào "Hiển thị ví dụ" bên dưới để xem cách API Dịch vụ giản đồ thể hiện chế độ cài đặt này.

Hiển thị ví dụ

{
  "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
}
  

Tên giản đồ chính sách

name của giản đồ là giá trị nhận dạng duy nhất, có định dạng sau: {namespace}.{leafName}.

Trong ví dụ trên, tên đầy đủ của giản đồ là chrome.users.ShowLogoutButton. Không gian tên là chrome.users. và tên lá là ShowLogoutButton.

Các chính sách có phạm vi tương tự được nhóm trong cùng một không gian tên. Ví dụ: tất cả giản đồ chính sách người dùng đều có tiền tố là không gian tên chrome.users., còn tất cả giản đồ chính sách máy in đều có tiền tố là không gian tên chrome.printers..

Không gian tên

Không gian tên	Khoá	Quyền bắt buộc của vai trò quản trị viên
chrome.users.LEAF_NAME		Dịch vụ > Quản lý Chrome > Cài đặt > Quản lý chế độ cài đặt người dùng
chrome.users.apps.LEAF_NAME	key="app_id"	Dịch vụ > Quản lý Chrome > Cài đặt > Quản lý chế độ cài đặt người dùng > Quản lý chế độ cài đặt ứng dụng
chrome.users.appsconfig.LEAF_NAME		Dịch vụ > Quản lý Chrome > Cài đặt > Quản lý chế độ cài đặt người dùng > Quản lý chế độ cài đặt ứng dụng
chrome.devices.LEAF_NAME		Dịch vụ > Quản lý Chrome > Cài đặt > Quản lý chế độ cài đặt thiết bị ChromeOS
chrome.devices.managedguest.LEAF_NAME		Dịch vụ > Quản lý Chrome > Cài đặt > Quản lý chế độ cài đặt thiết bị ChromeOS
chrome.devices.managedguest.apps.LEAF_NAME	key="app_id"	Dịch vụ > Quản lý Chrome > Cài đặt > Quản lý chế độ cài đặt thiết bị ChromeOS
chrome.devices.kiosk.LEAF_NAME		Dịch vụ > Quản lý Chrome > Cài đặt > Quản lý chế độ cài đặt thiết bị ChromeOS
chrome.devices.kiosk.apps.LEAF_NAME	key="app_id"	Dịch vụ > Quản lý Chrome > Cài đặt > Quản lý chế độ cài đặt thiết bị ChromeOS
chrome.devices.kiosk.appsconfig.LEAF_NAME	key="app_id"	Dịch vụ > Quản lý Chrome > Cài đặt > Quản lý chế độ cài đặt thiết bị ChromeOS
chrome.printers.LEAF_NAME	key="printer_id"	Dịch vụ > Quản lý Chrome > Cài đặt > Quản lý máy in
chrome.printservers.LEAF_NAME	key="print_server_id"	Dịch vụ > Quản lý Chrome > Cài đặt > Quản lý máy in
chrome.networks.globalsettings.LEAF_NAME		Dịch vụ > Cài đặt thiết bị dùng chung
chrome.networks.wifi.LEAF_NAME	key="network_id"	Dịch vụ > Cài đặt thiết bị dùng chung
chrome.networks.ethernet.LEAF_NAME	key="network_id"	Dịch vụ > Cài đặt thiết bị dùng chung
chrome.networks.vpn.LEAF_NAME	key="network_id"	Dịch vụ > Cài đặt thiết bị dùng chung
chrome.networks.certificates.LEAF_NAME	key="network_id"	Dịch vụ > Cài đặt thiết bị dùng chung

Lưu ý: Bạn có thể chỉ định trực tiếp vai trò quản trị viên cho một tài khoản dịch vụ.

Khoá giản đồ chính sách

Một số chính sách yêu cầu thêm bối cảnh thì mới có thể xem hoặc sửa đổi được. Ví dụ:

• Để sửa đổi chính sách cho một ứng dụng, bạn cần chỉ định ứng dụng nào bằng cách điền key="app_id".
• Để sửa đổi chính sách cho chế độ cài đặt máy in trong một đơn vị tổ chức, bạn cần chỉ định máy in nào bằng cách điền sẵn key="printer_id".

Các giản đồ chính sách này chứa một phần additionalTargetKeyNames mô tả các khoá và giá trị sẽ được truyền trong yêu cầu API.

Để biết thêm thông tin chi tiết, hãy chuyển đến phần Mã mẫu.

Hiển thị ví dụ

{
  "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"
}
  

Chính sách ứng dụng

Một số không gian tên ở trên dành cho chính sách ứng dụng, chẳng hạn như Ứng dụng người dùng, Ứng dụng kiosk, Ứng dụng phiên khách được quản lý và chính sách Cấu hình ứng dụng kiosk. Chính sách ứng dụng yêu cầu app_id.

app_id được tạo bằng cách kết hợp loại ứng dụng và giá trị nhận dạng ứng dụng. Ví dụ:

• chrome:mkaakpdehdafacodkgkpghoibnmamcme đại diện cho Ứng dụng Chrome "Google Bản vẽ"
• android:com.google.android.calendar đại diện cho ứng dụng "Lịch Google" trên Android
• web:https://canvas.apps.chrome đại diện cho ứng dụng web "Canvas"

Trường nhiều giá trị

Các trường có nhãn LABEL_REPEATED đại diện cho các trường có nhiều giá trị, chẳng hạn như danh sách hoặc mảng. Bạn có thể cung cấp một vài giá trị cho các trường này. Để biết thêm thông tin chi tiết, hãy xem phần Mã mẫu.

Trạng thái của giản đồ chính sách

Mỗi chính sách đều có một đối tượng policyApiLifecycle để thể hiện trạng thái hiện tại của chính sách. Đối tượng này chứa các trường sau đây với thông tin chi tiết về trạng thái của chính sách:

• Trường policyApiLifecycleStage cho thấy giai đoạn nào trong bảng sau đây mô tả đúng nhất trạng thái hiện tại của chính sách.
• Trường description cung cấp thêm thông tin chi tiết về trạng thái hiện tại của chính sách này.
• Trường endSupport hiển thị ngày hỗ trợ cuối cùng cho chính sách (nếu đã xác định).
• Bạn chỉ có thể đặt deprecatedInFavorOf nếu policyApiLifecycleStage là API_DEPREN. Thông tin này cho biết(các) không gian tên đủ điều kiện của các chính sách mới mà chính sách hiện tại đã ngừng sử dụng.
• Trường scheduledToDeprecatePolicies tương ứng với KHÔNG dùng nữaInFavorOf. Thông tin này cho thấy(các) không gian tên đủ điều kiện của các chính sách cũ sẽ không được dùng nữa do sự ra mắt của chính sách này.

Các giai đoạn trong vòng đời

Sân khấu	Nội dung mô tả
API_UNSPECIFIED	Trạng thái hiện tại của chính sách là không xác định. Đặt trước, không sử dụng.
API_PREVIEW	Chính sách chưa hoạt động. Giai đoạn này có thể chuyển sang API_CURRENT hoặc API_DEVELOPMENT.
API_DEVELOPMENT	Chính sách chưa hoàn tất và có thể áp dụng các thay đổi có thể gây lỗi. Giai đoạn này có thể chuyển sang API_CURRENT hoặc API_DEPRECATED.
API_CURRENT	Chính sách có định dạng chính thức nhưng có thể đưa ra nội dung thay đổi không gây lỗi. Giai đoạn này có thể chuyển sang API_DEPRECATED.
API_DEPRECATED	Chính sách này không còn được dùng nữa và có thể sẽ bị loại bỏ trong tương lai. Quản trị viên nên ngừng sử dụng chính sách này.

Hiển thị ví dụ

{
  "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"
  }
}
  

Thông báo giản đồ chính sách

Một số chính sách liên kết với notices và có acknowledgement_required được đặt thành true cho một số giá trị nhất định của một số trường chính sách nhất định. Đối với các chính sách này, bạn cần đặt một trường xác nhận đặc biệt thành true trước khi có thể đặt giá trị.

Để biết thêm chi tiết, hãy xem phần Mã mẫu.

Nền tảng được hỗ trợ

supportedPlatforms là một danh sách cho biết chính sách này sẽ chỉ áp dụng cho các thiết bị hoặc người dùng trên các nền tảng này. Tất cả nền tảng được hỗ trợ được liệt kê trong bảng sau.

Nền tảng được hỗ trợ

Nền tảng	Nội dung mô tả
PLATFORM_UNSPECIFIED	Nền tảng chưa được chỉ định. Đặt trước, không sử dụng.
CHROME_OS	ChromeOS
CHROME_BROWSER	Trình duyệt Chrome cho macOS/Windows/Linux
CHROME_BROWSER_FOR_ANDROID	Trình duyệt Chrome dành cho Android
CHROME_BROWSER_FOR_IOS	Trình duyệt Chrome dành cho iOS

Các bước tiếp theo

• Bật API Chính sách của Chrome và cho phép các yêu cầu
• Liệt kê các giản đồ chính sách bằng API