사용자 에이전트 축소 지원 중단 체험판

사용자 에이전트 축소 지원 중단 무료 체험을 통해 사이트에서 UA 문자열 축소 후에도 전체 사용자 에이전트 문자열을 계속 수신할 수 있었습니다. 무료 체험은 2023년 9월 23일에 종료되었습니다.

Chrome 101부터 단계적 접근 방식을 사용하여 사용자 에이전트 (UA) 문자열에서 사용할 수 있는 정보를 줄입니다. 축소된 사용자 에이전트 문자열을 사용하지 않고 사용자 에이전트 클라이언트 힌트로 전환할 시간이 없었던 사이트는 지원 중단 체험판에 참여하여 전체 사용자 에이전트 문자열을 계속 수신할 수 있습니다.

지원 중단 체험판 등록은 Chrome 100 베타부터 시작됩니다. 이렇게 하면 사이트에서 Chrome 101 출시에 앞서 전체 사용자 에이전트 문자열을 수신할 수 있으며 마이너 버전 문자열은 줄어듭니다. 공개 버전 채널에 출시되기 전에 Chrome 100 베타에서 오리진 트라이얼을 테스트하려면 Chrome 100 출시일 (현재 2022년 3월 31일 예정) 전에 등록하고 테스트해야 합니다.

다음은 지원 중단 체험판의 개요와 예상되는 결과입니다. 공유할 의견이 있거나 이 무료 체험 기간 동안 문제가 발생한 경우 UA Reduction GitHub 저장소에서 알려주세요.

웹 개발자에게는 어떤 영향을 미치나요?

지원 중단 체험판에 등록하면 사이트에서 navigator.userAgent의 전체 UA 문자열과 관련 navigator.platform 및 navigator.appVersion JavaScript getter의 축소되지 않은 값을 계속 수신합니다.

User-Agent HTTP 요청 헤더
navigator.userAgent 자바스크립트 getter
navigator.platform 자바스크립트 getter
navigator.appVersion 자바스크립트 getter

사이트에서는 계속 사용자 에이전트 헤더 및 관련 API의 사용을 감사해야 하며, 필요한 경우 지원 중단 체험판이 만료되기 전에 사용자 에이전트 클라이언트 힌트로 이전할 준비를 해야 합니다. 사용자 에이전트 축소 출시가 완료되면 이 지원 중단 체험판이 만료됩니다.

사용자 에이전트 축소 지원 중단 무료 체험판에 참여하려면 어떻게 해야 하나요?

무료 체험판 등록

오리진 트라이얼에 등록하고 도메인용 토큰을 받으려면 사용자 에이전트 축소 지원 중단 체험판 페이지를 방문하세요. 타사로 등록하는 경우 '서드 파티 일치'를 선택하세요.

설정

무료 체험판에 등록한 후 다음과 같이 HTTP 응답 헤더를 업데이트합니다.

HTTP 응답 헤더에 Origin-Trial: <ORIGIN TRIAL TOKEN>를 추가합니다. <ORIGIN TRIAL TOKEN>에는 오리진 트라이얼에 등록할 때 받은 토큰이 포함됩니다.
HTTP 응답 헤더에 Accept-CH: Sec-CH-UA-Full를 추가합니다. Accept-CH를 설정하면 출처에 대한 후속 요청 시 전체 사용자 에이전트 문자열만 전송됩니다.
첫 번째 요청에서 전체 사용자 에이전트 문자열이 중요한 경우 Accept-CH 및 Origin-Trial 헤더 외에도 Critical-CH: Sec-CH-UA-Full를 HTTP 응답 헤더에 추가합니다.
축소 기능 지원 중단 체험판에 참여하는 참여자의 경우 모든 서드 파티 도메인에서 전체 사용자 에이전트 문자열에 액세스하도록 허용하는 것이 좋습니다. 서드 파티 도메인의 액세스 권한을 전체 사용자 에이전트 문자열로 확장하지 못하면 자체 축소 지원 중단 체험판 등록과 관계없이 전체 사용자 에이전트 문자열 액세스가 차단됩니다. 다음 두 가지 옵션 중 하나를 사용하여 서드 파티 도메인에 대한 전체 사용자 에이전트 문자열 액세스를 허용할 수 있습니다.
- 전체 사용자 에이전트 문자열을 수신해야 하는 서드 파티 도메인이 포함된 Permissions-Policy 헤더를 추가합니다.
  - 모든 서드 파티 도메인을 허용하려면 Permissions-Policy: ch-ua-full=*를 추가하세요.
  - 서드 파티 도메인의 이름이 지정된 목록을 허용하려면 Permissions-Policy: ch-ua-full=(self "https://thirdparty.example.com")를 추가합니다.
