도구 소개
인증은 API 테스트에 가장 먼저 필요하면서도 헷갈리는 401의 흔한 원인입니다. 비ASCII 문자가 든 비밀번호를 btoa로 인코딩하거나, 이미 “Bearer”가 붙은 토큰을 붙여 넣거나, API 키를 쿼리 문자열로 보내 로그에 남는 경우입니다. 이 도구는 Basic 인증(RFC 7617, Base64 전에 UTF-8 인코딩), Bearer 토큰(RFC 6750), 헤더나 쿼리 파라미터의 API 키에 맞는 헤더를 만들고, 대응하는 curl 명령어와 환경 변수에서 시크릿을 읽는 extraHTTPHeaders 기반 Playwright 설정을 보여 줍니다. OAuth 2.0 클라이언트 자격 증명은 고정 헤더를 보내는 대신 자격 증명을 토큰으로 교환하는 흐름이므로, 토큰 요청을 curl과 간단한 Playwright 헬퍼로 보여 줍니다. 입력값은 저장되거나 어디로도 전송되지 않습니다.
사용 방법
- 방식을 고르세요: Basic, Bearer 토큰, API 키, OAuth 2.0 클라이언트 자격 증명.
- 자격 증명과 요청 URL을 입력하세요. Basic 사용자 이름의 콜론이나 일반 http:// 같은 흔한 실수에는 경고가 표시됩니다.
- 헤더 줄, curl 명령어, Playwright 스니펫을 복사하고, 커밋하기 전에 시크릿을 환경 변수로 옮기세요.
인증 헤더 생성기 자주 묻는 질문
Basic 인증의 Base64는 암호화인가요?
아니요. Base64는 누구나 되돌릴 수 있는 인코딩입니다. Basic 인증은 HTTPS에서만 안전하며, 자격 증명이 요청마다 전송됩니다.
내 비밀번호에서 btoa가 실패하는 이유는 무엇인가요?
btoa는 Latin-1 문자만 받으므로 €나 이모지 같은 문자는 오류를 발생시킵니다. RFC 7617은 UTF-8을 권장하므로, 이 도구는 텍스트를 먼저 UTF-8 바이트로 인코딩합니다. UTF-8을 기대하는 서버는 이를 그대로 디코딩합니다.
테스트 자격 증명은 어디에 보관해야 하나요?
저장소가 아니라 환경 변수나 CI 시크릿 저장소에 보관하세요. 그래서 Playwright 스니펫은 process.env 값을 읽습니다. 최소 권한의 전용 테스트 계정과 수명이 짧은 토큰을 사용하는 것이 좋습니다.