설명
chrome.privacy API를 사용하여 Chrome에서 사용자 개인 정보 보호에 영향을 줄 수 있는 기능의 사용을 제어합니다. 이 API는 Chrome의 구성을 가져오고 설정하기 위해 API 유형의 ChromeSetting 프로토타입을 사용합니다.
권한
privacy'privacy(개인 정보 보호)'를 선언해야 합니다. 매니페스트에 권한을 부여해야 API를 사용할 수 있습니다. 예를 들면 다음과 같습니다.
{
"name": "My extension",
...
"permissions": [
"privacy"
],
...
}
개념 및 사용법
Chrome 설정의 현재 값을 읽는 방법은 간단합니다. 먼저
속성을 호출한 경우 해당 객체에서 get()를 호출하여
현재 값과 광고 확장의 제어 수준을 나타냅니다. 예를 들어 Chrome의 신용카드 자동 완성 기능이
기능을 사용 설정한 경우 다음과 같이 작성합니다.
chrome.privacy.services.autofillCreditCardEnabled.get({}, function(details) {
if (details.value) {
console.log('Autofill is on!');
} else {
console.log('Autofill is off!');
}
});
설정 값을 변경하는 것은 조금 더 복잡합니다. 먼저 확인을 거쳐야 하기 때문입니다.
확장 프로그램이 설정을 제어할 수 있도록 합니다.
확장 프로그램에서 엔터프라이즈 정책에 의해 특정 값으로 잠긴 설정을 전환합니다.
(levelOfControl가 'not_controllable'로 설정됨) 또는 다른 확장 프로그램이
값 (levelOfControl이 'managed_by_other_extensions'으로 설정됨)으로 설정됩니다. set() 호출은
성공하지만 설정이 즉시 재정의됩니다. 혼동될 수 있으므로
사용자가 선택한 설정이 실제로 적용되지 않을 때 경고를 표시합니다.
즉, get() 메서드를 사용하여 액세스 수준을 파악한 다음
확장 프로그램이 설정을 제어할 수 있는 경우 (실제로 확장 프로그램에서 제어할 수 없는 경우) set()를 호출합니다.
기능을 시각적으로 사용 중지하여 사용자 수를 줄이는 것이 좋습니다.
합니다.
chrome.privacy.services.autofillCreditCardEnabled.get({}, function(details) {
if (details.levelOfControl === 'controllable_by_this_extension') {
chrome.privacy.services.autofillCreditCardEnabled.set({ value: true }, function() {
if (chrome.runtime.lastError === undefined) {
console.log("Hooray, it worked!");
} else {
console.log("Sadness!", chrome.runtime.lastError);
}
});
}
});
설정 값을 변경하려면 onChange 이벤트에 리스너를 추가하세요. 다음 중 하나
최근에 설치한 확장 프로그램이
엔터프라이즈 정책이 사용자 제어보다 우선하는지 여부입니다. 변경사항을 수신 대기하려면
신용카드 자동 완성 상태에 있는 경우에는 다음 코드로 충분합니다.
chrome.privacy.services.autofillCreditCardEnabled.onChange.addListener(
function (details) {
// The new value is stored in `details.value`, the new level of control
// in `details.levelOfControl`, and `details.incognitoSpecific` will be
// `true` if the value is specific to Incognito mode.
}
);
예
이 API를 사용하려면 chrome-extension-samples에서 privacy API 예시를 설치하세요. 저장소
유형
IPHandlingPolicy
WebRTC의 IP 처리 정책입니다.
열거형
"기본"
"default_public_and_private_interfaces"
"default_public_interface_only"
"disable_non_proxied_udp"
속성
network
Chrome의 일반적인 네트워크 연결 처리에 영향을 미치는 설정입니다.
유형
객체
속성
-
networkPredictionEnabled
types.ChromeSetting<boolean>
사용 설정하면 Chrome에서 DNS 항목을 사전 해결하고 TCP 및 SSL 연결을 서버에 미리 열어두어 웹 탐색 환경의 속도를 높입니다. 이 환경설정은 Chrome의 내부 예상 검색어 서비스에서 수행하는 작업에만 영향을 미칩니다. 웹페이지에서 시작된 현 또는 사전 연결에는 영향을 미치지 않습니다. 이 환경설정의 값은 불리언이며 기본값은
true입니다. -
webRTCIPHandlingPolicyChrome 48 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.
사용자가 WebRTC 트래픽이 라우팅되는 방법과 노출되는 로컬 주소 정보의 양에 영향을 미치는 미디어 성능/개인 정보 보호의 균형을 지정할 수 있도록 합니다. 이 환경설정의 값은 IPHandlingPolicy 유형이며 기본값은
default입니다.
services
Google 및 기본 검색 공급자가 제공하는 타사 네트워크 서비스를 필요로 하는 기능을 사용 또는 사용 중지하는 설정입니다.
유형
객체
속성
-
alternateErrorPagesEnabled
types.ChromeSetting<boolean>
사용 설정하면 Chrome에서 웹 서비스를 사용하여 탐색 오류를 해결합니다. 이 환경설정의 값은 불리언이며 기본값은
true입니다. -
autofillAddressEnabled
types.ChromeSetting<boolean>
Chrome 70 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.이를 사용 설정하면 Chrome에서 주소와 기타 양식 데이터를 자동으로 채울지 묻는 메시지가 표시됩니다. 이 환경설정의 값은 불리언이며 기본값은
true입니다. -
autofillCreditCardEnabled
types.ChromeSetting<boolean>
Chrome 70 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.사용 설정하면 Chrome에서 신용카드 양식을 자동으로 작성할지 묻는 메시지가 표시됩니다. 이 환경설정의 값은 불리언이며 기본값은
true입니다. -
autofillEnabled
types.ChromeSetting<boolean>
<ph type="x-smartling-placeholder"></ph> Chrome 70 이후 지원 중단됨privacy.services.autofillAddressEnabled 및 privacy.services.autofillCreditCardEnabled를 사용하세요. 이는 이번 출시의 이전 버전과의 호환성을 위해 유지되며 향후 삭제될 예정입니다.
사용 설정하면 Chrome에서 양식이 자동으로 작성됩니다. 이 환경설정의 값은 불리언이며 기본값은
true입니다. -
passwordSavingEnabled
types.ChromeSetting<boolean>
사용 설정하면 비밀번호 관리자에서 비밀번호를 저장할지 묻습니다. 이 환경설정의 값은 불리언이며 기본값은
true입니다. -
safeBrowsingEnabled
types.ChromeSetting<boolean>
사용 설정하면 Chrome에서 피싱 및 멀웨어로부터 사용자를 보호하기 위해 최선을 다합니다. 이 환경설정의 값은 불리언이며 기본값은
true입니다. -
safeBrowsingExtendedReportingEnabled
types.ChromeSetting<boolean>
사용 설정하면 세이프 브라우징이 페이지를 차단할 때 Chrome에서 차단된 페이지의 콘텐츠와 같은 추가 정보를 Google에 전송합니다. 이 환경설정의 값은 불리언이며 기본값은
false입니다. -
searchSuggestEnabled
types.ChromeSetting<boolean>
사용하도록 설정하면 Chrome은 사용자가 검색창에 입력하는 텍스트를 기본 검색엔진으로 보내 사용자가 입력하려고 한 웹사이트와 검색어를 예상합니다. 이 환경설정의 값은 불리언이며 기본값은
true입니다. -
spellingServiceEnabled
types.ChromeSetting<boolean>
사용 설정하면 Chrome에서 웹 서비스를 사용하여 맞춤법 오류를 수정합니다. 이 환경설정의 값은 불리언이며 기본값은
false입니다. -
translationServiceEnabled
types.ChromeSetting<boolean>
이 설정을 사용하면 Chrome에서 사용 언어가 아닌 페이지에 대한 번역을 제안합니다. 이 환경설정의 값은 불리언이며 기본값은
true입니다.
websites
Chrome에서 웹사이트에 제공하는 정보를 결정하는 설정입니다.
유형
객체
속성
-
adMeasurementEnabled
types.ChromeSetting<boolean>
Chrome 111 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.사용 중지하면 Attribution Reporting API 및 Private Aggregation API가 비활성화됩니다. 이 환경설정의 값은 부울 형식이며 기본값은
true입니다. 확장 프로그램에서 값을false로 설정해야 이러한 API를 사용 중지할 수 있습니다. 이러한 API를true로 설정하려고 하면 오류가 발생합니다. -
doNotTrackEnabled
types.ChromeSetting<boolean>
Chrome 65 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.사용 설정하면 Chrome에서 'Do Not Track'을 전송합니다. (
DNT: 1) 헤더를 요청에 포함합니다. 이 환경설정의 값은 부울 형식이며 기본값은false입니다. -
fledgeEnabled
types.ChromeSetting<boolean>
Chrome 111 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.사용 중지하면 Fledge API가 비활성화됩니다. 이 환경설정의 값은 부울 형식이며 기본값은
true입니다. 확장 프로그램에서 값을false로 설정해야 이 API를 사용 중지할 수 있습니다. 이 API를true로 설정하려고 하면 오류가 발생합니다. -
hyperlinkAuditingEnabled
types.ChromeSetting<boolean>
사용 설정하면 웹사이트 (
<a ping>)에서 요청할 때 Chrome에서 감사 핑을 전송합니다. 이 환경설정의 값은 부울 형식이며 기본값은true입니다. -
protectedContentEnabled
types.ChromeSetting<boolean>
Windows 및 ChromeOS에서만 사용 가능: 사용 설정하면 Chrome에서 보호된 콘텐츠를 실행하기 위해 플러그인에 고유 ID를 제공합니다. 이 환경설정의 값은 부울 형식이며 기본값은
true입니다. -
referrersEnabled
types.ChromeSetting<boolean>
사용 설정하면 Chrome에서 요청과 함께
referer헤더를 전송합니다. 예, 환경설정 이름이 맞춤법 오류 헤더와 일치하지 않습니다. 아니요, 변경하지 않겠습니다. 이 환경설정의 값은 부울 형식이며 기본값은true입니다. -
types.ChromeSetting<boolean>
Chrome 121 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.사용 중지하면 관련 웹사이트 세트가 비활성화됩니다. 이 환경설정의 값은 부울 형식이며 기본값은
true입니다. 확장 프로그램에서 값을false로 설정해야 이 API를 사용 중지할 수 있습니다. 이 API를true로 설정하려고 하면 오류가 발생합니다. -
thirdPartyCookiesAllowed
types.ChromeSetting<boolean>
사용 중지하면 Chrome에서 서드 파티 사이트가 쿠키를 설정하지 못하도록 차단합니다. 이 환경설정의 값은 부울 형식이며 기본값은
true입니다. -
topicsEnabled
types.ChromeSetting<boolean>
Chrome 111 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.사용 중지하면 Topics API가 비활성화됩니다. 이 환경설정의 값은 부울 형식이며 기본값은
true입니다. 확장 프로그램에서 값을false로 설정해야 이 API를 사용 중지할 수 있습니다. 이 API를true로 설정하려고 하면 오류가 발생합니다.