관리형 스토리지를 위한 매니페스트

local 및 sync 저장소 영역과 달리 managed 저장소 영역에는 다음과 같은 구조가 필요합니다. JSON 스키마로 선언되며 Chrome의 엄격한 유효성 검사를 거칩니다. 이 스키마는 "storage" 매니페스트 키의 "managed_schema" 속성으로 표시된 파일을 포함하고 엔터프라이즈 정책

정책은 옵션과 유사하지만 시스템 관리자가 구성하여 정책에 따라 설치된 확장 프로그램에 대해 조직의 모든 사용자에게 적용됩니다 Chrome에서 정책을 처리하는 방법의 예를 참고하세요. Chrome 자체에서 찾을 수 있습니다.

정책을 선언한 후 storage.managed API에서 정책을 읽을 수 있습니다. 이것은 확장 프로그램을 사용하여 관리자가 구성한 정책을 시행할 수 있습니다.

샘플 manifest.json

storage.managed_schema 속성은 정책을 포함하는 확장 프로그램 내의 파일을 나타냅니다. 사용할 수 있습니다

{
  "name": "My enterprise extension",
  "storage": {
    "managed_schema": "schema.json"
  },
  ...
}

그러면 Chrome은 기본 운영체제와 표시됩니다. storage.onChanged 이벤트는 정책 변경이 감지될 때마다 실행됩니다. Chrome이 로드한 정책은 chrome://policy에서 확인할 수 있습니다.

스키마 형식

JSON 스키마 형식에는 Chrome의 몇 가지 추가 요구사항이 있습니다.

• 최상위 스키마는 object 유형이어야 합니다.
• 최상위 object는 additionalProperties을 포함할 수 없습니다. 선언된 properties는 정책입니다.
• 각 스키마에는 $ref 값 또는 정확히 하나의 type가 있어야 합니다.

스키마가 잘못된 경우 Chrome은 확장 프로그램을 로드하지 않고 스키마가 검증되지 않았습니다 정책 값이 스키마를 준수하지 않으면 storage.managed API에서 게시되었습니다.

샘플 스키마

{
  "type": "object",

  // "properties" maps an optional key of this object to its schema. At the
  // top-level object, these keys are the policy names supported.
  "properties": {

    // The policy name "AutoSave" is mapped to its schema, which in this case
    // declares it as a simple boolean value.
    // "title" and "description" are optional and are used to show a
    // user-friendly name and documentation to the administrator.
    "AutoSave": {
      "title": "Automatically save changes.",
      "description": "If set to true then changes will be automatically saved.",
      "type": "boolean"
    },

    // Other simple types supported include "integer", "string" and "number".
    "PollRefreshRate": {
      "type": "integer"
    },

    "DefaultServiceUrl": {
      "type": "string"
    },

    // "array" is a list of items that conform to another schema, described
    // in "items". An example to this schema is [ "one", "two" ].
    "ServiceUrls": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },

    // A more complex example that describes a list of bookmarks. Each bookmark
    // has a "title", and can have a "url" or a list of "children" bookmarks.
    // The "id" attribute is used to name a schema, and other schemas can reuse
    // it using the "$ref" attribute.
    "Bookmarks": {
      "type": "array",
      "id": "ListOfBookmarks",
      "items": {
        "type": "object",
        "properties": {
          "title": { "type": "string" },
          "url": { "type": "string" },
          "children": { "$ref": "ListOfBookmarks" }
        }
      }
    },

    // An "object" can have known properties listed as "properties", and can
    // optionally have "additionalProperties" indicating a schema to apply to
    // keys that aren't found in "properties".
    // This example policy could map a URL to its settings. An example value:
    // {
    //   "youtube.com": {
    //     "blocklisted": true
    //   },
    //   "google.com": {
    //     "bypass_proxy": true
    //   }
    // }
    "SettingsForUrls": {
      "type": "object",
      "additionalProperties": {
        "type": "object",
        "properties": {
          "blocklisted": { "type": "boolean" },
          "bypass_proxy": { "type": "boolean" }
        }
      }
    }
  }
}