Postman을 활용한 JWT 인증 API 테스트 자동화: REST & GraphQL

핵심 기술

Postman의 Pre-request Script 기능을 활용하여 JWT 토큰을 자동으로 발급받고 API 요청 헤더에 추가함으로써, 인증이 필요한 API 엔드포인트 테스트를 자동화하는 방법을 소개합니다.

기술적 세부사항

• Bearer Token 변수 설정: Postman 컬렉션에서 bearerToken과 같은 변수를 생성하여 토큰 값을 저장합니다.
• 인증 요청 및 토큰 발급: 로그인 API 또는 GraphQL mutation을 사용하여 사용자 인증을 수행하고 JWT 토큰을 응답으로 받습니다.
  • GraphQL 예시: userSignIn mutation을 통해 이메일과 비밀번호로 토큰을 발급받습니다.
  • REST API 예시: 로그인 엔드포인트에 사용자 자격 증명을 POST 요청하여 access_token을 발급받습니다.
• Pre-request Script 작성:
  • pm.sendRequest 함수를 사용하여 인증 API에 요청을 보냅니다.
  • 응답으로 받은 토큰을 pm.collectionVariables.set('bearerToken', ...) 또는 pm.environment.set('bearerToken', ...)을 사용하여 컬렉션 또는 환경 변수에 저장합니다.
  • 이 스크립트는 해당 요청 전에 실행되어 항상 최신 유효한 토큰을 확보합니다.
• 토큰 사용: 저장된 bearerToken을 API 요청의 Authorization 헤더에 Bearer {{bearerToken}} 형식으로 자동으로 삽입하여 사용합니다.
• 디버깅 팁: Postman 콘솔 (Ctrl+Alt+C)을 사용하여 스크립트 실행 결과를 확인합니다.

개발 임팩트

• 테스트 효율성 증대: 반복적인 토큰 복사-붙여넣기 작업을 제거하여 API 테스트 속도를 크게 향상시킵니다.
• 워크플로우 간소화: 개발 및 테스트 과정에서 인증 관련 수작업을 줄여 생산성을 높입니다.
• 일관성 있는 테스트: 모든 요청에 대해 최신 인증 토큰이 사용되도록 보장하여 테스트의 일관성을 유지합니다.

커뮤니티 반응

Postman의 강력한 스크립팅 기능을 활용하여 API 테스트 워크플로우를 자동화하는 것은 개발자들 사이에서 널리 사용되는 패턴이며, 생산성 향상에 기여하는 유용한 팁으로 여겨집니다.