저장소 영역에 관한 매니페스트

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

정책은 옵션과 유사하지만 사용자가 아닌 시스템 관리자가 구성합니다. 확장 프로그램을 조직의 모든 사용자를 위해 사전 구성할 수 있습니다. 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" }
        }
      }
    }
  }
}