Waafir
このページは機械翻訳であり、人による確認を待っています。誤りが含まれている可能性があります。

個人用アクセストークン

個人用アクセストークン(PAT) は、ご自身で作成して貼り付ける認証情報です。Waafir REST API やスクリプト、そしてサインインできない AI アシスタント向けのものです。ほとんどのアシスタントは、Waafir の URL を貼り付けてサインインするだけで接続でき、トークンはまったく必要ありません。Waafir の MCP サーバーでは、すべてのリクエストが、サインインによって作成された接続か、有効な PAT のいずれかを伴います。匿名アクセスはなく、通常のログイン済みブラウザセッションはこのサーフェスでは受け付けられません(セッションで認証されたリクエストは拒否されます)。PAT は組織内であなたとして動作し、発行時に選択したスコープとデータルームによって制限されます。

トークンの発行場所

アドオン → 設定 → APIトークン を開きます。このページは 3 つの部分で構成されています。新しいトークンを発行するフォーム、既存のトークンの一覧(取り消し操作付き)、そしてトークンでアシスタントを接続するためのすぐに使える設定スニペットです。

トークンを発行するには、フォームに入力します。

  • 名前 — 後でトークンを識別できるようにするための、人が読めるラベル(例:「Claude Desktop – ノート PC」)。必須です。
  • スコープ — トークンに許可する操作。後述します。
  • データルームスコープ — すべてのデータルーム をオンのままにすると、アクセスできるすべてのデータルームにトークンが到達できます。オフにして特定のデータルームを選択すると、トークンをそれらだけに限定できます。
  • 有効期限 — この日付を過ぎるとトークンは機能しなくなります。入力は任意ですが、実質的には任意ではありません。空欄のままにすると、トークンは 90 日 の有効期限で発行されます。有効期限を参照してください。

スコープ

トークンは 3 つのスコープのいずれかを持ちます。権限の小さい順に次のとおりです。

スコープ許可される操作一般的な用途
read一覧表示と読み取り:データルーム、フォルダー、ファイル、ファイルのメタデータ、検索、ダウンロード URL、権限の表示。文書から抽出されたテキストの読み取り。投資家 Q&A スレッドの読み取り。墨消し、翻訳、電子署名の各ジョブの状態確認。データルームに関する質問に答える読み取り専用のアシスタント。
writeread で許可されるすべてに加えて、変更操作:フォルダーの作成、名前変更、移動、削除、復元。ファイルのアップロード、名前変更、移動、削除、復元(ファイルの新しいバージョンのアップロードやロールバックを含む)。文書の墨消しまたは翻訳の開始。電子署名エンベロープの作成、送信、辞退、無効化。エンベロープの送信(または送信済みエンベロープへの署名者の追加)には 組織外のユーザーに送信 も必要で、アシスタントは送信前に確認を求めます。署名(esign_sign)には ドキュメントに署名 も必要で、同様に事前に確認されます。データルームを整理・保守するアシスタント。
adminwrite で許可されるすべてに加えて、権限を付与する 4 つのツール:ファイルやデータルームへのユーザーのアクセスの付与または取り消し。なお、権限を読み取る 3 つのツールに必要なのは read だけです。誰が何を見られるかを管理するアシスタント。

スコープは累積的で、上位のスコープはその下位のすべてを含みます。各サーバーのツールリファレンスに、各ツールが必要とする最小スコープが記載されています。

各スコープを発行できる人

トークンが、発行した本人を超える権限を持つことはありません。

  • read と write は、組織のアクティブなメンバーであれば誰でも発行できます。
  • admin を発行できるのは組織のオーナーまたは管理者だけです。オーナーでも管理者でもない場合、スコープの選択肢に admin は表示されません。
  • 投資家(およびディールチーム以外のロール)は、トークンを一切発行できません。

発行時の制限に加えて、admin の権限ツールは呼び出し時に 2 つ目の上限を適用します。権限の付与を成功させるには、トークンの所有者自身が組織の管理者またはマネージャーである必要があります。トークンのスコープはトークンの上限であり、所有者のロールは本人の上限です。管理者操作は両方を満たす必要があり、これは製品 UI が適用するルールとまったく同じです。MCP 経由だからといって、製品より緩い経路はありません。

トークンにドキュメントへの署名を許可する

署名には、ドキュメントに署名 がオンになったトークンが必要です。これは アドオン → 設定 で write または admin のトークンを作成するときに選択するため、署名を任せられるのは信頼したアシスタントだけです。二要素認証をオンにしている場合、トークンの作成時にすでに二要素コードが求められるため、そのチェックがトークンによるすべての署名をカバーします。トークン一覧では、該当する各トークンに 署名できます と表示されます。

