개요
관리자 콘솔은 포털(뷰어 SPA)의 설정을 AWS 콘솔 없이 웹 UI로 관리할 수 있는 별도의 SPA입니다. 포털 헤더 우측의 “관리자” 링크를 통해 접근하며, 경로는/admin 입니다.
접근 권한
- 설치 시 입력한 관리자 이메일이 Cognito
admin그룹에 자동으로 등록되어 있습니다. - 관리자 콘솔은 이메일/비밀번호 로그인 고정입니다 (Google OAuth, SSO는 뷰어 로그인에만 적용됩니다).
- 다른 사용자를 관리자로 추가하는 기능은 현재 제공되지 않습니다 (초기 1명).
관리자 이메일 외 사용자가
/admin에 접근하면 접근 거부 화면이 표시됩니다.메뉴
관리자 콘솔 사이드바에는 5개 메뉴가 있습니다.1. 브랜딩
업로드한 로고와 표시 이름은 포털을 여는 모든 사용자에게 공통 적용됩니다.
2. 인증 설정
포털 뷰어(/) 로그인 방식을 설정합니다. 관리자 콘솔(/admin)에는 영향을 주지 않습니다.
이메일 / 비밀번호 (기본 활성)
Google 로그인
Client ID와 Client Secret을 모두 저장하면 포털 로그인 화면에 “Google로 로그인” 버튼이 추가됩니다. 사전 준비:- Google Cloud Console → Google Auth Platform → 앱 정보 입력 (대상: 내부)
- OAuth 2.0 클라이언트 ID 생성 (애플리케이션 유형: 웹 애플리케이션)
- 관리자 콘솔 화면에 안내되는 승인된 리디렉션 URI를 복사하여 OAuth 클라이언트에 등록
- 발급받은 Client ID / Client Secret을 관리자 콘솔에 입력 → 저장
3. 사용자
Cognito 기준 포털 사용자 목록을 관리합니다.
삭제 버튼으로 사용자를 제거할 수 있습니다 (본인 제외). 삭제 시 Cognito 계정과 QuickSight Reader 등록이 함께 정리됩니다.
4. 라이센스
AWS Marketplace 라이센스 상태와 제품 버전을 확인합니다.5. 커스텀 도메인
포털 접속용 자체 도메인(예:dashboard.customer.com)을 등록합니다. 등록 전까지는 기본 CloudFront 엔드포인트(https://xxxxx.cloudfront.net)로 접속합니다.
등록 절차
- 관리자 콘솔 → 커스텀 도메인 → 도메인 입력 → 등록 시작
- 화면에 표시되는 CNAME 3개를 자체 DNS에 추가
- ACM 인증서 검증용 CNAME 2개 (영구 유지 필요)
- 사이트 접속용 CNAME 1개
- ACM이 자동으로 DNS 검증을 수행 (보통 5~10분)
- 검증 완료 후 상태가
ISSUED로 바뀌고 HTTPS 접속 가능
상태 표시
상태 새로고침 버튼으로 검증 진행 상태를 확인할 수 있습니다.
도메인을 변경하려면 기존 도메인을 제거한 뒤 새로 등록하세요.