사용자 에이전트 파서

사용자 에이전트 파서는 사용자 에이전트 문자열을 읽고 브라우저, 운영체제, 기기 유형을 알려 주는 무료 도구입니다.

사용자 에이전트 문자열로 무엇을 알 수 있나요?

사용자 에이전트 문자열은 HTTP User-Agent 필드의 값입니다. 웹 브라우저의 경우 일반적으로 제품 이름, 버전 번호, 운영체제 토큰, 기기를 추정할 수 있는 정보가 들어 있습니다. 명령줄 클라이언트, 크롤러, 피드 리더, 인앱 브라우저도 사용자 에이전트 문자열을 전송할 수 있습니다.

형식은 언뜻 보기보다 훨씬 불규칙합니다. 브라우저는 다른 브라우저와 관련된 호환성 토큰을 포함하는 경우가 많아서, 처음 발견한 제품 이름만으로 판단하면 잘못된 결과가 나올 수 있습니다. 예를 들어 Chromium 기반 브라우저에는 일반적으로 Chrome 관련 토큰과 Safari 관련 토큰이 모두 들어 있습니다. 파서는 값을 단순한 목록으로 취급하지 않고 토큰의 조합과 순서를 분석합니다.

사용자 에이전트 데이터는 클라이언트가 직접 제공하는 정보이기도 합니다. 클라이언트가 값을 변경하거나 조작할 수 있으며, 일부 브라우저는 노출하는 버전 및 기기 정보를 줄입니다. 따라서 파싱된 데이터는 분류와 디버깅에는 유용하지만, 특정 기기의 신원을 입증하지는 않습니다.

사용자 에이전트 파서는 어떻게 사용하나요?

전체 헤더 값을 사용자 에이전트 필드에 붙여 넣고 도구를 실행하세요. 결과로 브라우저, 운영체제, 기기 유형이라는 세 필드가 표시됩니다.

1. HTTP 요청, 액세스 로그 또는 브라우저 개발자 도구에서 User-Agent 뒤에 있는 값을 복사하세요.
2. 원래의 공백, 괄호, 세미콜론, 슬래시, 버전 번호를 그대로 유지하세요. 이러한 문자는 문자열 안에서 제품과 설명을 구분합니다.
3. 값을 제출한 다음, 반환된 분류를 요청이 발생한 맥락과 비교하세요.
4. 디버깅 기록에는 파싱 결과와 함께 원본 문자열도 보관하세요. 분류 결과만 남기면 유용한 버전 또는 호환성 토큰을 확인하지 못할 수 있습니다.

파서는 서버에서 실행됩니다. 사용자 에이전트 문자열은 HTTPS를 통해 서버로 전송되며 저장되지 않습니다. 그래도 로그 항목을 복사해 제출하기 전에는 관련 없는 쿼리 매개변수, 세션 식별자 또는 내부 호스트명이 포함되어 있지 않은지 확인하세요.

파싱 결과는 어떻게 해석해야 하나요?

각 필드는 독립적으로 검증된 하드웨어 또는 소프트웨어 정보가 아니라, 클라이언트가 제공한 토큰을 바탕으로 추론한 분류 결과입니다.

• 브라우저는 문자열에서 식별된 브라우저 또는 클라이언트 계열을 나타냅니다. 임베디드 웹 뷰와 Chromium 기반 브라우저는 많은 토큰을 공유하므로 구분하기가 더 어려울 수 있습니다.
• 운영체제는 Windows NT, Android, iPhone OS, Mac OS X, Linux 같은 표식이 가리키는 플랫폼을 보여 줍니다. 호환성 계층이나 수정된 사용자 에이전트 때문에 결과가 구체적이지 않을 수 있습니다.
• 기기 유형은 기기 및 플랫폼 표식을 바탕으로 클라이언트를 대략적인 폼 팩터로 분류합니다. 정확한 하드웨어 모델이 아니라 실용적인 범주로 이해하세요.

결과 필드는 구문 검증 보고서가 아닙니다. 형식이 잘못되었거나, 지나치게 짧거나, 익숙하지 않은 사용자 에이전트에는 유용하게 분류할 만한 정보가 부족할 수 있습니다. 하지만 후행 쉼표나 따옴표 없는 키 같은 JSON 오류에 견줄 수 있는 보편적인 오류 목록은 없습니다. 실제 문자열은 클라이언트마다 다르고 오래된 호환성 구문을 유지하는 경우가 많으므로, 사용자 에이전트 파싱은 대부분 휴리스틱 방식으로 이루어집니다.

