작성자: George Curta ·
백엔드 API URL이 거부됨 (SSRF 허용 목록)
앱이 백엔드 API URL 저장을 거부하거나, 요청이 URL 허용 안 됨 오류로 실패합니다.
발생 원인
두 앱 모두 요청을 보내기 전에 구성된 백엔드 API URL을 런타임에서 검증되는 호스트 허용 목록(UrlGuard)과 대조합니다. 이 SSRF 보호 장치는 악의적이거나 잘못 구성된 URL이 앱의 Bearer 토큰을 공격자가 제어하는 호스트로 절대 보내지 못하도록 존재합니다. anonym.legal과 anonymize.business(DEV 호스트)만 허용되며, 다른 모든 호스트는 의도적으로 거부됩니다.
해결 방법
- 1.백엔드 API URL로 정확히 https://anonym.legal(프로덕션) 또는 https://anonymize.business(DEV)를 사용하세요.
- 2.URL에서 후행 경로, 포트, 오타를 모두 제거하세요 — 허용 목록은 호스트명을 정확히 일치시킵니다.
- 3.정당한 호스트가 거부된다고 생각되면 지원팀에 문의하세요 — 허용 목록은 의도적으로 사용자가 편집할 수 없습니다.
"새 버전을 사용할 수 있습니다" 알림
앱의 관리자 설정에 새 버전이 있다는 알림이 표시됩니다.
발생 원인
두 앱 모두 주기적으로 새 버전을 확인하고, 새 버전이 있으면 변경 로그 링크가 포함된 간단한 관리자 알림을 표시합니다. 이는 수동 업그레이드 알림이며 자동 업데이트가 아닙니다 — Nextcloud 인스턴스에 자동으로 설치되는 것은 없습니다.
해결 방법
- 1.알림의 변경 로그 링크를 따라가 변경 사항을 확인하세요.
- 2.GitHub releases 페이지에서 새 앱 아카이브를 다운로드하세요.
- 3.apps/에 압축 해제하고 occ upgrade를 실행하세요 — 최초 설치와 동일한 수동 설치 단계이며, 원하는 일정에 맞춰 진행하면 됩니다.
403 오류: "Basic 플랜 이상 필요"
앱의 API 호출이 403 상태와 함께 Basic 플랜 이상이 필요하다는 메시지로 실패합니다.
발생 원인
두 Nextcloud 앱 모두 Basic 플랜 이상의 anonym.legal 계정이 필요합니다. 무료 플랜에는 이 앱들이 의존하는 API 접근이 포함되어 있지 않으므로, 백엔드는 조용히 실패하는 대신 "Nextcloud integration requires Basic plan or higher. Please upgrade your plan."라는 메시지와 함께 403을 반환합니다.
해결 방법
- 1.구성된 토큰이 어느 anonym.legal 계정에 속하는지 확인하세요.
- 2.해당 계정을 Basic 플랜 이상으로 업그레이드하세요.
- 3.요청을 다시 시도하세요 — 계정이 업그레이드되면 재설치나 재구성 없이 바로 작동합니다.
통합 토큰이 암호화 키를 읽지 못합니다 — 버그인가요?
구성된 토큰으로 복호화된 키 자료를 가져오려는 요청이 거부됩니다.
발생 원인
아니요 — 이는 의도된 동작입니다. 이 앱들이 사용하는 토큰은 통합 전용 토큰으로, 전체 계정 API 토큰보다 의도적으로 더 제한되어 있습니다. 콘텐츠를 분석하고 익명화할 수는 있지만, 복호화된 키 자료를 반환하는 모든 엔드포인트는 통합 전용 토큰에 대해 403을 반환하므로, Nextcloud 서버가 침해당하더라도 가역적 암호화 기록을 복호화하는 데 결코 사용될 수 없습니다.
대처 방법
- 1.이는 예상된 동작이며 고쳐야 할 오류가 아닙니다 — 이 앱들은 분석/익명화/역익명화 워크플로에서 복호화된 키 자료가 전혀 필요하지 않습니다.
- 2.정말로 전체 계정 접근이 필요한 워크플로가 있다면, 직접 관리하는 별도의 맥락에서 전체 범위의 API 토큰을 이 앱들 밖에서 사용하세요.