デスクトップのディープリンクの問題を解決する

macOS、Windows、Linuxでdosyaの認証リンクと同期フォルダーのリンクを確認し、非対応のリンク先、期限切れのリンク、安全でないリンク先を判別します。

最終確認日

スクリーンショットは英語版の画面です。

認証には正規のdosya://auth/callbackリンクを、ローカル同期フォルダーにはdosya://sync?path=…を使用します。対応していないリンク先はブラウザに切り替わらないため、まずどのリンクに問題があるか確認してください。

4つのパネルに、ディープリンクの分類、パッケージ版のOSによる受け渡しの再試行、期限切れのコールバックのやり直し、安全な絶対同期パスの検証が示されています。
プロトコルの受け渡し、使い捨ての認証状態、厳密な同期パスの検証を分けて確認します。スクリーンショットを原寸で開く。

始める前に

  • 認証コールバックにはトークンが含まれる場合があるため、リンク全体を他の人に知らせないでください。
  • dosyaがインストールされていることを確認してください。同期にはサインインが必要ですが、認証コールバック自体はサインインの一部です。

手順

  1. リンクを次の正規の形式dosya://auth/callback?token=…&state=…およびdosya://sync?path=…と比較してください。クライアントは認証と同期のリンク先を処理します。リンクを作成または再試行するときは、ここに記載された形式を使用してください。
  2. 何も起動しない場合は、dosyaを一度起動して再試行してください。パッケージ版はスキームを登録します。Windowsでは起動時にプロトコルクライアントの登録も修復します。macOSはopen-urlを使用し、WindowsとLinuxはURL引数を受け取ります。
  3. 認証コールバックの場合は、古いURLを再使用せず、サインインを最初からやり直してください。コールバックには保留中の使い捨てstateが必要です。stateがない場合や一致しない場合は拒否されます。
  4. 有効なコールバックの後、認証済みのダッシュボードが開くことを確認してください。セッションCookieの有効期間は30日です。コールバックのトークンを報告に貼り付けないでください。
  5. 同期リンクの場合は、pathが実在するフォルダーの絶対パスを指定していることを確認してください。デコード後の値は1,000文字以内で、制御文字、NUL、..パスセグメントを含めることはできません。
  6. 検証した同期リンクを再試行し、dosyaが/sync?localPath=…を開くことを確認してください。コールドスタート時のリンクはレンダラーの準備を待ちます。リンク先が非対応または不正な形式の場合、ブラウザへのリダイレクトは行われません。
有効な認証コールバックの後、または対応する同期フォルダーのリンクを開く前に表示されるdosyaデスクトップの概要。
対応するカスタムリンクは、ブラウザのタブではなく認証後のアプリの状態で確認してください。スクリーンショットを原寸で開く。

確認できる結果

有効なコールバックは保留中のサインインを完了し、有効な同期リンクは確認済みのローカルフォルダーを指定して同期ページを開きます。パスが繰り返しエンコードされている場合、最大5回デコードしてから拒否します。

dosyaを一度起動した後もOSが別のプログラムを開くか何も起こらない場合は、そのOS用のパッケージ版クライアントを修復または再インストールしてください。アプリ内に「ブラウザで開く」という復旧手段はありません。

関連ガイド

この記事は役に立ちましたか?

評価の結果を読み込んでいます…

投票すると、回答を変更できるように、必要な投票用Cookieが最長180日間保存されます。

質問と回答

このガイドの手順について質問できます。質問は確認後に公開されます。

公開の質問には、アカウントの詳細、認証情報、非公開ファイルを含めないでください。これらについては 非公開サポート をご利用ください。

質問を読み込んでいます…

    dosyaアカウントにサインインすると、質問を投稿できます。

    やり直す前に結果を確認

    操作をもう一度確認する必要があるときは、次の共通の確認事項をご利用ください。