문제 해결 / FAQ

자주 발생하는 증상과 해결 방법을 모았습니다. 기능별 트러블슈팅은 각 페이지에도 정리돼 있습니다.

로그인 / 계정

증상	원인 / 해결
로그인이 안 됨	이메일/비밀번호 확인. Google OAuth 사용 조직이면 같은 방식으로 로그인하세요.
로그인은 되는데 통제/대시보드가 비어 있음	아직 조직이 없거나 조직에 소속되지 않음. 온보딩에서 조직을 만드세요. (회사 IdP/OAuth 연동으로 합류한 경우 자동으로 소속됩니다.)
일부 메뉴/버튼이 안 보임	역할 권한 문제. 관리자(ADMIN) 전용 기능은 뷰어(VIEWER) 에게 보이지 않습니다.

AWS 연동

증상	원인 / 해결
연결 검증 실패 (AssumeRole 거부)	Role ARN 오타, 또는 신뢰 정책에 ISMS Doctor 계정/External ID 미포함. AWS 연결 절차 재확인.
일부 서비스만 점검됨 / UNKNOWN 다수	역할 권한 부족. read-only 권한 정책 범위를 확인하세요.
스캔이 너무 느리거나 비용이 큼	리소스 많은 계정. 비용 추정으로 사전 확인 후 주기 조정.

GitHub 연동

증상	원인 / 해결
Code Scanning 만 동기화 안 됨	대상 저장소에 GitHub Advanced Security 미활성(정상 동작).
동기화 후 경보 0건	App 설치 범위에 해당 저장소 미포함. 설치 범위 확인.
설치 콜백이 안 돌아옴	팝업 차단/세션 만료. 다시 로그인 후 재시도.

코드 스캔

증상	원인 / 해결
"파싱 실패" 토스트	scanner/backend schemaVersion 불일치. docker pull ...:latest 후 재실행.
업로드 거부(50MB 초과)	monorepo 를 패키지별로 나눠 스캔.
PII 컬럼 누락	미지원 ORM. 현재 Prisma/SQLAlchemy/JPA 만 지원.
보고서에 결과 안 보임	zip 업로드 후 보고서를 새로 다운로드해야 반영됨.

자세한 내용은 코드 스캔 페이지를 참고하세요.

점검 / 통제

증상	원인 / 해결
통제가 너무 많거나 적게 보임	인증 스코프(certType)가 의도와 다를 수 있음. 설정에서 확인. 인증 스코프 참조.
자동 PASS 인데 최종 PASS 가 아님	수동 검증이 필요한 항목. 수동 검증 에서 확정.
만료 후 통제 충족이 풀림	증적/수동 검증 유효기간 만료. 갱신 후 재검증.

알림 / 보고서

증상	원인 / 해결
Slack 알림이 안 옴	설정 → 알림에서 Slack 채널 토글과 웹훅 URL 확인.
보고서 내용이 오래됨	보고서는 생성 시점 데이터. 최신 점검/증적 반영 후 다시 생성하세요.
연간 보고서 다운로드 불가	ADMIN 전용. 권한 있는 계정으로 시도.

그래도 해결되지 않으면

화면 우상단/설정의 지원 채널로 문의하거나, 발생 시각과 증상(스크린샷 포함)을 정리해 전달하면 감사 로그와 대조해 빠르게 원인을 파악할 수 있습니다.