ウェブアクセスは機能するのに、モバイルアプリの同期が失敗する原因は何ですか?

Eva Wong は テクニカルライター であり、 生粋の技術好き としてZimaSpaceで活動しています。ホームラボやオープンソースソフトウェア をこよなく愛する生粋のギークで、複雑な技術概念をわかりやすく、実践的なガイド にまとめることを得意としています。Evaは、セルフホスティングは難しいものではなく、楽しむものだと考えています。チュートリアルを通じて、初めてのNAS構築からDockerコンテナの使いこなしまで、コミュニティがハードウェアのセットアップをわかりやすく理解できるよう 支援しています。、初めてのNAS構築からDockerコンテナの習得まで。

アプリでは異なるAPI、信頼ルール、トークン、バックグラウンドのネットワーク動作が使われるため、Webアクセスは機能してもモバイル同期が失敗することがあります。

ブラウザーでは通常のHTTPSでログインページを表示できても、モバイルアプリはWebDAV、REST、ファイルトークン、通知、チャンク分割アップロード、バックグラウンド同期の各エンドポイントを呼び出し、プロキシのルートや証明書の検証が異なる場合があります。診断では、アプリで失敗したリクエストを正確に記録し、ブラウザーでのアクセス経路と比較したうえで、TLS、URLの生成、トークン、モバイルの権限、ネットワーク状況を個別にテストしてください。

失敗するモバイル操作を特定する

ログイン、ファイル一覧表示、ダウンロード、アップロード、自動アップロード、バックグラウンド同期、プレビュー、通知、共有をそれぞれ切り分けてください。失敗した操作ごとに、アプリのバージョン、OS、ネットワーク、エラー、発生時刻、サーバーログの記録を記録してください。

Seafileの事例では、ブラウザーは問題なく動作する一方、アプリがプロキシに拒否された別のファイルAPIパスを使っていたため、ファイル名に空白があるとモバイルアプリが失敗しました。

操作の一つだけが失敗する場合、サーバー全体を再インストールしないでください。まず失敗するエンドポイントとメソッドを特定してください。ダッシュボードが機能していても、WebDAVのアップロードやモバイルトークンによるダウンロードが機能するとは限りません。

ブラウザーのUI以外でアプリのエンドポイントをテストする

モバイルクライアントが使用する、同期、WebDAV、API、またはファイルサーバーのURLを確認してください。同じホスト名と認証情報を維持したまま、適切なクライアントまたはリクエストツールでそのエンドポイントを直接テストしてください。

Nextcloudの事例では、ファイル一覧表示と自動アップロードで、アクティビティや通知APIとは異なるURLが使われることがあり、API URLの設定ミスがアプリの一部の機能だけに影響する場合があると説明されています。

APIエンドポイントが404、405、400を返す場合、または内部ホストにリダイレクトする場合は、プロキシのルーティングとアプリケーションのベースURLを確認してください。アプリ外で機能する場合は、TLSの信頼性、アプリのトークン、モバイルOSのポリシーを引き続き確認してください。

モバイルのTLS信頼性とブラウザーの信頼性を比較する

証明書チェーン全体、ホスト名、有効期限、中間証明書、アプリがIPv4とIPv6のどちらで接続しているかを確認してください。ブラウザーでは中間証明書がキャッシュされていたり、ユーザーが例外を許可していたりする場合がありますが、モバイルアプリには引き継がれないことがあります。

Joplinのモバイル版に関する事例では、デスクトップではWebDAVが機能する一方、iOSが平文HTTPまたは信頼されていない証明書を拒否したためモバイルでは機能せず、モバイルのTLSポリシーはブラウザーの動作と異なる場合があることが示されています。

検証を無効にするのではなく、公的に信頼された証明書、または正しくインストールされたプライベートCAを使用してください。証明書のIDと一致しないプライベートIPではなく、実際の同期用ホスト名をテストします。

プロキシのルート、リクエストサイズ、エンコードを確認する

ブラウザー操作1回分とモバイル同期操作1回分について、プロキシのログを比較します。メソッド、パス、リクエストサイズ、ステータス、アップストリーム、タイムアウト、およびエンコードされたURL、WebDAVのメソッド、チャンクアップロードをブロックするセキュリティルールを記録してください。

モバイルアプリは、通常のWeb UIでは使用されないPROPFIND、PUT、トークン付きダウンロードURL、範囲指定、チャンクエンドポイントを使う場合があります。ブラウザーのGETおよびPOST通信を許可するプロキシでも、これらのメソッドやパスを拒否することがあります。

必要なルート、メソッド、上限、タイムアウトだけを追加します。モバイルからのリクエストが1つ失敗したからといって、プロキシのセキュリティをすべて無効にしないでください。該当するリクエストを再現し、必要最小限の修正を確認します。

アプリのトークンと正規のサーバーURLを更新する

アプリに保存されているサーバーURLを、現在の正規の公開URLまたは内部URLと比較します。まずメインアカウントのパスワードを変更するのではなく、アプリ専用のパスワードまたはトークンを1つ失効させて再作成してください。

サーバー移行後も、モバイルクライアントに古いポート、HTTP URL、内部アドレス、期限切れのトークン、または以前のリバースプロキシ経路が残っていることがあります。ブラウザーではリダイレクトが成功しても、同期クライアントが古いエンドポイントを呼び出し続ける場合があります。

同期されていないモバイルデータをエクスポートするか保護してから、テスト用の端末1台だけでアカウントを削除します。正規のHTTPSドメインを使って再追加し、アップロードとダウンロードをテストする前に、サーバーから新しいトークンが発行されたことを確認してください。

モバイルのバックグラウンド動作とネットワーク制限をテストする

フォアグラウンドで手動同期を実行し、画面をロックしてバックグラウンドでの動作をテストします。バッテリー最適化、バックグラウンドデータ、ローカルネットワークの権限、モバイル通信の権限、VPN、プライベートDNS、Wi-Fiのみでアップロードする設定を確認してください。

ZimaSpaceの記事リモートプライベートクラウドの接続経路が異なる理由は、アプリの接続経路の障害と、基本的なブラウザーアクセスの結果とを切り分けるのに役立ちます。

アプリが意図したフォアグラウンドおよびバックグラウンドの条件でログインし、ファイルの一覧表示、アップロード、ダウンロード、再開、同期を行えるようになって初めて、問題は解決したと言えます。Webアクセスだけが引き続き機能する場合は、サーバー全体が正常だと判断せず、モバイル固有のエンドポイントを引き続き調査してください。

サポートとヒント

続きを読む

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.