Mã mẫu cho chính sách ứng dụng

Các yêu cầu dưới đây minh hoạ hoạt động quản lý chính sách bằng API Chính sách bằng cách sử dụng làm ví dụ. Trước khi bắt đầu, hãy đảm bảo bạn xem xét Tổng quan về API Chính sách Chrome và Hướng dẫn về giản đồ chính sách.

Tất cả yêu cầu được trình bày dưới đây đều sử dụng các biến sau:

• $TOKEN – Mã thông báo OAuth 2
• $CUSTOMER – Mã khách hàng hoặc giá trị cố định my_customer

Buộc cài đặt ứng dụng

Các ví dụ sau dành cho Đơn vị tổ chức. Yêu cầu Nhóm sẽ là giống nhau, ngoại trừ targetResource sẽ có "groups/" thay vì "orgunits/" trước mã nhận dạng.

Ở đây, chúng ta sẽ đặt ứng dụng Google Bản vẽ thành buộc cài đặt:

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -d '{
        requests: [{
                policyTargetKey: {
                        targetResource: "orgunits/04fatzly4jbjho9",
                        additionalTargetKeys: {"app_id": "chrome:mkaakpdehdafacodkgkpghoibnmamcme"}
                        },
                policyValue: {
                        policySchema: "chrome.users.apps.InstallType",
                        value: {appInstallType: "FORCED"}
                        },
                updateMask: {paths: "appInstallType"}
                }]
      }' \
  "https://chromepolicy.googleapis.com/v1/customers/$CUSTOMER/policies/orgunits:batchModify"

Phản hồi thành công phải trống:

{}

Ví dụ này dành cho Ứng dụng của người dùng. Yêu cầu của Phiên khách được quản lý sẽ là giống hệt nhau ngoại trừ giản đồ chính sách sẽ chrome.devices.managedguest.apps.InstallType. Chính sách tương đương đối với Ứng dụng Kiosk yêu cầu như sau:

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -d '{
        requests: [{
                policyTargetKey: {
                        targetResource: "orgunits/04fatzly4jbjho9",
                        additionalTargetKeys: {"app_id": "chrome:mkaakpdehdafacodkgkpghoibnmamcme"}
                        },
                policyValue: {
                        policySchema: "chrome.devices.kiosk.apps.ForceInstall",
                        value: {forceInstall: false}
                        },
                updateMask: {paths: "forceInstall"}
                }]
      }' \
  "https://chromepolicy.googleapis.com/v1/customers/$CUSTOMER/policies/orgunits:batchModify"

Phản hồi thành công phải trống:

{}

Xoá ứng dụng

Bạn phải xoá một ứng dụng tại Đơn vị tổ chức nơi ứng dụng đó đang lưu trữ được thêm một cách rõ ràng để quản lý. Khi gọi lệnh phân giải, trường này addedSourceKey chứa Đơn vị tổ chức nơi đơn vị tổ chức được thêm vào Google Cloud. Nói cách khác, delete chỉ nên được gọi cho những ứng dụng mà Đơn vị tổ chức trong addedSourceKey bằng với đơn vị tổ chức trong policyTargetKey.

Để xoá một ứng dụng (tức là xoá ứng dụng khỏi hoạt động quản lý), bạn nên gửi một yêu cầu batchInherit, trong đó policySchema là giản đồ cho phương thức đã cho loại ứng dụng, có dấu hoa thị (*) thay cho một chính sách cụ thể. Trong ví dụ này, chúng ta đang xoá ứng dụng Google Bản vẽ, được cài đặt tại "04fatzly4livjho9" Đơn vị tổ chức:

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -d '{
        requests: [{
                policyTargetKey: {
                        targetResource: "orgunits/04fatzly4jbjho9",
                        additionalTargetKeys: {"app_id": "chrome:gbchcmhmhahfdphkhkmpfmihenigjmpp"}
                        },
                policySchema: "chrome.users.apps.*",
                }]
      }' \
  "https://chromepolicy.googleapis.com/v1/customers/$CUSTOMER/policies/orgunits:batchInherit"

Phản hồi thành công phải trống:

{}

Các yêu cầu xoá ứng dụng Kiosk và ứng dụng Phiên khách được quản lý sẽ sử dụng chrome.devices.kiosk.apps.\* và chrome.devices.managedguest.apps.\* giản đồ tương ứng.

Nhận chính sách cài đặt ứng dụng cho một ứng dụng trong đơn vị tổ chức

Để tạo chính sách cho một ứng dụng cụ thể, bạn phải chỉ định cả chính sách và mã ứng dụng trong yêu cầu. Trong ví dụ này, chúng ta sẽ đọc giá trị của InstallType chính sách dành cho ứng dụng Google Bản vẽ:

