기본 인증으로 보호된 URL을 테스트하는 방법

Prev Next

이 문서는 기본 인증(Basic Authentication)으로 보호된 웹사이트나 페이지를 테스트하는 방법을 설명합니다.

기본 인증이 설정된 페이지에서 테스트를 실행하려면, 인증 정보(사용자 이름과 비밀번호)를 시나리오에 전달해야 합니다. 인증 정보를 설정하는 방법에는 여러 가지가 있습니다.

방법 1: URL에 인증 정보 포함하기

가장 쉽고 일반적인 방법은 시나리오의 URL 자체에 인증 정보를 직접 포함하는 것입니다. 이 방법은 시나리오의 시작 URL이나 "페이지 전환" 스텝에서 사용할 수 있습니다.

순서

  1. 기존 시나리오를 편집하거나 새 시나리오를 생성합니다.

  2. 인증이 필요한 페이지의 URL을 다음 형식으로 지정합니다.

    https://<username>:<password>@<domain>/<path>

    • <username><password>를 실제 인증 정보로 바꾸세요.

예시

예를 들어, 사용자 이름이 taro이고 비밀번호가 hunter2이며 접속하려는 URL이 https://website.example.com/some/page인 경우, URL을 다음과 같이 설정합니다.

https://taro:hunter2@website.example.com/some/page

방법 2: "Playwright 코드 스텝" 사용하기 (지원 중단됨)

"Playwright 코드 스텝"을 사용하여 기본 인증을 통과할 수도 있습니다.

이 방법은 주로 다음과 같은 특수한 경우에 유용합니다.

  • URL로 직접 이동하는 대신, 링크나 버튼을 클릭하여 기본 인증이 필요한 페이지로 이동하는 경우

  • 하나의 시나리오 내에서 서로 다른 인증 정보가 필요한 여러 사이트를 테스트하는 경우

순서

  1. 기본 인증을 요청하는 동작(예: "페이지 전환" 스텝) 바로 앞에 "Playwright 코드 스텝"을 추가합니다.

  2. 아래 코드를 입력 필드에 붙여넣고 인증 정보를 수정합니다.

    await context.setHTTPCredentials({
      username: "<username>",
      password: "<password>"
    });
    
    • <username><password>를 실제 인증 정보로 바꾸세요.

참고: setHTTPCredentials 사용은 Playwright에서 지원 중단(Deprecated)되었습니다. 특별한 이유가 없는 한, 방법 1 또는 방법 3을 사용하는 것을 권장합니다.

방법 3: 테스트 플랜의 고급 옵션에서 설정하기

테스트 플랜 전체에 대해 기본 인증 정보를 한 번에 설정할 수도 있습니다. 이 방법을 사용하면 해당 테스트 플랜에 포함된 모든 시나리오에 동일한 인증 정보가 적용됩니다.

순서

  1. 대상 테스트 플랜을 엽니다.

  2. "고급 옵션"을 클릭합니다.

  3. 아래 JSON 코드를 복사하여 입력 필드에 붙여넣습니다.

    {
      "httpCredentials": {
        "username": "<username>",
        "password": "<password>"
      }
    }
    
    • <username><password>를 실제 인증 정보로 바꾸세요.

  4. "완료" 버튼을 클릭하여 설정을 저장합니다.

더 자세한 내용은 Playwright 공식 문서를 참고하세요: Playwright - testOptions.httpCredentials

궁금한 점이 있으시면 언제든지 지원팀에 문의해 주세요.