著者: 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トークンを使用してください。