Skip to content

[Feat] openapi-typescript redocly 스크립트 추가 #193

Closed

Description

@yooncandooit

✨ 작업 내용

프론트엔드는 openapi-typescript로 백엔드 Swagger 스펙에서 API 타입을 자동 생성(pnpm generate:types)합니다
그런데 prod에서 Swagger UI + API 스펙 JSON(/api-docs) 경로가 Basic 인증(username/pw)으로 보호되어 있어, 라이브러리가 인증 정보를 모른 채 요청하면 401이 발생해 타입을 가져오지 못하는 문제가 발생하고 있습니다

→ openapi-typescript이 내부적으로 사용하는 redocly/openapi-core의 resolve.http.headers 설정을 이용해, 원격 스펙을 가져올 때 Authorization: Basic … 헤더를 함께 전송하도록 처리하여 해결할 예정입니다
값은 .env의 SWAGGER_BASIC_AUTH에서 읽어오므로 스크립트 수정 없이 pnpm generate:types 한 번으로 인증된 타입 생성이 가능합니다 (BE CI 의존 없이 FE에서 자체 해결하도록)

✅ 작업 상세 내용(check-list)

  • 레포 루트에 redocly.yaml 추가 (resolve.http.headers → env 변수명만 기재)
  • .env에 SWAGGER_BASIC_AUTH="Basic <base64(user:password)>" 추가
  • 타입 가져오기 확인

Activity

  1. added a commit that references this issue on Jul 12, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions