chrome.permissions

설명

개요

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

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

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

선택적 권한 구현

1단계: 필요한 권한 및 선택사항 권한 결정하기

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

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

필수 권한의 장점:

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

선택적 권한의 장점:

• 보안 강화: 사용자는 권한만 허용하므로 더 적은 권한으로 확장 프로그램이 실행됩니다. 있습니다.
• 사용자를 위한 더 나은 정보: 확장 프로그램에서 특정 권한이 필요한 이유를 설명할 수 있습니다. 사용자가 관련 기능을 사용 설정할 때
• 더 쉬운 업그레이드: 확장 프로그램을 업그레이드할 때 다음과 같은 경우 Chrome은 사용자를 위해 확장 프로그램을 사용 중지하지 않습니다. 업그레이드 시 필수 권한이 아닌 선택적 권한이 추가됩니다.

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

optional_permissions 키를 사용하여 확장 프로그램 매니페스트에서 선택적 권한을 선언합니다. 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,
)