--- title: "사용자 에이전트(User Agent) 재정의 방법" slug: "how-to-override-the-user-agent" updated: 2026-06-02T06:44:38Z published: 2026-06-02T06:44:38Z canonical: "helpcenter.autify.com/how-to-override-the-user-agent" stale: true --- > ## Documentation Index > Fetch the complete documentation index at: https://helpcenter.autify.com/llms.txt > Use this file to discover all available pages before exploring further. # 사용자 에이전트(User Agent) 재정의 방법 ## 개요 테스트 대상 웹사이트가 User Agent를 기반으로 표시를 전환하거나 액세스 제어를 수행하는 경우, Autify Nexus의 기본 설정에서는 의도한 페이지가 표시되지 않거나 액세스가 차단될 수 있습니다. 본 문서에서는 Autify Nexus에서 전송하는 User Agent를 원하는 값으로 덮어써서 이 문제를 해결하는 절차를 설명합니다. ## 해결 절차 용도에 맞게 "앱 설정" 또는 "테스트 플랜 설정"에서 User Agent를 덮어씁니다. ### 방법 A: 앱 설정에서 덮어쓰기 (레코딩 및 로컬 실행용) 이 절차에서 설정한 User Agent는 로컬 PC에서의 레코딩 및 로컬 실행 시 적용됩니다. 클라우드 환경에서의 테스트 실행에는 영향을 미치지 않습니다. 1. Autify Nexus 화면 왼쪽 아래에 있는 **설정** (![](https://cdn.document360.io/c040854c-2c75-49d0-98e1-43f462e8657e/Images/Documentation/settings(8).png?sv=2026-02-06&spr=https&st=2026-11-16T22%3A53%3A26Z&se=2026-11-16T23%3A53%3A26Z&sr=b&sp=r&sig=l8nu6AfR0xZ6HojM%2B1KJi29sxYUYXvqyooKP4UvqsIM%3D))를 클릭합니다. 2. 화면을 아래로 스크롤하여 **로컬 실행**을 확장합니다. 3. **JSON 문자열 입력** 오른쪽에 있는 **편집 아이콘** (![](https://cdn.document360.io/c040854c-2c75-49d0-98e1-43f462e8657e/Images/Documentation/pen(2).png?sv=2026-02-06&spr=https&st=2026-11-16T22%3A53%3A26Z&se=2026-11-16T23%3A53%3A26Z&sr=b&sp=r&sig=xU4n1J%2FjNEQEoSeeM1b7uPdWe6KVf7DtViVm6YpH51o%3D))을 클릭합니다. 4. ## **고급 브라우저 옵션** 화면이 표시되면, 다음과 같이 `userAgent`를 추가합니다. ```json {  "userAgent": "임의의 User Agent 문자열" } ``` ![](https://cdn.document360.io/c040854c-2c75-49d0-98e1-43f462e8657e/Images/Documentation/Screenshot 2026-05-27 at 17.03.03.png?sv=2026-02-06&spr=https&st=2026-11-16T22%3A53%3A26Z&se=2026-11-16T23%3A53%3A26Z&sr=b&sp=r&sig=VMAwwFes0sMROcDG0IChhhScJBJk712CgdC9ZMWgevA%3D) 5. **저장**를 클릭합니다. ### 방법 B: 테스트 플랜 설정에서 덮어쓰기 (클라우드 실행용) 이 절차에서 설정한 User Agent는 대상 테스트 플랜을 실행할 때 적용됩니다. 1. 대상 테스트 플랜의 상세 화면을 엽니다. 2. **Test plan settings** 섹션 내의 **고급 설정** 를 클릭하여 확장합니다. 3. **JSON 문자열 입력**을 클릭합니다. 4. ## **고급 브라우저 옵션** 화면이 표시되면, 다음과 같이 `userAgent`를 추가합니다. ```json {  "userAgent": "임의의 User Agent 문자열" } ``` ![](https://cdn.document360.io/c040854c-2c75-49d0-98e1-43f462e8657e/Images/Documentation/Screenshot 2026-05-27 at 17.06.34.png?sv=2026-02-06&spr=https&st=2026-11-16T22%3A53%3A26Z&se=2026-11-16T23%3A53%3A26Z&sr=b&sp=r&sig=xxYLbSCCffaLN3yZXbnYR21nUjdWk6Z7WFIXpabawHg%3D) 5. **완료**을 클릭합니다. ### 유의 사항 - **설정의 우선순위**: User Agent는 다음 순서로 우선적으로 적용됩니다. - 로컬 실행의 경우1. Nexus 앱 설정2. 테스트 플랜 설정3. 기기 에뮬레이션 설정 - 클라우드 실행의 경우1. 테스트 플랜 설정2. Nexus 앱 설정3. 기기 에뮬레이션 설정 - **설정 해제**: User Agent 덮어쓰기를 중지하려면 입력한 `userAgent` 행을 삭제하고 저장하십시오. ## 해결되지 않는 경우 위의 절차를 시도해도 문제가 해결되지 않으면 지원 창구로 문의해 주십시오.