블로그로 돌아가기

User-Agent와 Client Hints란: 브라우저 정보, 개인정보, 호환성 점검

웹사이트는 User-Agent 헤더, JavaScript, Client Hints로 정보를 얻을 수 있습니다. 차이, 기본 및 요청 데이터, UA만 바꿔서는 환경 전체가 바뀌지 않는 이유와 자체 사이트 점검법을 설명합니다.

User-Agent는 사이트에 브라우저를 설명하지만 기기 신분증은 아닙니다. 최신 사이트는 스크립트, Client Hints, 실행 조건도 읽을 수 있습니다. UA 문자열을 바꿔도 운영체제, 기능, 모든 신호가 함께 바뀌지는 않습니다.

개발자는 실제 기능에 맞춰 서비스를 제공하고, 사용자와 운영팀은 노출 정보와 해석의 한계를 이해해야 합니다.

UA 문자열을 오해하기 쉬운 이유

User-Agent 헤더에는 보통 브라우저와 플랫폼 표시가 있고 스크립트는 navigator.userAgent를 읽습니다. 과거 호환성 때문에 여러 제품명이 있어도 각각 독립적인 현재 브라우저를 뜻하지 않습니다.

UA는 축소, 변경, 중간 계층 재작성도 가능합니다. 한 단어만으로 기능을 판단하면 가능한 브라우저를 잘못 차단합니다.

파일 업로드가 필요하면 이름 대신 인터페이스와 행동을 검사하세요. UA는 제한적인 단서이며 기능 탐지를 대신하지 않습니다.

Client Hints가 바꾸는 것

Chrome의 User-Agent Client Hints 안내는 구조화된 정보 요청을 설명합니다. 긴 문자열 대신 필요한 필드를 요청하지만 무엇을 제공할지는 브라우저 정책이 정합니다.

인터페이스와 전송 방식을 구분하세요.

정보원위치확인 사항
User-AgentHTTP 요청 헤더해당 요청이 실제 보낸 값
navigator.userAgent페이지 JavaScript해당 스크립트가 읽은 문자열
Sec-CH-UA 등지원 브라우저의 요청 헤더전송 여부, 의미, 요청 조건
navigator.userAgentData지원 스크립트 환경존재 여부와 반환 필드

헤더와 스크립트는 관측 지점이 다릅니다. CDN, 프록시, 캐시, 서버 로그도 다른 처리 계층일 수 있습니다. 출처부터 정하고 비교하세요.

낮고 높은 엔트로피는 신뢰성 구분이 아니다

엔트로피는 구별에 도움이 되는 정보량입니다. 정확성을 보장하거나 계정 위험도를 뜻하지 않습니다.

MDN의 NavigatorUAData 문서는 기본 속성과 비동기 추가 요청을 구분하고 호환성 확인을 권합니다. 필드가 많다고 완전하고 정확하며 변경 불가능한 기기 목록을 기본으로 받는 것은 아닙니다.

자체 사이트에서는 필드가 필요한 이유를 먼저 묻습니다. 배치는 반응형 디자인, 기능은 능력 탐지를 우선하고 인터페이스가 있다고 모든 정보를 수집하지 마세요.

내 브라우저의 기본 정보 보기

아래 예제는 로컬 기본 정보만 읽고 외부 서버로 보내지 않습니다. 소유한 시험 페이지나 개발자 도구에서 실행하세요.

const browserInfo = {
  userAgent: navigator.userAgent,
  hints: navigator.userAgentData?.toJSON() ?? null,
};

console.log(browserInfo);

hints가 null이면 이상으로 판단하기 전에 지원과 실행 조건을 보세요. 브라우저, 버전, 맥락에 따라 달라 합리적인 대체 동작이 필요합니다.

헤더는 네트워크 패널의 특정 요청에서 확인합니다. 다른 요청, 탭, 과거 캐시 기록과 스크립트 출력을 혼합하지 마세요.

추가 힌트를 요청할 때는 전체 경로 점검하기

서버는 Accept-CH 등을 쓸 수 있지만 수신 여부, 어떤 요청인지, 브라우저 허용 여부는 실제 통신에서 확인합니다. HTTPS, 지원, 정책이 영향을 줍니다.

응답의 요청 지시부터 보고 이후 요청 필드를 확인하세요. CDN과 캐시의 응답 변형이 올바르게 구분되어 다른 조건용 응답이 전달되지 않는지도 봅니다.

첫 요청에 필드가 없다고 “위장 실패”는 아닙니다. 정상적인 지원 또는 협상의 결과일 수 있습니다.

UA만 바꿔도 전체 환경은 바뀌지 않는 이유

UA는 일부입니다. 언어, 시간대, 창, 그래픽, 글꼴, 확장, 사이트 데이터는 다른 방식으로 동작합니다. 한 설정이 다른 모든 계층을 바꾸지 않습니다.

휴대전화 이름을 적어도 데스크톱에 같은 터치, 배치, 하드웨어가 생기지 않습니다. 문자열만으로 모바일 버튼을 보이면 호환성 문제가 생길 수 있습니다.

잦은 무작위 변경보다 안정된 설정과 추적 가능한 기록을 우선하세요. 규칙, 로그인 안전, 승인된 작업은 따로 관리해야 합니다.

팀에서 “같은 계정, 다른 페이지” 조사하기

환경, 버전, URL, 시간, 문제 기능을 적고 최소한의 관련 정보를 모읍니다. 정상과 문제 환경을 비교할 때 한 조건씩 바꾸세요.

PurpleMark에서는 시스템, 엔진, User-Agent, 언어, 시간대를 확인한 뒤 해당 환경에서 시험 페이지를 엽니다. 고객이나 용도별 그룹으로 실제 업무와 연결하기 쉽습니다.

검사 사이트 점수만으로 계정 안전이나 제한을 단정하지 마세요. 그 사이트가 시험한 신호만 볼 뿐 대상 사이트의 전체 동작이나 내부 판단을 대신하지 않습니다.

웹 개발자 점검 목록

  • 핵심 기능은 능력을 탐지하고 UA는 필요한 범위의 호환 처리에만 씁니다.
  • Client Hints가 없어도 작동하는 대안을 제공하며 빈 화면으로 만들지 않습니다.
  • 헤더, 스크립트, 중간 처리 로그를 구분합니다.
  • 업무에 필요한 정보만 요청하고 실제 개인정보 안내대로 처리합니다.
  • 업데이트 후 같은 페이지와 입력을 재검사하고 모든 차이를 지문 탓으로 돌리지 않습니다.

UA와 Client Hints를 이해하면 잘못된 추론을 줄입니다. 조건과 호환 경계가 있는 신호를 실제 작업에 맞춰 해석해야 호환성과 개인정보 관리를 함께 개선할 수 있습니다.