빈 값에는 분류할 정보가 없습니다. 매우 긴 값에는 확장 정보, 애플리케이션 식별자 또는 중복된 제품 토큰이 들어 있을 수 있습니다. 숫자는 일반적으로 자신이 수식하는 제품 토큰과 함께 있을 때만 의미가 있습니다. 사용자 정의 클라이언트 문자열에는 악센트 문자나 비라틴 문자가 포함될 수 있지만, 이런 문자만으로 브라우저, 운영체제 또는 기기를 식별할 수는 없습니다.

사용 예시

입력 Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124.0.0.0 Safari/537.36

파서는 일반적으로 이를 Windows의 Chrome과 데스크톱 기기로 분류합니다. Safari 토큰은 호환성을 위해 포함된 것이므로, 이 토큰 하나만으로 Safari 브라우저라고 판단해서는 안 됩니다.

입력 Mozilla/5.0 (iPhone; CPU iPhone OS 17_4 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.4 Mobile/15E148 Safari/604.1

이 값은 iOS의 Safari와 모바일 기기를 나타냅니다. "like Mac OS X"라는 문구는 호환성 정보의 일부이며, iPhone과 Mobile 표식이 기기를 판단하는 더 강한 단서입니다.

사용자 에이전트가 URL 쿼리 매개변수 안에서 수집되었다면 퍼센트 인코딩되어 있을 수 있습니다. URL 파서로 매개변수를 분리하고 디코딩한 뒤, 나온 사용자 에이전트 값을 파싱하세요.

사용자 에이전트 파싱은 언제 유용하고, 언제 필요하지 않나요?

익숙하지 않은 요청을 읽기 쉽게 해석하거나 배포 전에 분류 로직을 확인해야 할 때 유용합니다. Apache 또는 nginx 액세스 로그 항목 검토, 특정 브라우저에서 발생한 렌더링 문제 조사, 임베디드 앱의 트래픽 확인, 분석 플랫폼에서 내보낸 원시 데이터 확인 등이 일반적인 사용 사례입니다.

다른 시스템에서 브라우저, 운영체제, 기기 정보를 이미 구조화된 필드로 제공한다면 대개 다시 파싱할 필요가 없습니다. 서비스에서 원본 헤더를 전달하거나 보관하기만 하면 되는 경우에도 얻을 수 있는 이점이 거의 없습니다. 발신자가 문자열을 위조할 수 있으므로 인증, 사기 탐지 또는 액세스 제어의 유일한 판단 근거로 사용하지 마세요.

반응형 레이아웃에는 일반적으로 서버 측 기기 추정보다 CSS 미디어 쿼리와 기능 감지가 더 신뢰할 만합니다. 특정 브라우저 기능을 지원한다고 가정하기 위한 용도가 아니라, 진단이나 보고에 필요한 맥락을 파악할 때 사용자 에이전트를 파싱하세요.

자주 묻는 질문

요청이 봇에서 왔는지 파서로 알 수 있나요?

반환되는 필드에는 봇 전용 분류가 없습니다. 일부 크롤러는 사용자 에이전트에서 자신을 명확히 밝히지만, 브라우저를 흉내 내거나 유용한 세부 정보를 생략하는 크롤러도 있습니다. 필요한 경우 요청 빈도 패턴, 공개된 크롤러 IP 확인 방법, 요청 동작을 함께 살펴 자동화된 트래픽인지 확인하세요.

Edge 사용자 에이전트에 Chrome과 Safari가 왜 들어 있나요?

최신 Edge는 Chromium 기반이며, 사용자 에이전트를 확인하는 웹사이트에 필요한 호환성 토큰을 포함합니다. 파서는 요청을 일반적인 Chrome이나 Safari로 분류하기 전에 더 구체적인 Edge 토큰을 찾아야 합니다. 토큰의 순서와 구체성이 중요합니다.

기기 유형을 기준으로 모바일 방문자를 리디렉션해도 되나요?

참고 정보로 사용할 수는 있지만, 강제 리디렉션을 적용하면 태블릿, 데스크톱 모드 브라우저, 수정된 사용자 에이전트를 잘못 분류할 수 있습니다. 반응형 페이지를 우선 사용하세요. 별도의 모바일 환경이 반드시 필요하다면 방문자가 다른 버전을 직접 선택할 수 있게 하세요.

브라우저 클라이언트 힌트가 사용자 에이전트 파싱을 대체하나요?

브라우저와 서버가 클라이언트 힌트를 지원하면 구조화된 브라우저 및 플랫폼 정보를 얻을 수 있지만, 모든 요청이나 클라이언트에 이 정보가 포함되는 것은 아닙니다. 이전 버전 브라우저, 크롤러, 기존 액세스 로그를 처리하는 시스템에서는 여전히 사용자 에이전트 파싱이 필요할 수 있습니다. 작업에 필요한 사용자 에이전트 분류만 저장하고, 관련 개인정보 보호 의무를 준수하세요.