ZoomのOBF Token要件の変更:Meeting BaaSユーザーへの影響
Zoomは2026年3月2日より、外部ミーティングに参加するMeeting SDK appにOBF tokenを必須とします。その意味と準備方法を解説します。

Zoomは、Meeting SDKアプリケーションがミーティングに参加する方法に関して重要な変更を発表しました。2026年3月2日より、botが自身で作成していないミーティングに参加する際は、OBF(On Behalf Of)tokenが必要になります。
Meeting BaaSではすでにOBFの完全サポートをリリースしています。この記事では、変更内容と連携の更新方法について説明します。
技術的な詳細については、Zoomの公式アナウンスをご覧ください。
要点まとめ
| 2026年3月2日以前 | 2026年3月2日以降 |
|---|---|
| BotはSDK credentialで任意のZoomミーティングに参加可能 | 外部ミーティングへの参加にはOBF tokenが必要 |
| ユーザーの認証は不要 | ZoomユーザーがOAuth経由でbotを認証する必要あり |
| Botは独立して動作 | 認証済みユーザーがミーティングに参加している必要あり |
「外部ミーティング」とは、あなたのZoom組織内のアカウントが作成したものではないミーティングを指します。Meeting BaaSのほとんどのお客様にとって、これはほぼすべてのミーティングを意味します。
OBF Tokenとは?
OBFは「On Behalf Of」の略です。特定のZoomユーザーからの認証を表すtokenです。botがOBF tokenを提示することで、「このbotは私の代わりにミーティングに参加できる」という承認を証明します。
これには2つの重要な制約があります。
- ユーザーはOAuth経由でappを認証する必要があります(一度だけの同意フロー)
- botが稼働している間、ユーザーはミーティングに参加している必要があります
認証済みユーザーが退出すると、ZoomはSDKセッションを終了し、botは切断されます。これはZoomプラットフォームの要件です。
対応が必要なのは誰ですか?
OBF tokenが必要な場合
あなたのbotがZoom組織外の人が作成したミーティングに参加する場合です。議事録作成、文字起こし、録画のほとんどのユースケースが該当します。
OBF tokenが不要な場合
あなたのbotが自身のZoomアカウント内のミーティングにのみ参加する場合です。自身のSDK credentialを使用することで、これらのミーティングは「内部」として扱われます。
判断の目安
| ユースケース | 必要なもの |
|---|---|
| 自社チームのミーティングを録画する | SDK credential(OBF不要) |
| 外部顧客向けの製品を構築する | OBF token必須 |
| 他者がホストするミーティングに参加する | OBF token必須 |
| Google MeetまたはTeamsのみ使用 | 変更不要 |
SDK Credentialの使用
あなたのbotがZoom組織内のミーティングにのみ参加する場合、自身のSDK credentialを使用することでOBFを完全に回避できます。
zoom_sdk_idとzoom_sdk_pwdをMeeting BaaSに渡すと、botはあなたのZoom appで認証されます。この方法で参加するミーティングは、あなたのアカウントの「内部」として扱われます。
{
"meeting_url": "https://zoom.us/j/123456789",
"bot_name": "Team Recorder",
"zoom_sdk_id": "YOUR_SDK_KEY",
"zoom_sdk_pwd": "YOUR_SDK_SECRET"
}このアプローチは、自社のミーティングを録画するチームに適しています。OAuthフロー、ユーザー認証、OBF tokenは不要です。
Zoom appの作成とcredentialの取得方法については、Zoom Appセットアップガイドをご覧ください。
OBF Tokenの実装
外部ミーティングにはOBF tokenが必要です。Meeting BaaSはそれを提供する3つの方法をサポートしています。
| オプション | 仕組み | 最適な用途 |
|---|---|---|
| Direct Token | Zoomから自分でtokenを取得してMeeting BaaSに渡す | テスト、既存のOAuthインフラ |
| Token URL | tokenを返すendpointをホストする | credentialを自社サーバーに保持する場合 |
| Managed OAuth | credentialを保存してリフレッシュを自動処理 | ほとんどのお客様 |
オプション1:Direct Token
Zoomから自分でOBF tokenを取得し、botを作成する際に渡します。
{
"meeting_url": "https://zoom.us/j/123456789",
"bot_name": "Recording Bot",
"zoom_obf_token": "eyJ0eXAiOiJKV1Qi..."
}オプション2:Token URL
OBF tokenを返すendpointをホストします。botは参加時にそれを呼び出します。
{
"meeting_url": "https://zoom.us/j/123456789",
"bot_name": "Recording Bot",
"zoom_obf_token_url": "https://your-api.com/zoom/obf-token"
}オプション3:Managed OAuth(推奨)
OAuth認証コードをMeeting BaaSに送信します。tokenを保存してリフレッシュを自動で処理します。
{
"meeting_url": "https://zoom.us/j/123456789",
"bot_name": "Recording Bot",
"zoom_obf_token_user_id": "SeJwoMGwTCu52501SbDC0Q"
}ほとんどのお客様はオプション3の使用を推奨します。「Zoomを連携する」ボタンを実装し、ユーザーが一度認証すれば、あとはMeeting BaaSが処理します。
v2 API:Zoom Credential管理の改善
Meeting BaaS v2を使用している場合、Zoom credentialを管理するための追加機能が利用できます。
| 機能 | 説明 |
|---|---|
| Credentials API | /v2/zoom-credentialsでSDKおよびOAuth credentialを一度保存 |
| 統合設定 | 複数パラメータの代わりに単一のzoom_configオブジェクト |
| Credential種別 | 「app」(SDKのみ)と「user」(OBF付きOAuth)のcredentialを分離 |
| 状態の追跡 | active/invalidの状態でcredentialの健全性を監視 |
| エラーの追跡 | debugのためのlast_error_messageとlast_error_at |
| AES-256-GCM暗号化 | すべてのシークレットとtokenを保存時に暗号化 |
requestごとにcredentialを渡す代わりに、一度保存してIDで参照できます。
{
"meeting_url": "https://zoom.us/j/123456789",
"bot_name": "Recording Bot",
"zoom_config": {
"credential_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}
}詳細については、v2 Zoom統合ガイドをご覧ください。
認証済みユーザーの参加要件
よく引っかかるのがこの部分です。あなたのappを認証したZoomユーザーは、botが録画している間、ミーティングに参加している必要があります。
自社のミーティングを録画するチームでは、通常これは自然に満たされます。連携を設定した担当者がミーティングを進行していることが多いためです。
お客様が録画をリクエストするプラットフォームでは、この点をお客様に伝える必要があります。Zoomアカウントを連携した人物が、botが参加する前にミーティングに入室している必要があります。
参加していない場合はどうなりますか?
botは待機します。ユーザーが現れるか、タイムアウトが切れるまで(waiting_room_timeoutで設定可能)、数秒おきに参加を再試行します。
ミーティング途中で退出した場合はどうなりますか?
botは切断されます。ZoomはSDKセッションを終了します。その時点までの録画は保存・処理されます。
継続的な録画について
OBF tokenはユーザーが参加するミーティングを対象として設計されています。誰が参加しているかに関わらず継続する録画が必要な場合、ZoomはReal-Time Media Streams(RTMS)を開発中です。
RTMSのサポートに向けて作業を進めています。ただし、RTMSには異なるトレードオフがあります。ミーティング内のappとして動作し(可視のbot参加者ではなく)、双方向のオーディオストリーミングにはまだ対応していません。
ほとんどのユースケースでは、参加要件を伴うOBFで問題なく動作します。
タイムライン
| 日付 | 内容 |
|---|---|
| 現在 | OBFサポートをMeeting BaaSで提供中 |
| 2026年2月 | 連携のテストを開始 |
| 2026年3月2日 | Zoomが外部ミーティングへのOBFを強制適用 |
約3週間あります。今すぐ開始することをお勧めします。
はじめに
対応方針を決める
あなたのbotは外部アカウントが作成したミーティングに参加しますか?はいの場合はOBF tokenが必要です。いいえの場合はSDK credentialで十分な可能性があります。
Zoom appをセットアップする
Meeting SDKを有効にしたZoom General Appを作成します。OBFを使用する場合は、user:read:tokenスコープ(およびManaged OAuthオプションの場合はuser:read:user)を追加してください。
3月2日までにテストを行う
実際のZoomミーティングで本番テストを実施し、すべて正常に動作することを確認してください。
リソース
Meeting BaaS ドキュメント:
Zoom公式リソース:
ご質問はありますか?
適切なアプローチの選択についてご不明な点や、移行に関するご質問がございましたら、お気軽にお問い合わせください。お客様と一緒にこの移行を進めてまいります。
お問い合わせまたはコミュニティサポートチャンネルをご確認ください。