Yêu cầu

  curl -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -d '{
        policyTargetKey: {
          targetResource: "orgunits/04fatzly4jbjho9",
          additionalTargetKeys: {"app_id": "chrome:mkaakpdehdafacodkgkpghoibnmamcme"}
        },
        policySchemaFilter: "chrome.users.apps.InstallType"
    }' \
  "https://chromepolicy.googleapis.com/v1/$CUSTOMER/C02l1chq7/policies:resolve"

Phản hồi

{
  "resolvedPolicies": [
    {
      "targetKey": {
        "targetResource": "orgunits/04fatzly4jbjho9",
        "additionalTargetKeys": {
          "app_id": "chrome:mkaakpdehdafacodkgkpghoibnmamcme"
        }
      },
      "value": {
        "policySchema": "chrome.users.apps.InstallType",
        "value": {
          "appInstallType": "FORCED"
        }
      },
      "sourceKey": {
        "targetResource": "orgunits/04fatzly4jbjho9"
      },
      "addedSourceKey": {
        "targetResource": "orgunits/04fatzly4jbjho9"
      }
    }
  ]
}

Nhận chính sách cài đặt ứng dụng cho tất cả ứng dụng trong một đơn vị tổ chức

Nếu mã ứng dụng bị bỏ qua khỏi yêu cầu trong ví dụ trước, thì mã đó sẽ yêu cầu giá trị của chính sách InstallType cho tất cả ứng dụng trong đơn vị tổ chức đó.

Yêu cầu

  curl -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -d '{
        policyTargetKey: {
          targetResource: "orgunits/04fatzly4jbjho9",
        },
        policySchemaFilter: "chrome.users.apps.InstallType"
    }' \
  "https://chromepolicy.googleapis.com/v1/$CUSTOMER/C02l1chq7/policies:resolve"

Phản hồi

{
  "resolvedPolicies": [
    {
      "targetKey": {
        "targetResource": "orgunits/04fatzly4jbjho9",
        "additionalTargetKeys": {
          "app_id": "chrome:mkaakpdehdafacodkgkpghoibnmamcme"
        }
      },
      "value": {
        "policySchema": "chrome.users.apps.InstallType",
        "value": {
          "appInstallType": "FORCED"
        }
      },
      "sourceKey": {
        "targetResource": "orgunits/04fatzly4jbjho9"
      },
      "addedSourceKey": {
        "targetResource": "orgunits/04fatzly4jbjho9"
      }
    },
    {
      "targetKey": {
        "targetResource": "orgunits/04fatzly4jbjho9",
        "additionalTargetKeys": {
          "app_id": "chrome:fhcfdhnmhdkemdfdncjmgnanbekfmbab"
        }
      },
      "value": {
        "policySchema": "chrome.users.apps.InstallType",
        "value": {
          "appInstallType": "ALLOWED"
        }
      },
      "sourceKey": {
        "targetResource": "orgunits/04fatzly4jbjho9"
      },
      "addedSourceKey": {
        "targetResource": "orgunits/04fatzly4jbjho9"
      }
    },
    ...
  ]
}

Liệt kê tất cả các chính sách dành cho ứng dụng trong Đơn vị tổ chức

Giống như việc bạn có thể bỏ qua Mã ứng dụng khỏi yêu cầu truy xuất chính sách cho tất cả Ngoài ra, bạn cũng có thể xem tất cả các chính sách dành cho một ứng dụng bằng cách dùng ký tự đại diện trong . Trong ví dụ này, chúng ta đang lấy giá trị của tất cả các chính sách cho thuộc tính Ứng dụng Google Bản vẽ.

Yêu cầu

  curl -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -d '{
        policyTargetKey: {
          targetResource: "orgunits/04fatzly4jbjho9",
          additionalTargetKeys: {"app_id": "chrome:mkaakpdehdafacodkgkpghoibnmamcme"}
        },
        policySchemaFilter: "chrome.users.apps.*"
    }' \
  "https://chromepolicy.googleapis.com/v1/$CUSTOMER/C02l1chq7/policies:resolve"

Phản hồi

{
  "resolvedPolicies": [
    {
      "targetKey": {
        "targetResource": "orgunits/04fatzly4jbjho9",
        "additionalTargetKeys": {
          "app_id": "chrome:mkaakpdehdafacodkgkpghoibnmamcme"
        }
      },
      "value": {
        "policySchema": "chrome.users.apps.InstallType",
        "value": {
          "appInstallType": "FORCED"
        }
      },
      "sourceKey": {
        "targetResource": "orgunits/04fatzly4jbjho9"
      },
      "addedSourceKey": {
        "targetResource": "orgunits/04fatzly4jbjho9"
      }
    },
    {
      "targetKey": {
        "targetResource": "orgunits/04fatzly4jbjho9",
        "additionalTargetKeys": {
          "app_id": "chrome:mkaakpdehdafacodkgkpghoibnmamcme"
        }
      },
      "value": {
        "policySchema": "chrome.users.apps.IncludeInChromeWebStoreCollection",
        "value": {
          "includeInCollection": true
        }
      },
      "sourceKey": {
        "targetResource": "orgunits/04fatzly4jbjho9"
      },
      "addedSourceKey": {
        "targetResource": "orgunits/04fatzly4jbjho9"
      }
    },
    ...
  ]
}

