매니페스트 - 샌드박스

경고: 버전 57부터 Chrome에서는 더 이상 샌드박스 처리된 페이지 내부에 외부 웹 콘텐츠 (삽입된 프레임 및 스크립트 포함)를 허용하지 않습니다. 대신 WebView를 사용하세요.

샌드박스 처리된 고유 출처에서 제공할 앱 또는 확장 프로그램 페이지 모음과 함께 사용할 콘텐츠 보안 정책(선택사항)을 정의합니다. 샌드박스에는 두 가지 의미가 있습니다.

1. 샌드박스 처리된 페이지는 확장 프로그램 또는 앱 API에 액세스할 수 없으며 샌드박스 처리되지 않은 페이지에 직접 액세스할 수 없습니다 (postMessage()를 통해 통신할 수 있음).

2. 샌드박스 처리된 페이지에는 앱 또는 확장 프로그램의 나머지 부분에서 사용하는 콘텐츠 보안 정책 (CSP)이 적용되지 않습니다 (별도의 CSP 값이 적용됨). 즉, 예를 들어 인라인 스크립트와 eval를 사용할 수 있습니다.

   예를 들어 다음은 맞춤 CSP를 통해 샌드박스에서 두 개의 확장 프로그램 페이지가 제공되도록 지정하는 방법입니다.

   {
     ...
     "sandbox": {
       "pages": [
         "page1.html",
         "directory/page2.html"
       ]
       // content_security_policy is optional.
       "content_security_policy":
           "sandbox allow-scripts; script-src 'self'"
     ],
     ...
   }
   

   지정하지 않으면 기본 content_security_policy 값은 sandbox allow-scripts allow-forms allow-popups allow-modals; script-src 'self' 'unsafe-inline' 'unsafe-eval'; child-src 'self';입니다. CSP 값을 지정하여 샌드박스를 더 제한할 수 있지만 sandbox 지시어가 있어야 하고 allow-same-origin 토큰은 없어도 됩니다 (가능한 샌드박스 토큰은 HTML5 사양 참고). 또한 지정된 CSP가 샌드박스 처리된 페이지 내부에서 외부 웹 콘텐츠를 로드하도록 허용하지 않을 수 있습니다.

창이나 프레임에 로드될 것으로 예상되는 페이지만 나열하면 됩니다. 샌드박스 처리된 페이지에서 사용하는 리소스 (예: 스타일시트 또는 JavaScript 소스 파일)는 sandboxed_page 목록에 표시될 필요가 없으며, 리소스를 삽입하는 페이지의 샌드박스를 사용합니다.

"Chrome 확장 프로그램에서 eval 사용 안전합니다.'라는 메시지에는 확장 프로그램의 기본 콘텐츠 보안 정책에 따라 실행하는 데 문제가 발생할 수 있는 라이브러리를 사용할 수 있게 해주는 샌드박스 워크플로 구현에 대해 자세히 설명되어 있습니다.

샌드박스 처리된 페이지는 manifest_version 2 이상을 사용하는 경우에만 지정할 수 있습니다.