권한 요약·문제 해결
등급별 권한 차이를 확인하고 자주 발생하는 문제와 관리자 전달용 진단 정보를 정리합니다.
등급별 권한 요약
| 기능 | Owner | Admin | Explorer | Member |
|---|---|---|---|---|
| AI 채팅·프로젝트·보고서·북마크 | ● | ● | — | — |
| 기본 대시보드 | ● | ● | ●* | ●* |
| 리소스 맵 | ● | ● | ●* | ●* |
| 잠긴 프로젝트 구조·접근 요청 | ● | ● | ● | — |
| 워크플로 오류 알림 | ● | ● | ●* | ●* |
| 노드 정책·감사로그 | ● | ● | — | — |
| 멤버·조직·비용·연동·인증 관리 | ● | ● | — | — |
| Token Usage 데이터 보정 | ● | ● | — | — |
| SSO/LDAP 우회·MFA 필수 예외 | ● | — | — | — |
* n8n 계정 링크가 필요하며 n8n에서 본인에게 허용된 리소스만 표시됩니다. 승인 대기 사용자는 로그인해도 대기 화면 외 기능을 사용할 수 없습니다.
자주 묻는 질문
- 인스턴스를 추가했는데 AI 채팅의 범위에 나오지 않습니다.
- 설정 → 연동에서 상태와 스키마 스캔을 확인하고 재스캔합니다. 스캔 완료 전 인스턴스는 분석 범위에 표시되지 않을 수 있습니다.
- Member/Explorer인데 리소스 맵이나 대시보드 데이터가 없습니다.
- 프로필의 n8n 계정 링크를 연결하고 API Key 만료와 n8n 원본 권한을 확인합니다.
- 워크플로 오류 알림이 오지 않습니다.
- n8n Log Streaming에 Nelper Webhook이 등록됐는지, 설정 → 연동의 마지막 이벤트 수신 시각이 갱신되는지 확인합니다.
- n8n 감사 이벤트가 비어 있습니다.
- Log Streaming destination에서 Audit 이벤트 구독을 켭니다. 구독 전 이벤트는 자동 소급 수집되지 않습니다.
- Error Workflow 할당 목록이 비어 있습니다.
- n8n에 Error Trigger로 시작하는 워크플로가 있고 Published 상태인지 확인합니다. Nelper는 Error Workflow를 자동 생성하지 않습니다.
- Error Workflow 할당이 실패합니다.
- 인스턴스 n8n API Key가 등록됐는지, 연결 검증에서 필요한 workflow 권한과 만료 상태가 정상인지 확인합니다.
- AI Insight에 Addon 연결 필요가 표시됩니다.
- 설정 → 연동에서 AI Workflow Addon URL과 API Secret을 저장하고 Health Check를 통과한 뒤 활성화합니다.
- 채팅·보고서·분석 버튼이 ‘한도 도달’로 비활성화됩니다.
- 비용·사용량 → Nelper AI 비용의 기능별 월 한도를 확인합니다. 한도는 매월 1일 UTC에 초기화됩니다.
- Token Usage 예상 비용이 보이지 않습니다.
- LiteLLM 가격표 조회 네트워크와 모델명 매칭을 확인합니다. 실제 비용이 아니라 추정치임도 함께 확인합니다.
- 노드 정책이 정상 워크플로를 위반으로 표시합니다.
- 정책의 실제 필드 경로와 마스킹 값을 확인하고, 표현식·서브도메인·포트·대소문자를 반영해 조건을 조정합니다.
- 노드 정책 자동 게시 해제가 실패합니다.
- n8n API Key의 workflow:read와 workflow:deactivate 권한, 키 만료와 대상 워크플로 Published 상태를 확인합니다.
- MFA 인증기와 복구 코드를 모두 잃었습니다.
- Owner/Admin에게 멤버 관리의 MFA 초기화를 요청하고 다음 로그인에서 MFA를 다시 등록합니다.
- 승인됐는데 계속 가입 대기 화면이 표시됩니다.
- 완전히 로그아웃한 뒤 다시 로그인합니다. 계속되면 멤버 화면에서 승인 상태와 등급을 확인합니다.
- 프로젝트 공유 링크를 상대가 열지 못합니다.
- 같은 Nelper 조직에 로그인한 Owner/Admin인지 확인합니다. Member/Explorer는 AI 프로젝트에 접근할 수 없습니다.
- AI 채팅 대화가 사라졌습니다.
- 채팅 기록은 화면 이동이나 새로고침 뒤 유지되지 않습니다. 생성 결과는 사이드바 프로젝트 또는 보고서에서 다시 엽니다.
관리자에게 전달할 진단 정보
- 발생 시각과 사용한 사용자 등급
- 대상 n8n 인스턴스명과 화면 경로
- 재현 순서와 화면에 표시된 오류 문구
- 인스턴스 연결·스캔·마지막 이벤트 수신 상태
- 관련 감사 이벤트 ID 또는 워크플로 Execution ID
진단 정보를 공유하기 전에 비밀번호, API Key, Client Secret, LDAP Binding Password, Webhook URL의
비밀값, MFA QR/복구 코드와 원본 payload의 개인정보를 반드시 가립니다.