n8nでdosyaの認証情報を作成

dosyaのコミュニティノードに必須の認証情報フィールドはAPI Keyのみです。dosyaのdos_…トークンをパスワード値として保存し、https://api.dosya.devにのみAuthorization: Bearerとして送信し、GET /api/meでテストします。

認証情報を作成する前に

• 最初にn8n-nodes-dosyaコミュニティノードをインストールまたは選択してください。リポジトリのパッケージバージョンは0.1.1で、n8n 2.42（n8n-workflow 2.42.4）とNode.js 22でビルドおよびテストされています。
• ローテーションが他のツールに影響しないよう、n8n用と分かる名前の別のキーを使用してください。無料プランではユーザーごとにAPIキーを3件まで作成できます。すべてのアカウントの絶対上限は20件で、期限切れのキーも取り消すまで数に含まれます。
• トークンを生成する前にn8nの暗号化された認証情報ストアを準備してください。dosyaがAPIキー全体を表示するのは一度だけです。
• 現在のノードですべての操作を行うにはフルアクセスが必要です。読み取り専用キーは認証できますが認証情報のルールを満たしません。アップロード専用キーはアカウントテストに合格できず、読み取り操作もできません。

手順

1. dosyaでアカウントメニューを開き、プロフィール、API（APIキー）、API：APIキーを作成の順に選択してください。
2. 用途にn8n production uploadsなどの識別しやすい値を入力してください。キー名は最大64文字です。
3. 何ができますか？でフルアクセスを選択してください。制限と有効期限でプロトコルを選択したもののみに設定し、REST APIを選択してください。
4. 必要に応じて1つのワークスペースを選び、認証情報を固定してください。フォルダーアンカーは空欄にしてください。フォルダーに固定されたキーはWebDAVとS3でのみ使用でき、n8nのRESTノードでは拒否されます。
5. 有効期限と、n8nホストが満たせるIP、利用可能時間、使用回数の制御を必要に応じて設定してください。ワークスペースへの固定はキーの範囲を狭めるもので、そのワークスペースでのロールを超える権限をオーナーに付与するものではありません。
6. キーを生成を選択し、is readyダイアログからトークン全体をコピーして、安全な場所に保管してから完了を選択してください。
7. n8nでdosya.dev APIタイプの認証情報を作成してください。API Keyにトークンを貼り付けてください。この欄にdosyaのアカウントパスワードを入力しないでください。
8. 認証情報を保存し、n8nの認証テストを実行してください。テストは直ちにhttps://api.dosya.dev/api/meを呼び出し、User-Agentにノードのバージョンを含めて送信します。

実行結果

n8nに認証情報の確認が成功したことが表示され、保存した認証情報をdosyaノードで使えるようになります。このテストで確認できるのは、キーが受け入れられ、フルアクセス権限を持つことです。選択した各ワークスペース、フォルダー、プランの上限、メンバーのロールによって後続の操作が許可されるかどうかは確認できません。

dosyaのキーの行には、名前、フルアクセス、REST API、適用範囲、有効期限、最終使用日時が表示されます。n8nはシークレットを保存します。dosyaには識別子の一部のみが保持され、トークン全体を再表示することはできません。

具体的な失敗と対処方法

結果	対処方法
This key is read-only. Uploads, folders and share links need a key with Full access scope.	フルアクセスの代替キーを作成してください。n8nの変更で既存のキーの権限を広げることはできません。
dosya.dev did not accept the API key	トークンの欠落、取り消し、有効期限切れを確認してください。一度だけ表示された値を紛失した場合は代替キーを生成してください。
This API key is anchored at a folder and can only be used over WebDAV or the S3 gateway	フォルダーアンカーを指定せずにキーを作り直してください。ワークスペースへの固定はこのノードで使用できます。
The free plan allows 3 API keys. Delete one or upgrade for more.	別のキーを生成する前に、未使用または期限切れのキーを取り消してください。
Maximum of 20 API keys reached	アカウントの一覧から不要な認証情報を削除してください。
Name must be 64 characters or less	用途を短くして再送信してください。

キーの取り消しは元に戻せません。成功したAPIキーの照合結果は、アイソレート内で30秒間保持されるメモリ層を含め、最大5分キャッシュされる場合があります。先に代替キーを作成して検証し、影響を受けるワークフローを更新してから古いキーを取り消し、5分後に再テストしてください。トークンがログ、スクリーンショット、ワークフローデータに現れた場合は、露出したコピーの削除に頼らずローテーションしてください。

関連ガイド

• Zapierを接続する
• n8nを接続する