Liệt kê tất cả các chính sách cho tất cả ứng dụng trong một Đơn vị tổ chức

Bạn có thể bỏ qua mã ứng dụng và có thể dùng ký tự đại diện trong chính sách để yêu cầu tất cả chế độ cài đặt ứng dụng cho mọi ứng dụng trong một đơn vị tổ chức.

Yêu cầu

  curl -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -d '{
        policyTargetKey: {
          targetResource: "orgunits/04fatzly4jbjho9"
        },
        policySchemaFilter: "chrome.users.apps.*"
    }' \
  "https://chromepolicy.googleapis.com/v1/$CUSTOMER/C02l1chq7/policies:resolve"

Phản hồi

{
  "resolvedPolicies": [
    {
      "targetKey": {
        "targetResource": "orgunits/04fatzly4jbjho9",
        "additionalTargetKeys": {
          "app_id": "chrome:mkaakpdehdafacodkgkpghoibnmamcme"
        }
      },
      "value": {
        "policySchema": "chrome.users.apps.InstallType",
        "value": {
          "appInstallType": "FORCED"
        }
      },
      "sourceKey": {
        "targetResource": "orgunits/04fatzly4jbjho9"
      },
      "addedSourceKey": {
        "targetResource": "orgunits/04fatzly4jbjho9"
      }
    },
    {
      "targetKey": {
        "targetResource": "orgunits/04fatzly4jbjho9",
        "additionalTargetKeys": {
          "app_id": "chrome:mkaakpdehdafacodkgkpghoibnmamcme"
        }
      },
      "value": {
        "policySchema": "chrome.users.apps.IncludeInChromeWebStoreCollection",
        "value": {
          "includeInCollection": true
        }
      },
      "sourceKey": {
        "targetResource": "orgunits/04fatzly4jbjho9"
      },
      "addedSourceKey": {
        "targetResource": "orgunits/04fatzly4jbjho9"
      }
    },
    {
      "targetKey": {
        "targetResource": "orgunits/04fatzly4jbjho9",
        "additionalTargetKeys": {
          "app_id": "chrome:fhcfdhnmhdkemdfdncjmgnanbekfmbab"
        }
      },
      "value": {
        "policySchema": "chrome.users.apps.InstallType",
        "value": {
          "appInstallType": "ALLOWED"
        }
      },
      "sourceKey": {
        "targetResource": "orgunits/04fatzly4jbjho9"
      },
      "addedSourceKey": {
        "targetResource": "orgunits/04fatzly4jbjho9"
      }
    },
    {
      "targetKey": {
        "targetResource": "orgunits/04fatzly4jbjho9",
        "additionalTargetKeys": {
          "app_id": "chrome:fhcfdhnmhdkemdfdncjmgnanbekfmbab"
        }
      },
      "value": {
        "policySchema": "chrome.users.apps.CertificateManagement",
        "value": {
          "allowAccessToKeys": true
        }
      },
      "sourceKey": {
        "targetResource": "orgunits/04fatzly4jbjho9"
      },
      "addedSourceKey": {
        "targetResource": "orgunits/04fatzly4jbjho9"
      }
    },
    ...
  ]
}

Xoá tính năng AutoLaunchApp của Kiosk Appsconfig

Để xoá AutoLaunchApp, bạn có thể đặt appId thành "None".

Lưu ý rằng khi đặt appId thành "Không có", tất cả các chế độ cài đặt AutoLaunchApp khác sẽ được đặt thành giá trị mặc định. Mọi chế độ cài đặt AutoLaunchApp ngoài appId được gửi trong yêu cầu sẽ bị bỏ qua trong trường hợp này.

Yêu cầu

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -d '{
        requests: [{
                policyTargetKey: {
                        targetResource: "orgunits/04fatzly4jbjho9"
                        },
                policyValue: {
                        policySchema: "chrome.devices.kiosk.appsconfig.AutoLaunchApp",
                        value: {appId: "None"}
                        },
                updateMask: {paths: "appId"}
                }]
      }' \
  "https://chromepolicy.googleapis.com/v1/customers/$CUSTOMER/policies/orgunits:batchModify"

Phản hồi

Phản hồi thành công trống.

{}