- 전체 사용자 에이전트 문자열을 수신해야 하는 서드 파티 도메인에 Accept-CH 메타 태그를 추가합니다 (Chrome 100 이상만 해당).
  - 서드 파티 도메인의 이름이 지정된 목록을 허용하려면 <meta http-equiv="delegate-ch" value="sec-ch-ua-full https://thirdparty.example.com">를 추가합니다.
  - 메타 태그의 *를 통해 모든 서드 파티 도메인에 위임할 수는 없습니다.
Chrome 100 이상에서 웹사이트를 로드하고 전체 사용자 에이전트 문자열을 계속 수신합니다.

데모

무료 체험판 데모는 https://uard-ot-demo.glitch.me에서 확인하세요 (소스 코드 포함).

무료 체험판이 작동하는지 확인하려면 어떻게 해야 하나요?

오리진 트라이얼이 작동하는지 확인하려면 요청 헤더를 살펴보고 다음 사항을 확인하세요.

사용자 에이전트 헤더에 전체 버전이 포함되어 있습니다. 축소된 값 (감소된 사용자 에이전트 문자열의 샘플 목록에서 확인 가능)은 포함되어서는 안 됩니다. 쉽게 알 수 있는 방법은 Chrome 부 버전 문자열이 0.0.0이면 안 되는 것입니다.
Sec-CH-UA-Full 헤더가 ?1로 설정됩니다.

출발지 체험판 토큰이 포함된 초기 응답의 헤더는 다음과 같습니다.

전체 User-Agent 문자열을 포함하는 이후의 요청 헤더는 다음과 같습니다.

사용자 에이전트 축소 지원 중단 기능 트라이얼 참여를 중지하려면 어떻게 해야 하나요?

무료 체험 기간 중 언제든지 참여를 중지하고 줄어든 User-Agent 문자열을 수신할 수 있습니다. 참여를 중단하려면 다음 단계를 따르세요.

HTTP 응답에 Sec-CH-UA-Full를 포함하지 않는 Accept-CH 헤더를 전송합니다. 사이트에서 다른 클라이언트 힌트를 요청하지 않는 경우 Accept-CH를 빈 값으로 사용하면 됩니다.
HTTP 응답에서 User-Agent Reduction 지원 중단 체험판의 Origin-Trial 헤더를 삭제합니다.
설정된 경우 HTTP 응답의 Critical-CH 헤더에서 Sec-CH-UA-Full를 삭제합니다.

이 체험판은 다른 사용자 에이전트 오리진 트라이얼과 어떻게 다른가요?

Chrome은 사용자 에이전트 축소와 관련하여 두 가지 오리진 트라이얼을 실행하고 있습니다. 첫 번째는 User Agent Reduction 오리진 트라이얼로, 사이트에서 축소된 사용자 에이전트 문자열을 받아 Chrome의 기본 동작이 되기 전에 사용 사례를 테스트하고 의견을 제공할 수 있도록 했습니다.

여기에 언급된 두 번째는 User-Agent Client Hints API로 이전하는 데 시간이 조금 더 필요한 사이트를 대상으로 하는 지원 중단 체험판입니다. 사이트에서 전체 사용자 에이전트 문자열을 계속 수신할 수 있습니다.

지원 중단 트라이얼은 언제까지 제공되나요?

사용자 에이전트 축소 지원 중단 체험판은 Chrome 100부터 Chrome 115까지 실행됩니다. Chrome 116은 완전히 축소된 사용자 에이전트 문자열만 전송되는 첫 번째 버전이 됩니다.

사용자 에이전트 축소 지원 중단 트라이얼에 관한 의견을 공유하려면 어떻게 해야 하나요?

사용자 에이전트 축소 GitHub 저장소에 문제나 의견을 제출하세요.