アシスタントは、まず文書、署名者、フィールドを表示し、あなたが確定した場合にのみ署名します。ドキュメントに署名 のないトークンにはツール一覧に esign_sign が表示されず、呼び出しても拒否されます。このオプションが導入される前に作成されたトークンは署名できません。ドキュメントに署名 をオンにした新しいトークンを作成してください。

トークンにドキュメントの内容の読み取りを許可する

文書全体を読んだり、文書について AI に質問したりするには、ドキュメントコンテンツを読む がオンになったトークンが必要です。これは アドオン → 設定 でトークンを作成するときに選択し、どのスコープでも指定できます。トークン一覧では、該当する各トークンに ドキュメント内容 と表示されます。対象は次のとおりです。

  • get_file_text:文書から抽出された全文。
  • get_file_download_url:ファイルをダウンロードするリンク。
  • esign_download_signed:署名済みの電子署名 PDF。
  • 完了した翻訳に対して translate_file_status が返すダウンロードリンク。
  • GET /api/v1/files/{fileId}/content:REST API 経由の文書のバイト列。
  • POST /api/viewer/token、POST /api/viewer/artifact-access、POST /api/viewer/artifact-access/unlock:製品内ドキュメントビューアーが文書をストリーミングする際に使用するビューアートークンまたは Cookie を発行します。
  • 回答が文書の内容を繰り返す可能性があるため、質問や入力をあなたが記述する AI ツール:dataroom_ask、dataroom_draft_answer、dataroom_compare_files、dataroom_generate_update。
  • POST /api/v1/chat:REST API 経由の同じ AI 回答。
  • GET /api/v1/facts が返す各ファクトの quote。

これがないトークンは、これらのツール(GRANT_REQUIRED)とこれらの REST ルート(PAT_GRANT_REQUIRED)を拒否され、translate_file_status はリンクの代わりに状態と download_withheld_reason: content_grant_required を返します。GET /api/v1/facts と dataroom_list_facts は、各ファクトを quote なしで返し、value を 20 語に切り詰めて value_truncated を設定します。トークンは引き続き一覧表示と検索ができ、get_file_metadata または dataroom_summarise_file で文書の要約を読むこともできます。このオプションが導入される前に作成されたトークンは文書の内容を読めません。ドキュメントコンテンツを読む をオンにした新しいトークンを作成してください。サービストークンには影響しません。

各トークンが取得できるダウンロードリンクは 1 分あたり最大 10 件です。これを超えると、get_file_download_url は拒否され(RATE_LIMITED)、translate_file_status は状態と download_withheld_reason: rate_limited を返します。1 分後にもう一度リクエストしてください。

トークンに組織外の人への送信を許可する

共有リンクの作成、スナップショット閲覧者の追加、チームメンバーや投資家の招待、投資家のアクセスの延長や復元(dataroom_extend_investor_access、dataroom_reinstate_investor_access)は、組織外の人にアクセスを渡す操作です。そのため、組織外のユーザーに送信 がオンになったトークンが必要です(投資家向けアップデート、Q&A の回答、電子署名リクエストを送信するのと同じ権限付与です)。これは アドオン → 設定 で write または admin のトークンを作成するときに選択します。トークン一覧では、該当する各トークンに 外部に送信できます と表示されます。

アシスタントは、新しいリンクで誰がアクセスできるようになるか、NDA ルール、有効期限をまず表示し、あなたが確定した場合にのみリンクを作成します。リンクや閲覧者の取り消しには権限付与は不要です。

この権限付与は、ディールチーム(オーナー、管理者、メンバー)以外の人に、ルームや文書へのアクセス、またはより広いアクセスを与える操作もカバーします。「外部」とは、そのルームの組織のアクティブなディールチームメンバーではないすべての人を指します。つまり、投資家、ゲスト、招待が保留中の人、そして別の組織のメンバーです。この権限付与がない場合、トークンは次の操作で拒否されます(MCP では GRANT_REQUIRED)。

  • そのような人への読み取りまたはダウンロードの権限付与:set_file_permissions、dataroom_set_folder_permissions、dataroom_bulk_set_file_permissions。
  • そのような人に対する拒否の解除(アクセスが復元されます):revoke_file_permission、dataroom_revoke_folder_permission、dataroom_bulk_revoke_file_permissions。
  • そのような人へのルームアクセスの付与(レベルを問わず):invite_user_to_dataroom。
  • 現在のロールがディールチームではないメンバーのロール変更(昇格になるため):dataroom_team_change_member_role。
  • アクセスを広げる投資家の変更:dataroom_set_investor_permissions による閲覧者からダウンロード可能者への変更、NDA のオフ、モニタリングまたはアップデートのオン。

