Giản đồ chính sách

Chính sách Chrome được biểu thị dưới dạng giản đồ chính sách bởi Schema Service API. Mỗi giản đồ chính sách có một tên riêng để xác định. Đây là định nghĩa của chế độ cài đặt và loại của chúng, cũng như mô tả mà con người có thể đọc được về cài đặt trong Tiếng Anh.

Ví dụ: dưới đây là cách Schema Service API thể hiện một chế độ cài đặt cho phép nút đăng xuất xuất hiện trong khay hệ thống của Chrome. Một kiểu đơn giản giá trị biểu thị của chế độ cài đặt này sẽ là bool showLogoutButtonInTray. Nhấp chuột "Xem ví dụ" bên dưới để xem cách Schema Service API thể hiện điều này cài đặt.

{
  "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 như 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ự nhau được nhóm vào cùng một vùng chứa tên. Ví dụ: tất cả giản đồ chính sách người dùng có tiền tố là không gian tên chrome.users. và tất cả giản đồ chính sách máy in có tiền tố là không gian tên chrome.printers..

Không gian tên

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

Một số chính sách yêu cầu thêm ngữ cảnh để xem hoặc sửa đổi. 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 các chế độ cài đặt máy in trong một Đơn vị tổ chức, bạn cần phải chỉ định máy in bằng cách điền key="printer_id".

Các giản đồ chính sách này chứa mục additionalTargetKeyNames mô tả khoá và giá trị cần chuyển trong yêu cầu API.

Để biết thêm chi tiết, hãy truy cập vào Mã mẫu.

{
  "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 là dành cho chính sách ứng dụng, chẳng hạn như Ứng dụng của người dùng, Ứng dụng kiosk, Chính sách về các ứng dụng của phiên khách được quản lý và 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 thành 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 "Google Bản vẽ" Ứng dụng Chrome
• android:com.google.android.calendar biểu thị "Lịch Google" Ứng dụng cho Android
• web:https://canvas.apps.chrome đại diện cho "Canvas" Ứng dụng web

Trường nhiều giá trị

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

Trạng thái 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. Đối tượng này chứa các trường sau đây với thông tin chi tiết về chính sách trạng thái:

• Trường policyApiLifecycleStage hiển thị những giai đoạn nào trong những giai đoạn sau bảng 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 cho thấy ngày hỗ trợ chính sách cuối cùng (nếu có) được xác định.
• Bạn chỉ có thể thiết lập deprecatedInFavorOf nếu policyApiLifecycleLifecycle là API_ĐÃ NGỪNG HOẠT ĐỘNG. Trường này cho biết(các) không gian tên đủ điều kiện của chính sách mới mà chính sách hiện tại không được dùng nữa.
• Trường scheduledToDeprecatePolicies tương ứng với không dùngInFavorOf. Trường này cho biết(các) không gian tên đủ điều kiện của các chính sách sẽ không được dùng nữa do chính sách này ra mắt.

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

{
  "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 có notices được liên kết với các chính sách đó có acknowledgement_required đặt thành true đối với một số giá trị của một số trường chính sách. Đối với các chính sách này, bạn cần đặ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 thông tin chi tiết, hãy xem phần Mã mẫu.

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

supportedPlatforms là danh sách cho biết chính sách 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ó trong danh sách bảng sau.

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

Các bước tiếp theo

• Bật Chrome Policy API và uỷ quyền cho các yêu cầu
• Liệt kê giản đồ chính sách bằng API