chrome.permissions

설명

개념 및 사용법

권한 경고는 API가 부여하는 기능을 설명하기 위해 존재하지만 일부 경고는 명확하지 않을 수 있습니다. Permissions API를 사용하면 개발자가 권한 경고를 설명하고 새로운 기능을 점진적으로 도입할 수 있어 사용자에게 위험 부담 없이 확장 프로그램을 소개할 수 있습니다. 이를 통해 사용자는 부여할 액세스 수준과 사용 설정할 기능을 지정할 수 있습니다.

예를 들어 선택적 권한 확장 프로그램의 핵심 기능은 새 탭 페이지를 재정의합니다. 한 기능은 사용자의 오늘의 목표를 표시하고 있습니다. 이 기능을 사용하려면 storage 권한만 있으면 되며, 경고가 표시되지 않습니다. 확장 프로그램에는 사용자가 다음 버튼을 클릭하여 사용 설정할 수 있는 추가 기능이 있습니다.

사용자의 상위 사이트를 표시하려면 다음과 같은 경고가 표시되는 topSites 권한이 필요합니다.

선택적 권한 구현

1단계: 필수 권한 및 선택 권한 결정하기

확장 프로그램은 필수 권한과 선택적 권한을 모두 선언할 수 있습니다. 일반적으로 다음과 같이 해야 합니다.

• 확장 프로그램의 기본 기능에 필요한 경우 필수 권한을 사용합니다.
• 확장 프로그램의 선택적 기능에 필요한 경우 선택적 권한을 사용합니다.

필수 권한의 이점:

• 메시지 적게 표시: 확장 프로그램에서 사용자에게 모든 권한을 수락하라는 메시지를 한 번 표시할 수 있습니다.
• 더 간단한 개발: 필수 권한이 보장됩니다.

선택적 권한의 이점:

• 보안 개선: 사용자가 필요한 권한만 사용 설정하므로 확장 프로그램이 더 적은 권한으로 실행됩니다.
• 사용자를 위한 더 나은 정보: 확장 프로그램은 사용자가 관련 기능을 사용 설정할 때 특정 권한이 필요한 이유를 설명할 수 있습니다.
• 간편한 업그레이드: 확장 프로그램을 업그레이드할 때, 업그레이드에서 필수 권한이 아닌 선택적 권한을 추가하더라도 Chrome은 확장 프로그램을 사용 중지하지 않습니다.

2단계: 매니페스트에서 선택적 권한 선언

permissions 필드와 동일한 형식을 사용하여 optional_permissions 키로 확장 프로그램 매니페스트에서 선택적 권한을 선언합니다.

{
  "name": "My extension",
  ...
  "optional_permissions": ["tabs"],
  "optional_host_permissions": ["https://www.google.com/"],
  ...
}

런타임 시에만 검색할 수 있는 호스트를 요청하려면 확장 프로그램의 optional_host_permissions 필드에 "https://*/*"를 포함하세요. 이렇게 하면 일치하는 스키마가 있는 한 "Permissions.origins"에서 출처를 지정할 수 있습니다.

선택사항으로 지정할 수 없는 권한

대부분의 Chrome 확장 프로그램 권한은 선택사항으로 지정할 수 있지만 다음과 같은 예외가 있습니다.

사용 가능한 권한 및 경고에 관한 자세한 내용은 권한 선언을 참고하세요.

3단계: 선택적 권한 요청하기

permissions.request()를 사용하여 사용자 동작 내에서 권한을 요청합니다.

document.querySelector('#my-button').addEventListener('click', (event) => {
  // Permissions must be requested from inside a user gesture, like a button's
  // click handler.
  chrome.permissions.request({
    permissions: ['tabs'],
    origins: ['https://www.google.com/']
  }, (granted) => {
    // The callback argument will be true if the user granted the permissions.
    if (granted) {
      doSomething();
    } else {
      doSomethingElse();
    }
  });
});

Chrome은 권한을 추가할 때 사용자가 이미 보고 수락한 것과 다른 경고 메시지가 표시되는 경우 사용자에게 메시지를 표시합니다. 예를 들어 이전 코드는 다음과 같은 프롬프트를 생성할 수 있습니다.

4단계: 확장 프로그램의 현재 권한 확인

확장 프로그램에 특정 권한 또는 권한 집합이 있는지 확인하려면 permission.contains()를 사용합니다.

chrome.permissions.contains({
  permissions: ['tabs'],
  origins: ['https://www.google.com/']
}, (result) => {
  if (result) {
    // The extension has the permissions.
  } else {
    // The extension doesn't have the permissions.
  }
});

5단계: 권한 삭제하기

더 이상 필요하지 않은 권한은 삭제해야 합니다. 권한이 삭제된 후 일반적으로 permissions.request()를 호출하면 사용자에게 메시지를 표시하지 않고 권한이 다시 추가됩니다.

chrome.permissions.remove({
  permissions: ['tabs'],
  origins: ['https://www.google.com/']
}, (removed) => {
  if (removed) {
    // The permissions have been removed.
  } else {
    // The permissions have not been removed (e.g., you tried to remove
    // required permissions).
  }
});

chrome.permissions.contains(
  permissions: Permissions,
  callback?: function,
)

chrome.permissions.getAll(
  callback?: function,
)

chrome.permissions.remove(
  permissions: Permissions,
  callback?: function,
)

chrome.permissions.request(
  permissions: Permissions,
  callback?: function,
)

chrome.permissions.onAdded.addListener(
  callback: function,
)

chrome.permissions.onRemoved.addListener(
  callback: function,
)