사용자 에이전트 축소 지원 중단 체험판
bookmark_border 컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

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

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

지원 중단 무료 체험판 등록은 Chrome 100 베타부터 시작됩니다. 이를 통해 사이트는 Chrome 101 출시 전에 전체 사용자 에이전트 문자열을 수신할 수 있습니다. Chrome 101에서는 하위 버전 문자열이 축소됩니다. 안정화 버전 채널에 출시되기 전에 Chrome 100 베타에서 오리진 트라이얼을 테스트하려면 Chrome 100 출시일 (현재 2022년 3월 31일로 예정) 전에 등록하고 테스트해야 합니다.

다음은 지원 중단 체험판 및 예상 결과에 관한 개요입니다. 공유할 의견이 있거나 이 체험판을 사용하는 동안 문제가 발생하면 UA 감소 GitHub 저장소에서 알려주세요.

웹 개발자에게 미치는 영향

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

User-Agent HTTP 요청 헤더
navigator.userAgent JavaScript getter
navigator.platform JavaScript getter
navigator.appVersion JavaScript getter

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

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

무료 체험판 등록

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

설정

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

HTTP 응답 헤더에 Origin-Trial: <ORIGIN TRIAL TOKEN>를 추가합니다. <ORIGIN TRIAL TOKEN>에는 원본 무료 체험을 등록할 때 받은 토큰이 포함됩니다.
HTTP 응답 헤더에 Accept-CH: Sec-CH-UA-Full를 추가합니다. Accept-CH를 설정하면 원본에 대한 후속 요청에서만 전체 사용자 에이전트 문자열이 전송됩니다.
첫 번째 요청에서 전체 User-Agent 문자열이 중요한 경우 Accept-CH 및 Origin-Trial 헤더 외에도 HTTP 응답 헤더에 Critical-CH: Sec-CH-UA-Full를 추가합니다.
축소 지원 중단 체험판에 참여하는 경우 모든 서드 파티 도메인이 전체 사용자 에이전트 문자열에 액세스하도록 허용하는 것이 좋습니다. 전체 사용자 에이전트 문자열에 대한 서드 파티 도메인 액세스 권한을 확장하지 않으면 자체 감소 지원 중단 체험판 등록 여부와 관계없이 전체 사용자 에이전트 문자열 액세스가 차단됩니다. 다음 두 가지 옵션 중 하나를 사용하여 서드 파티 도메인에 대한 전체 User-Agent 문자열 액세스를 허용할 수 있습니다.
- 전체 User-Agent 문자열을 수신해야 하는 서드 파티 도메인이 포함된 Permissions-Policy 헤더를 추가합니다.
  - 모든 서드 파티 도메인을 허용하려면 Permissions-Policy: ch-ua-full=*를 추가합니다.
  - 서드 파티 도메인 이름 목록을 허용하려면 Permissions-Policy: ch-ua-full=(self "https://thirdparty.example.com")를 추가합니다.
- 전체 User-Agent 문자열을 수신해야 하는 서드 파티 도메인과 함께 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을 참고하세요.

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

출처 무료 체험이 작동하는지 확인하려면 요청 헤더를 검사하고 다음을 확인하세요.

User-Agent 헤더에는 전체 버전이 포함됩니다. 축소된 값 (축소된 User-Agent 문자열 샘플 목록에 있음)은 포함되어선 안 됩니다. Chrome 마이너 버전 문자열이 0.0.0이 아닌지 확인하는 것이 가장 쉽습니다.
Sec-CH-UA-Full 헤더가 ?1로 설정됩니다.

origin-trial 토큰이 포함된 초기 응답의 헤더는 다음과 같이 표시됩니다.

전체 User-Agent 문자열이 포함된 후속 요청 헤더는 다음과 같이 표시됩니다.

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

무료 체험 기간 중 언제든지 참여를 중지하고 축소된 사용자 에이전트 문자열을 받을 수 있습니다. 참여를 중지하려면 다음 단계를 따르세요.

HTTP 응답에서 Sec-CH-UA-Full를 포함하지 않는 Accept-CH 헤더를 전송합니다. 사이트에서 다른 클라이언트 힌트를 요청하지 않는 경우 빈 값이 있는 Accept-CH를 사용하면 이 작업을 실행할 수 있습니다.
HTTP 응답에서 사용자 에이전트 축소 지원 중단 체험판의 Origin-Trial 헤더를 삭제합니다.
설정된 경우 HTTP 응답의 Critical-CH 헤더에서 Sec-CH-UA-Full를 삭제합니다.

이 체험판은 다른 User-Agent 출처 체험판과 어떻게 다른가요?

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

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

지원 중단 체험판은 얼마나 오래 지속되나요?

사용자 에이전트 축소 지원 중단 트라이얼은 Chrome 100부터 Chrome 115까지 실행됩니다. Chrome 116은 완전히 축소된 사용자 에이전트 문자열만 전송되는 최초 버전입니다.

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

문제 또는 의견이 있으면 User-Agent Reduction GitHub 저장소에 제출하세요.