拒否、権限付与の終了、ディールチームへの権限付与には、この権限付与は不要です。すでにアクセス権を持つ人がいる場所へのコンテンツの配置(アップロード、移動、公開)は対象外です。企業が署名済みの企業NDAの添付にも、この権限付与は不要です。

個人用アクセストークンで行う次の REST 呼び出しにも、同じ権限付与が適用されます。

  • POST /api/share-links(リンクの作成)と POST /api/snapshots/{id}/viewers は、これがないと 403 PAT_GRANT_REQUIRED で拒否されます。
  • POST /api/investors/invite(個人用リンクを作成してメールで送信します)も同様に拒否されます。
  • PATCH /api/investors/{id}/extend と PATCH /api/investors/{id}/access(投資家の復元またはアクセスリクエストの承認)も同様に拒否されます。投資家の取り消し(DELETE /api/investors/{id}/access)には権限付与は不要です。
  • POST /api/team、POST /api/v1/team、POST /api/team/resend(チームへの招待では参加リンクがメールで送信されます)も同様に拒否されます。
  • PATCH /api/share-links/{id} は、リンクのアクセス設定に対するあらゆる編集(オンへの切り替え、モード、ドメイン、有効期限、NDA。編集が設定を広げるか狭めるかを問いません)で拒否されます。リンクをオフにすることは常に許可されます。
  • GET /api/share-links は、各リンクの url と token を含めずに応答し、urlWithheld: true とマークして、理由を示す urlWithheldReason を付けます。
  • POST /api/v1/grants は、ディールチーム外の人への読み取りまたはダウンロードの権限付与で拒否されます。DELETE /api/v1/grants/{id} は、その権限付与がその人に対する拒否である場合に拒否されます。PATCH /api/v1/team/{id} は、メンバーの現在のロールがディールチームではない場合に拒否されます。

これらのチェックはサーバーがルーティングするのと同じ方法でパスを読み取るため、末尾のスラッシュやパーセントエンコードされた文字ですり抜けることはできません。デコードできないパスや、./.. セグメント、またはセグメント内にエンコードされた / を含むパスは、権限付与が対象とするどの呼び出しとも一致させることができません。そのため、リクエストごとの権限付与(この権限付与、ドキュメントコンテンツを読む、エンゲージメント分析を読む)のいずれかを持たない個人用アクセストークンは、呼び出しの種類を問わず、そのようなパスがすべて 403 PAT_PATH_MALFORMED で拒否されます。

この権限付与が導入される前に作成されたトークンはこれを持たないため、オプションをオンにした新しい write または admin トークンを作成するまで、これらの呼び出しは行えなくなります。read トークンはこの権限付与を持てません。

トークンにエンゲージメント分析の読み取りを許可する

エンゲージメント分析を読む により、トークンは誰がどの文書を、いつ、どのくらいの時間閲覧したかを読み取れるようになります。対象はエンゲージメントツールと、投資家名簿上のエンゲージメント情報です。これを見るべきアシスタントに対してのみオンにしてください。どのスコープでも保持できます。

同じ権限付与は、REST のアクティビティ読み取りにも適用されます:GET /api/v1/activity(組織のアクティビティおよび監査フィード)、/api/v1/activity/rollups、/api/v1/activity/engagement、/api/v1/activity/engagement/documents、/api/v1/activity/engagement/document/pages。これがない個人用アクセストークンは 403 PAT_GRANT_REQUIRED で拒否されます。サービストークンとサインイン済みのセッションには影響しません。

これらのオプションが導入される前に作成されたトークンは、いずれも持っていません。オプションをオンにした新しいトークンを作成してください。

トークンを特定のデータルームに限定する

デフォルトでは、トークンは所有者がアクセスできるすべてのデータルームに到達できます。すべてのデータルーム をオフにして特定のルームを選択すると、トークンはその許可リストに限定されます。リスト外のデータルームを参照するツール呼び出しはすべて拒否され、スコープが限定されたトークンには、開けないデータルームの名前すら表示されません。これを使えば、ポートフォリオの他の案件を公開せずに、AI クライアントに 1 つの案件へのアクセスだけを渡せます。

有効期限

