권한 경고 가이드라인

Chrome 확장 프로그램은 사용자의 브라우저 환경을 개선합니다. 이 확장 프로그램을 사용하려면 특정 권한이 필요한 Chrome API를 사용합니다. 일부 권한은 덜 방해가 되며 경고를 표시하지 않습니다. 다른 권한에서는 사용자가 허용해야 한다는 경고를 트리거합니다. 이 페이지에서는 권한 경고 작업에 관한 가이드라인을 제공합니다. 특정 경고는 적용되는 권한 아래의 권한에 명시되어 있습니다.

경고를 트리거하는 새 권한이 추가되면 사용자가 새 권한을 수락할 때까지 확장 프로그램이 사용 중지됩니다. 이 동작을 테스트하는 방법은 권한 업데이트를 참고하세요.

일부 권한은 다른 권한과 페어링될 때 경고를 표시하지 않을 수 있습니다. 예를 들어 확장 프로그램에서 "<all_urls>"도 요청하는 경우 "tabs" 경고가 표시되지 않습니다.

권장사항

권한 경고는 API가 부여하는 기능을 설명하지만 일부 경고는 다른 경고보다 이해하기 어렵습니다. 사용자는 다음 가이드라인을 따르는 확장 프로그램을 설치할 가능성이 높습니다.

관련 권한 요청

확장 프로그램은 단일 목적을 달성하고 권한 사용 정책을 준수해야 합니다. 확장 프로그램의 기본 기능을 지원하는 권한만 요청해야 합니다.

선택적 권한 사용

런타임에 권한을 요청하여 온보딩 환경을 개선합니다. 이를 통해 특정 권한에 관한 자세한 컨텍스트를 제공하고 사용자가 사용 설정할 기능을 선택할 수 있습니다. 구현 세부정보는 Permissions API를 참고하세요.

'activeTab' 권한 사용하기

이 권한은 권한 경고를 표시하지 않습니다. 사용자가 있는 사이트에 임시 호스트 권한을 부여합니다. 자세한 내용은 activeTab 권한 이해를 참고하세요.

경고 보기

확장 프로그램의 권한 경고를 보려면 다음 옵션을 사용하세요.

확장 프로그램 업데이트 테스트 도구 사용

시작하기 전에

1. Node.js와 NPM을 설치합니다.
2. Chromium을 설치합니다.
3. extension-update-testing-tool 저장소를 클론합니다.
4. 저장소 루트에서 npm install를 실행합니다.

도구 사용하기

1. npm start을 실행합니다.
2. Chromium의 http://localhost:8080에서 로컬 서버를 엽니다.
3. 압축해제된 확장 프로그램 (폴더 또는 .zip 파일)을 페이지로 드래그합니다.
4. '직접 설치' 아래의 안내에 따라 확장 프로그램을 다운로드하고 설치합니다.

확장 프로그램을 수동으로 패키징

1. chrome://extensions로 이동합니다.
2. 개발자 모드 사용 설정
3. 확장 프로그램 압축을 클릭합니다.

   

4. 확장 프로그램 루트 디렉터리 필드에 확장 프로그램 폴더 경로를 지정합니다. 최초 패키지의 경우 비공개 키 필드는 무시합니다.

5. 확장 프로그램 압축 버튼을 클릭합니다.

   

6. Chrome에서 .crx 파일과 .pem 파일, 이렇게 두 개의 파일을 만듭니다. .pem 파일에는 확장 프로그램에 서명하는 데 사용된 비공개 키가 포함되어 있습니다. 이 파일이 저장된 디렉터리를 기억해 두세요.

   

7. .pem 파일은 안전한 장소에 보관해야 합니다. 확장 프로그램을 업데이트하는 데 이 파일이 필요합니다.

8. 확장 프로그램의 관리 페이지에 .crx 파일을 드롭하여 설치합니다.

   

9. .crx 파일을 삭제하면 브라우저에서 확장 프로그램을 추가할 수 있는지 묻고 경고를 표시합니다.

   

권한 업데이트

확장 프로그램이 경고를 트리거하는 새 권한을 추가하면 일시적으로 사용 중지할 수 있습니다. 확장 프로그램은 사용자가 새 권한을 수락하는 데 동의한 후에만 다시 사용 설정됩니다.

새 권한을 추가할 때 확장 프로그램이 사용 중지되는지 확인하려면 다음 옵션을 사용하세요.

확장 프로그램 업데이트 테스트 도구를 사용하여 업데이트하기

이 단계에서는 확장 프로그램 업데이트 테스트 도구 사용 안내에 따라 서버를 시작했다고 가정합니다.

도구 사용하기

1. 새 경고가 있는 권한을 추가합니다.
2. 확장 프로그램 버전 번호를 높입니다.
3. 압축해제된 확장 프로그램 (폴더 또는 .zip 파일)을 페이지로 드래그합니다.
4. chrome://extensions 페이지로 이동합니다.
5. 업데이트 버튼을 클릭합니다.

수동으로 확장 프로그램 업데이트

1. 경고 보기에서 방금 만든 .crx 파일을 찾습니다.
2. 이름을 변경하거나 삭제합니다.
3. manifest.json를 열고 경고를 트리거하는 권한을 추가합니다.
4. chrome://extensions 페이지로 이동합니다. 이전에 설치된 패키지는 삭제하지 마세요.
5. 확장 프로그램을 다시 패키징합니다. 단, 이번에는 두 번째 입력에 pem 파일을 추가합니다.

   

6. 새 패키지 확장 프로그램을 확장 프로그램 관리 페이지로 드래그합니다.

7. 사용자에게 새 권한을 수락하라는 대화상자가 표시됩니다.