Documentation Index
Fetch the complete documentation index at: https://docs.studynest.kr/llms.txt
Use this file to discover all available pages before exploring further.
개요
권한, 활성 테넌트, 역할 바인딩 문제를 순서대로 점검합니다. 이 문서는 StudyNest의 현재 메뉴 구조를 기준으로 작성되었습니다.대상 사용자
- Platform 관리자
- Tenant 관리자
- Service 사용자
- API 개발자
필요한 권한
- 작업에 맞는 역할과 권한
접근 경로
/
작업 전 확인사항
- Active Tenant가 올바른지 확인합니다.
- 작업 대상 사용자의 권한과 역할을 확인합니다.
- 변경 영향 범위를 확인합니다.
작업 절차
- 증상을 분류합니다.
- 계정, 권한, Active Tenant를 먼저 확인합니다.
- API 또는 애플리케이션 로그를 확인합니다.
- 필요한 경우 관리자에게 조치를 요청합니다.
작업 결과 확인
- 변경 후 대상 목록이나 상세 화면을 새로 고칩니다.
- 감사 로그 또는 최근 활동에 작업 이력이 남았는지 확인합니다.
- 관련 사용자가 의도한 메뉴와 데이터에 접근할 수 있는지 확인합니다.
문제 해결
| 증상 | 1차 확인 | 2차 확인 |
|---|---|---|
| 로그인 실패 | 계정 상태, 테넌트 slug | 세션 또는 인증 로그 |
| 메뉴 미노출 | 권한, 활성 테넌트 | 역할 바인딩 |
| API 401/403 | JWT, 권한 | 테넌트 context |
| API Key 호출 실패 | Key 상태, 만료일 | 프로젝트 또는 서비스 연결 |
| OCI 작업 실패 | 작업 상태 | OCI 콘솔 리소스 |
| 메일 미발송 | SMTP 설정 | 애플리케이션 로그 |
관련 문서
ko/concepts/permissions- 권한 모델 요약