Dongholab Auth

DonghoLab 공통 인증/인가 API입니다.

Public endpoints

항목	값
Public domain	https://auth.dongholab.com
PM2 process	dongholab-auth
Internal target	127.0.0.1:3320
OpenAPI	https://auth.dongholab.com/openapi.json
Swagger UI	/swagger

Docs login flow

docs.dongholab.com은 Mac mini/Caddy가 아니라 GitHub Pages의 private visibility/access control 기능으로 보호합니다.

흐름은 아래와 같습니다.

1. 사용자가 https://docs.dongholab.com 접속
2. GitHub Pages가 GitHub 로그인 상태를 확인
3. 로그인하지 않았으면 GitHub 로그인 화면으로 이동
4. 로그인 후 macmini-deploy-status repository read access를 확인
5. 권한이 있는 사용자에게만 Docusaurus 문서 표시
6. Docusaurus의 /swagger 페이지가 https://auth.dongholab.com/openapi.json을 읽어 Swagger UI 표시

GitHub Pages requirements

GitHub Pages private visibility는 GitHub 자체 기능을 사용하므로 별도 GitHub OAuth App이나 Caddy forward_auth가 필요 없습니다.

필요한 설정:

• Repository visibility: private
• GitHub Pages visibility: private
• Custom domain: docs.dongholab.com
• HTTPS enforced: enabled
• Access 대상: repository read access가 있는 GitHub 사용자/팀

주의:

• GitHub 공식 문서 기준, private Pages access control은 GitHub Enterprise Cloud organization 소유 private/internal project site에서 제공됩니다.
• 현재 repo가 개인 계정 gongdongho12 소유라면, GitHub UI/API에서 Pages visibility: private 전환이 가능한지 확인해야 합니다.
• 가능하다면 GitHub Pages가 인증을 전담하므로 Mac mini는 문서 호스팅/로그인에 관여하지 않습니다.