블루팀 · Reference
정상 User-Agent 사전: 브라우저·앱·CLI·크롤러
34개 정상 제품·토큰의 이름과 뜻, 정상 사용을 확인하는 방법 및 공격 악용과의 경계를 정리합니다.
업데이트 2026-11-17
이 문서의 목차
정상 제품 이름과 정상 요청은 다릅니다
이 표는 정상 소프트웨어가 사용하는 이름을 설명합니다. 그 이름을 가진 모든 요청이 정상이라는 허용 목록은 아닙니다. 제품의 실제 존재, 프로세스 서명·경로, 사용자·작업 소유자, 목적지, 호출 주기와 업무 승인을 확인해야 합니다. 악성코드가 동일한 값을 보낼 수 있고 정상 프로그램 자체가 악용될 수도 있습니다.
브라우저·앱 해석 순서
- 구체적인 제품 토큰부터 찾습니다.
Edg/,OPR/,SamsungBrowser/가 있으면Chrome/만 보고 분류하지 않습니다. - 앱 내 웹뷰와 독립 브라우저를 구분합니다. Android의
; wv는 흔한 단서지만 앱이 UA를 바꿀 수 있습니다. - 제품 버전과 엔진 호환 숫자를 구분합니다.
Safari/537.36을 Safari 앱의 최신 버전이라고 읽지 않습니다. - OS·기기 모델은 자기 신고·축약값일 수 있으므로 자산 DB와 비교합니다.
- 같은 호스트의 여러 UA는 여러 앱·업데이트·병렬 작업 때문일 수 있습니다. 단독으로 UA 회전 공격을 뜻하지 않습니다.
Brave 같은 Chromium 제품은 일반 Chrome과 구별되는 고유 토큰을 항상 제공하지 않습니다. “모든 정상 제품을 UA만으로 구분하는 완벽한 파서”는 만들 수 없습니다. Teams·Slack·Discord 같은 앱도 내장 웹 엔진·운영체제·버전에 따라 형식이 달라집니다. 제품명이 UA에 반드시 들어간다고 가정하지 말고 관리 중인 버전으로 기준선을 수집합니다.
CLI·개발 라이브러리 해석
curl/8.x, python-requests/2.x, PowerShell/...은 도구나 라이브러리 버전 단서입니다. 조직의 백업·배포·상태 검사·API 연계에서도 흔합니다. UA만 보면 스크립트 작성자·프로세스 경로·명령줄은 알 수 없습니다. Go-http-client/1.1의 1.1은 Go 언어 버전이 아닙니다. Java의 전통적 Java/ 형식과 최신·외부 HTTP 라이브러리는 같지 않을 수 있습니다.
Node 환경도 Axios HTTP 어댑터, 내장 Fetch, 독립 Undici, 직접 HTTP 요청의 기본값이 다를 수 있습니다. 브라우저에서 실행되는 Axios는 브라우저 네트워크 계층을 사용하므로 서버측 axios/가 반드시 나오지 않습니다. 관리 도구·SDK의 기본값은 버전별 소스와 실제 샘플로 검증하세요.
크롤러 이름 검증
Googlebot이라는 UA만 믿고 WAF 우회를 허용하면 안 됩니다. Google이 공개한 IP 범위와 대조하거나, 역방향 DNS의 도메인 경계를 확인한 뒤 정방향 조회가 원래 IP로 돌아오는지 확인합니다. googlebot.com.attacker.example은 Google 도메인이 아닙니다. 신뢰할 프록시에서만 원래 출발지 헤더를 받아야 하며 임의 X-Forwarded-For는 검증 근거가 아닙니다.
OpenAI의 GPTBot, OAI-SearchBot, ChatGPT-User는 용도가 다릅니다. 운영자는 공급자의 최신 문서·IP 범위·robots 정책 적용 범위를 함께 확인합니다. robots.txt는 협력적인 크롤러에 대한 요청이며 인증·접근 통제 수단이 아닙니다. 이름 없는 봇을 악성코드로 자동 분류하지 않습니다.
검색 가능한 정상 참고표
contains는 토큰 포함, prefix는 시작 부분, exact는 전체 값 일치입니다. 검색창은 편의를 위한 본문 부분 검색이며 탐지 엔진이 아닙니다. 표에 표시된 실제 일치 방식과 혼동하지 마세요. 표의 모든 항목은 2026-11-17 검토 기준입니다.
| ID / 문자열 | 뜻·연관 제품 | 근거·기간·주의점 |
|---|---|---|
UA001 · browser · containsChrome/ | Chrome / Chromium Chrome·Chromium 계열 표기. Edge·Opera에도 포함됩니다. | vendor-doc · living documentation MDN User-Agent reference 자기 신고 문자열입니다. 프로세스·목적지·승인 여부를 확인하세요. |
UA002 · browser · containsFirefox/ | Firefox Firefox 브라우저 제품·버전 표기입니다. | vendor-doc · living documentation MDN User-Agent reference 자기 신고 문자열입니다. 프로세스·목적지·승인 여부를 확인하세요. |
UA003 · browser · containsSafari/ | Safari compatibility token Safari 표기지만 Chromium에도 존재합니다. Version/와 다른 토큰을 함께 봅니다. | vendor-doc · living documentation MDN User-Agent reference 자기 신고 문자열입니다. 프로세스·목적지·승인 여부를 확인하세요. |
UA004 · browser · containsOPR/ | Opera 현대 Opera 제품 표기. Chromium 호환 토큰 뒤에 나타납니다. | vendor-doc · living documentation MDN User-Agent reference 자기 신고 문자열입니다. 프로세스·목적지·승인 여부를 확인하세요. |
UA005 · browser · containsCriOS/ | Chrome on iOS iOS용 Chrome 표기. 특정 엔진을 확정하는 값은 아닙니다. | vendor-doc · living documentation MDN User-Agent reference 자기 신고 문자열입니다. 프로세스·목적지·승인 여부를 확인하세요. |
UA006 · browser · containsFxiOS/ | Firefox on iOS iOS용 Firefox 식별 표기입니다. | vendor-doc · living documentation MDN User-Agent reference 자기 신고 문자열입니다. 프로세스·목적지·승인 여부를 확인하세요. |
UA007 · browser · containsOPT/ | Opera on iOS iOS용 Opera 식별 표기입니다. | vendor-doc · living documentation MDN User-Agent reference 자기 신고 문자열입니다. 프로세스·목적지·승인 여부를 확인하세요. |
UA008 · browser · containsEdg/ | Microsoft Edge desktop Chromium 기반 데스크톱 Edge 제품 표기. 앞에 다른 호환 토큰이 붙을 수 있습니다. | vendor-doc · living documentation Microsoft Edge UA guidance 자기 신고 문자열입니다. 프로세스·목적지·승인 여부를 확인하세요. |
UA009 · browser · containsEdgA/ | Microsoft Edge Android Android용 Edge 제품 표기. 앞에 다른 호환 토큰이 붙을 수 있습니다. | vendor-doc · living documentation Microsoft Edge UA guidance 자기 신고 문자열입니다. 프로세스·목적지·승인 여부를 확인하세요. |
UA010 · browser · containsEdgiOS/ | Microsoft Edge iOS iOS용 Edge 제품 표기. 앞에 다른 호환 토큰이 붙을 수 있습니다. | vendor-doc · living documentation Microsoft Edge UA guidance 자기 신고 문자열입니다. 프로세스·목적지·승인 여부를 확인하세요. |
UA011 · browser · containsEdge/ | Legacy EdgeHTML Edge 이전 EdgeHTML 기반 Edge 제품 표기. 앞에 다른 호환 토큰이 붙을 수 있습니다. | vendor-doc · living documentation Microsoft Edge UA guidance 자기 신고 문자열입니다. 프로세스·목적지·승인 여부를 확인하세요. |
UA012 · browser · containsSamsungBrowser/ | Samsung Internet 삼성 인터넷 브라우저 제품·버전 표기입니다. | vendor-doc · living documentation Samsung UA format 자기 신고 문자열입니다. 프로세스·목적지·승인 여부를 확인하세요. |
UA013 · browser · contains; wv | Android WebView 앱 내 Android 웹뷰의 흔한 기본 형식 표기입니다. 앱이 바꿀 수 있습니다. | vendor-doc · living documentation Android WebSettings 자기 신고 문자열입니다. 프로세스·목적지·승인 여부를 확인하세요. |
UA014 · library · prefixcurl/ | curl URL 데이터 전송 명령줄 도구. 자동화에서도 사용됩니다. | vendor-doc · living documentation curl manual 자기 신고 문자열입니다. 프로세스·목적지·승인 여부를 확인하세요. |
UA015 · library · prefixPostmanRuntime/ | Postman runtime API 요청·테스트 런타임 표기입니다. | vendor-doc · living documentation MDN User-Agent reference 자기 신고 문자열입니다. 프로세스·목적지·승인 여부를 확인하세요. |
UA016 · library · prefixpython-requests/ | Python Requests Python HTTP 라이브러리 기본 접두사. 숫자는 라이브러리 버전입니다. | vendor-doc · living source Requests default_user_agent source 자기 신고 문자열입니다. 프로세스·목적지·승인 여부를 확인하세요. |
UA017 · library · exactGo-http-client/1.1 | Go standard HTTP client Go 표준 HTTP 클라이언트 식별값. 1.1은 Go 컴파일러 버전이나 실제 HTTP 협상 결과를 증명하지 않습니다. | vendor-doc · living documentation Go net/http documentation 자기 신고 문자열입니다. 프로세스·목적지·승인 여부를 확인하세요. |
UA018 · library · containsJava/ | Java URLConnection family 전통적 Java HTTP 구현의 버전 표기. 모든 Java 클라이언트에 적용되지는 않습니다. | vendor-doc · Java 17 documentation Oracle Java networking properties 자기 신고 문자열입니다. 프로세스·목적지·승인 여부를 확인하세요. |
UA019 · library · containsPowerShell/ | PowerShell web cmdlets 웹 cmdlet 요청 표기. 플랫폼·버전에 따라 전체 값이 다르며 변경할 수 있습니다. | vendor-doc · living documentation Microsoft Invoke-WebRequest 자기 신고 문자열입니다. 프로세스·목적지·승인 여부를 확인하세요. |
UA020 · bot · containsGooglebot/ | Googlebot Google 검색 크롤러의 자기 신고 이름. 공개 IP 대역 또는 정방향 재확인 역방향 DNS로 검증합니다. | vendor-doc · living documentation Google crawler overview 자기 신고 문자열입니다. 프로세스·목적지·승인 여부를 확인하세요. |
UA021 · bot · containsAdsBot-Google | Google AdsBot Google 광고 관련 크롤러 표기입니다. | vendor-doc · living documentation Google crawler overview 자기 신고 문자열입니다. 프로세스·목적지·승인 여부를 확인하세요. |
UA022 · bot · containsGPTBot/ | GPTBot 모델 학습에 쓰일 수 있는 웹 크롤링. | vendor-doc · living documentation OpenAI crawler documentation 자기 신고 문자열입니다. 프로세스·목적지·승인 여부를 확인하세요. |
UA023 · bot · containsOAI-SearchBot/ | OAI-SearchBot ChatGPT 검색을 위한 색인·탐색. | vendor-doc · living documentation OpenAI crawler documentation 자기 신고 문자열입니다. 프로세스·목적지·승인 여부를 확인하세요. |
UA024 · bot · containsChatGPT-User/ | ChatGPT-User 사용자 요청에 따른 페이지 접근. 자동 학습 크롤링과 구분합니다. | vendor-doc · living documentation OpenAI crawler documentation 자기 신고 문자열입니다. 프로세스·목적지·승인 여부를 확인하세요. |
UA025 · tool · containsNmap Scripting Engine | Nmap NSE HTTP library 승인된 스캔 또는 정찰일 수 있습니다. 악성코드 이름이 아닙니다. | vendor-doc · living documentation Nmap HTTP library 자기 신고 문자열입니다. 프로세스·목적지·승인 여부를 확인하세요. |
UA026 · library · prefixWget/ | GNU Wget 명령줄 다운로더. 버전·플랫폼 정보가 뒤따를 수 있습니다. | vendor-doc · living documentation GNU Wget HTTP options 자기 신고 문자열입니다. 프로세스·목적지·승인 여부를 확인하세요. |
UA027 · library · prefixPython-urllib/ | Python urllib Python 표준 URL 클라이언트. 버전은 보통 Python 버전입니다. | vendor-doc · living documentation Python urllib HOWTO 자기 신고 문자열입니다. 프로세스·목적지·승인 여부를 확인하세요. |
UA028 · library · prefixrclone/v | rclone 클라우드·저장소 전송 도구. 실행 주체·계정·전송 방향을 조사합니다. | vendor-doc · living documentation rclone global flags 자기 신고 문자열입니다. 프로세스·목적지·승인 여부를 확인하세요. |
UA029 · library · containsaws-cli/ | AWS CLI AWS 명령줄 도구 표기. AWS가 보낸 요청이나 정당한 권한임을 증명하지 않습니다. | vendor-doc · living documentation with historical examples AWS CLI troubleshooting examples 자기 신고 문자열입니다. 프로세스·목적지·승인 여부를 확인하세요. |
UA030 · library · containsbotocore/ | AWS Botocore AWS Python SDK 핵심 라이브러리 표기입니다. | vendor-doc · living documentation with historical examples AWS CLI troubleshooting examples 자기 신고 문자열입니다. 프로세스·목적지·승인 여부를 확인하세요. |
UA031 · library · prefixaxios/ | Axios JavaScript HTTP 클라이언트, 특히 서버측 HTTP 어댑터 표기. 브라우저에서는 브라우저 UA를 보낼 수 있습니다. | vendor-doc · v1.x source inspected Axios HTTP adapter source 자기 신고 문자열입니다. 프로세스·목적지·승인 여부를 확인하세요. |
UA032 · library · exactundici | Undici standalone Fetch 검토한 소스의 독립 Undici Fetch 기본값. API·빌드에 따라 다릅니다. | vendor-doc · living source; build-dependent default Undici Fetch implementation source 자기 신고 문자열입니다. 프로세스·목적지·승인 여부를 확인하세요. |
UA033 · library · exactnode | Node bundled Fetch 검토한 소스의 Node 내장 Fetch 빌드 기본값. 모든 Node HTTP 요청의 공통값은 아닙니다. | vendor-doc · living source; build-dependent default Undici Fetch implementation source 자기 신고 문자열입니다. 프로세스·목적지·승인 여부를 확인하세요. |
UA034 · library · prefixMicrosoft BITS/ | Background Intelligent Transfer Service Windows 백그라운드 전송 서비스 형식. BITS 작업 소유자와 함께 확인합니다. | vendor-doc · documented traffic example Zeek documented BITS HTTP example 자기 신고 문자열입니다. 프로세스·목적지·승인 여부를 확인하세요. |
일치하는 항목이 없습니다. 목록에 없다는 것은 안전하다는 뜻이 아닙니다.
표에 없는 흔한 정상 형태를 다루는 방법
okhttp/, Apache-HttpClient/, CFNetwork/, Darwin/, Electron/, HeadlessChrome/, git/, AzureCLI/ 같은 표기를 만날 수 있습니다. 이 목록은 이름을 알아두기 위한 예시이며 여기서 각 버전의 기본값을 검증한 사전 항목은 아닙니다. 소스·공급자 문서·설치된 버전의 통신을 확인한 뒤 로컬 기준선에 추가하세요. 자동 브라우저도 헤드리스 표기를 숨기거나 일반 브라우저처럼 동작할 수 있으므로 헤드리스 문자열의 부재는 사람이 사용한다는 증거가 아닙니다.
오탐을 줄이는 허용 조건
허용 조건은 UA만이 아니라 자산 그룹 + 실행 주체 + 승인 목적지 + 예정 시간 + UA 범위 + 만료일로 만듭니다. 예를 들어 백업 서버의 Requests는 정상일 수 있지만 직원 PC에서 처음 등장해 외부 IP로 대량 POST하면 별도 조사가 필요합니다. rclone·RMM 등 정상 도구도 계정·전송 방향·작업 승인 없이 허용하지 않습니다.
추가 근거
Google 요청 검증 · OpenAI 봇 안내 · Requests의 UA 변경 가능성 · 악성 사용과 중복 사례