すべてのトークンには有効期限があります。無期限の PAT はありません。期限切れにならないトークンこそが、この動作によって解消すべきセキュリティ上の指摘事項でした。忘れられた認証情報は永遠に有効なままになるからです。有効期限を設定すると、トークンはその日付以降機能しなくなります。期限切れのトークンを使ったリクエストは、取り消されたトークンとまったく同じように HTTP 401 で拒否されます。

  • フィールドを空欄にすると 90 日になります。トークンが発行された時点から数えます。空欄はデフォルトを使用するという意味であり、無期限ではありません。
  • 日付を設定すると、そのとおりに適用されます。上限は発行から 365 日 です。
  • 365 日を超える期間を求めるとリクエストは拒否され、黙って短縮されることはありません。発行時に、通知なしに要求より短い有効期間のトークンが返されることはありません。過去の日付も同様に拒否されます。

したがって、統合を継続して動作させたい場合は、有効期限を意図的に設定し、失効前にトークンを置き換えるようカレンダーにリマインダーを入れてください。フィールドを空欄にすると、設定から約 3 か月後にその統合が黙って停止します。既存のトークンには更新やローテーションの操作はなく、期限切れ前の警告もありません。置き換えるには、新しいトークンを発行し、クライアントの設定を更新し、古いトークンを取り消します。逆に、一回限りの作業のために発行するトークンには、短い有効期限がまさに適しています。

アドオン → 設定 のトークン一覧には各トークンの有効期限が表示されるため、失効が近いものを確認できます。

一度限りの表示

トークンを発行すると、生の値(waafir_pat_ で始まります)が作成直後に一度だけ表示されます。Waafir は生のトークンを保存せず、その一方向ハッシュのみを保存するため、トークンを取得したり再表示したりすることはできません。

  • 今すぐコピーして、クライアントの設定に直接貼り付けてください。表示パネルにはコピーボタンがあります。
  • 紛失した場合は復元できません。そのトークンを取り消し、新しいトークンを発行してください。
  • パスワードと同様に扱ってください。トークンを持つ人は誰でもそのスコープの権限を得ます。

表示後、トークン一覧には短い非機密のプレフィックス(例:waafir_pat_ab12…)だけが表示されます。これにより、シークレットを復元できない状態のまま、トークンを見分けられます。

トークンの取り消し

アドオン → 設定 のトークン一覧で、任意のトークンの横にある 取り消す 操作を使用します。取り消しは即時に有効になり、そのトークンを使う次のリクエストは拒否されます。デバイスを紛失したとき、委託先が離れたとき、または単にアクセスが不要になったときは、すぐにトークンを取り消してください。取り消されたトークンは一覧に引き続き表示され(取り消し済みとしてマーク)、存在していたものの記録が保持されます。再有効化することはできません。

トークンが自動的に終了する場合

トークンは組織のメンバーシップを通じて動作するため、そのメンバーシップが終了するとトークンも終了します。次の場合は、自分で取り消す必要はありません。

  • 組織を離れた場合、または管理者によって削除された場合。 その組織で保持しているすべてのトークンが、その時点で取り消されます。他の組織で保持しているトークンは引き続き機能します。
  • Waafir の管理者があなたのアカウントを削除した場合。 すべての組織にあるあなたのトークンが取り消されます。
  • Waafir の管理者が組織を削除した場合。 サービストークンを含め、その組織のすべてのトークンが取り消されます。

これらの取り消しは永続的です。再度招待されても、アカウントや組織が復元されても、トークンは元に戻りません。新しいトークンを発行してください。

サービストークン は、作成した管理者ではなく組織に属するため、その管理者が離れても機能し続けます。早期に終了させるには、取り消すか、組織を削除するしかありません。

監査ログにおけるトークンの履歴

トークンが発行または取り消されるたびに、組織の監査ログに 1 行が書き込まれます。誰が行ったか、トークンの名前、スコープ、権限、有効期限、限定されているデータルームの数、そして取り消しの理由(所有者による取り消し、メンバーシップの終了、アカウントまたは組織の削除)が記録されます。トークンそのもの、そのハッシュ、プレフィックスは決して記録されません。これらの行は、ダッシュボードのダイジェストではなく、完全なアクティビティ履歴に表示されます。

Waafir が新しいトークンを監査ログに記録できない場合、トークンは発行されず、「The token wasn't created because we couldn't record it. Try again.」(トークンを記録できなかったため、作成されませんでした。もう一度お試しください。)と表示されます。

次へ:発行したトークンを使ってクライアントをセットアップします。