BFF(Backend for Frontend)を挟むべきケース|入口ごとに理由が違う
BFFは、Web・アプリ・取引先向けAPIといった入口ごとに置く専用のサーバー側の部品です。SPAは業務アプリならトークンをブラウザに置かないため、アプリは画面と通信の制約、外部APIは変えられない相手のために挟みます。
目次 クリックで開く
この記事の要点
- BFF は、Web の画面・スマホアプリ・取引先向けの API といった入口ごとに置く、その入口専用のサーバー側の部品です。入口が1つだけなら挟みません。
- 挟む理由は入口で違います。SPA では、トークンをブラウザに置かないためです。RFC 10017 は、業務アプリ・機微な情報・個人データを扱うアプリにこの形を強く勧めています。スマホアプリでは、画面と通信の制約に合わせ、アプリの審査を待たずに変えるためです。取引先向けの API では、呼び方を変えられない相手に合わせるためです。
- 監視や認可のような横断の仕事は BFF の外に切り出します(Azure の例ではゲートウェイ)。BFF に持たせるのは、その入口のための集約と整形と、SPA ならトークンの保持と中継です。
BFF を挟むかどうか
入口(Web・アプリ・取引先)が2つ以上あり、バックエンドに別々の注文をつけているか
例:アプリだけ返す項目を減らしたい、取引先は古い呼び方を変えられない
ブラウザで動く業務アプリ・個人データを扱うアプリが、OAuth のアクセストークンを持って API を直接呼んでいるか
例:トークンをブラウザの保存領域に置いている
Web だけでも、1つの画面のためにサーバー側で束ねる処理が多いか
例:欲しいものリストのように、1画面のために複数のサービスを呼ぶ
出典:Azure Architecture Center「フロントエンド専用バックエンドパターン」、Sam Newman「Backends For Frontends」、RFC 10017「OAuth 2.0 for Browser-Based Applications」
BFF(Backend for Frontend)は、Web の画面、スマホアプリ、取引先向けの API といった利用者の入口ごとに、その入口専用に置くサーバー側の部品です。挟む価値があるのは、複数の入口が同じバックエンドに別々の注文をつけ始めたときと、ブラウザで動く業務アプリが OAuth のトークンで API を呼んでいて、そのトークンをブラウザに置きたくないときです。入口が1つだけのときや、どの入口も同じ要求を出すときは、挟まないほうが手間が少なくて済みます。
当社は、業務システムの統合や連携の設計を手伝う側の会社です。この記事は、SPA・スマホアプリ・外部公開の API を同じバックエンドで支えていて、間に層を1つ足すか迷っている設計者の方に向けて書いています。根拠は、このパターンを書き起こした Sam Newman の記事(2015年)、Microsoft の Azure Architecture Center のパターン集、2026年8月に RFC 10017 として出た IETF の「OAuth 2.0 for Browser-Based Applications」の3つです。GraphQL や API ゲートウェイの製品の選び方、言語やフレームワークの比べ方は扱いません。
BFF は、汎用の API を入口ごとに分ける考え方
Newman によると、最初は普通、1つの汎用の API で Web とモバイルの両方を支えます。ところがモバイルは画面が狭く、接続を何度も開くと電池とデータ通信量を減らすので、少ない呼び出しで少ないデータを求めます。一方、汎用の API には入口ごとの機能が積み重なり、リリースの詰まりどころになります。Newman は、その代わりに利用者の体験ごとに1つのバックエンドを置く形を、REA と SoundCloud で見たと書いています。この形を Backend For Frontend と呼んだのは、元 SoundCloud の Phil Calçado だと紹介しています(Sam Newman「Backends For Frontends」)。Microsoft のパターン集も同じ形を解決策に挙げ、BFF はそれぞれのフロントエンドのチームが持つとしています(Azure Architecture Center「フロントエンド専用バックエンドパターン」)。
汎用の API 1つと、入口ごとの BFF
汎用の API 1つ
すべての入口が同じバックエンドを呼ぶ
- 入口ごとの注文が1つの API に積み重なる
- 1つの入口の変更を、ほかの入口のチームと確かめてから入れる
- 入口が1つ、またはどの入口も同じ要求なら、これで足りる
入口ごとの BFF
入口とバックエンドの間に、入口専用の層を置く
- その入口に要る呼び出しと項目だけを返す
- BFF はその入口のチームが持ち、言語やリリースの周期を自分で決める
- サービスが増える分、運用とセキュリティの手間が増える
出典:Azure Architecture Center「フロントエンド専用バックエンドパターン」、Sam Newman「Backends For Frontends」
1つの例で比べる:ネットショップの「欲しいものリスト」
ここからは Newman の記事の例にならって、ネットショップで考えます(説明のための架空の例です)。この店には、Web のアプリ(SPA)、iOS と Android のアプリ、取引先向けの API の3つの入口があります。「欲しいものリスト」の画面を出すには、リストのサービスから商品の一覧を取り、そのあとで商品の情報と在庫のサービスを呼ぶ、少なくとも3回の呼び出しが要ります。同じ店でも、入口によって BFF を挟む理由が違い、持たせる仕事と挟まなくてよい条件も違います。
| 入口 | 挟む理由 | BFF に持たせる仕事 | 挟まなくてよい条件 |
|---|---|---|---|
| Web のアプリ(SPA) | 業務・機微な情報・個人データを扱うアプリで、OAuth のトークンをブラウザに置かない | OAuth のクライアントになってトークンを持ち、API への要求をすべて中継する | フロントと API が同じドメインで、OAuth を使わずサーバー側のセッションで済む。業務・機微な情報・個人データのどれも扱わなければ、安全性と単純さの引き換えで選べる |
| iOS・Android のアプリ | 画面と通信の制約に合わせる。アプリの審査を待たずに変える | アプリの画面に合わせた集約と整形 | Web と同じ要求しか出さない |
| 取引先向けの API | 呼び方を変えられない相手に合わせる | 相手ごとの形への変換 | 相手の要求が汎用の API と同じ |
SPA:挟む理由は、トークンをブラウザに置かないこと
RFC 10017 は、ブラウザで動くアプリが OAuth を使うときの作り方を3つ挙げ、安全性と単純さの引き換えとして、安全性の高い順に並べています(6章)。RFC が挙げる BFF の責務は3つです。1つ目は、認可サーバーに対して機密クライアント(クライアントの秘密情報を持てる側)として振る舞うことです。2つ目は、アクセストークンとリフレッシュトークンを Cookie のセッションの中で管理し、ブラウザのアプリにはトークンを見せないことです。3つ目は、API への要求をすべて中継し、正しいアクセストークンを付けて送ることです。BFF はサーバー側で動きますが、フロントエンドの部品です。RFC は、API ゲートウェイやリバースプロキシと取り違えないよう注意しています(6.1節)。
RFC 10017 が挙げる3つの作り方(安全性の高い順)
1. BFF
サーバー側の BFF が OAuth のクライアント
- トークンは BFF だけが持つ
- API への要求はすべて BFF が中継する
- 業務アプリ・機微な情報・個人データを扱うアプリに強く勧められている
2. トークン仲介型
バックエンドがトークンを取り、ブラウザに渡す
- ブラウザが API を直接呼ぶ
- アクセストークンが盗まれると API に直接届く
- 選ぶ前に、完全な BFF にできないかを検討するよう勧められている
3. ブラウザだけ
ブラウザのアプリが OAuth のクライアント
- トークンはブラウザの中にある
- RFC が5章で挙げた攻撃のすべてを受けうる
- 業務・機微な情報・個人データを扱うアプリには勧められていない
BFF なら、悪いスクリプトが動いてもブラウザにトークンが無いので盗まれず、新しいトークンを取られることもありません。ただし悪いコードが同じオリジンで動けば、ブラウザから BFF に要求を送って正規のアプリのふりができます(RFC の言う「クライアントの乗っ取り」)。防ぐには悪いコードを動かさないことしかなく、RFC は安全なコーディング、コードの解析、Content Security Policy を挙げています。HttpOnly の Cookie なら、乗っ取りがセッションの盗用には広がりません。RFC はさらに、高い安全性が要るアプリで流量制限や異常の検知をするなら、すべての通信を見られる BFF が理想の置き場所だとしています。乗っ取りの被害を抑える助けにもなります(6.1.4節)。
BFF を挟んだ SPA のログインと API の呼び出し
トークンはブラウザに一度も渡らない。ブラウザが持つのはセッションの Cookie だけ
出典:RFC 10017「OAuth 2.0 for Browser-Based Applications」 6.1.1節の図をもとに簡略化
BFF の Cookie と CSRF の要件
BFF は Cookie でセッションを持つので、Cookie の設定がそのまま守りの強さになります。「必須」は MUST、「推奨」は SHOULD の訳です。RFC は、新しい構成ならどれも難しくなく、推奨にとどめたのは既存の構成が準拠できるようにするためだとしています(6.1.3.2節)。
| Cookie の設定 | RFC での強さ | RFC に書かれた効き目 |
|---|---|---|
| Secure | 必須 | HttpOnly と合わせて、セッションの盗用を防ぐ |
| HttpOnly | 必須 | スクリプトから Cookie を読めなくする |
| SameSite=Strict | 推奨 | サイトをまたぐ要求に Cookie を付けない |
| Path=/ | 推奨 | — |
| Domain 属性を付けない | 推奨 | — |
| 名前の頭に __Host-Http- などの接頭辞(策定中の Cookie 仕様のドラフト draft-ietf-httpbis-layered-cookies-02 で定義) | 推奨 | サブドメインと Cookie を共有させない。サブドメインからのセッションの盗用・固定を防ぐ |
| Cookie の中身を暗号化(トークンを Cookie に入れる場合) | 推奨 | トークンを平文でディスクに残さない。暗号化しても、Cookie ごと盗まれればセッションの盗用には使える |
CSRF(ほかのサイトから利用者の Cookie 付きで要求を送らせる攻撃)への守りも必須です。SameSite=Strict だけでは、同じサイトにほかのアプリが同居していると足りません。CORS で守るなら、RFC は推奨として、アプリに決まった独自のヘッダーを付けさせるよう求めています。別のオリジンから独自のヘッダー付きで送る要求は、必ず事前確認(プリフライト)を通るためです。この方式を使うなら、BFF はすべての要求でそのヘッダーを確かめます。フレームワークに組み込まれた CSRF 対策の Cookie も使えます。画面を BFF と同じオリジンに置けば、正規の要求にプリフライトは要りません(6.1.3.3節)。中継先は許可リストで確かめてから送ることが必須です。任意のサーバーへ中継させられるとアクセストークンが漏れるためです(6.1.3.6節)。
セッションをサーバー側に持つ形は、台数を増やすときにスティッキーセッションやセッションの複製が要るので、RFC は小さな規模に限って勧めています。署名した(必要なら暗号化した)セッションを Cookie に持たせる形なら、止めたいときはトークンを失効させれば足ります。アクセストークンの更新は、BFF が中継の途中でリフレッシュトークンを使って行えます(6.1.2.2〜6.1.2.3節)。
SPA でも挟まなくてよい場合
トークンを隠す理由は、ブラウザのアプリが OAuth のトークンを持つときにだけ生まれます。RFC は、フロントと API が共通のドメインで動く、サーバー側の MVC を今の形にしたようなアプリでは、フロントとバックエンドの間を OAuth で守る必要がないことが多く、サーバー側の Cookie のセッションで足りるとしています。それでも、ログインを OpenID Connect で外の ID 基盤に任せられる、あとからドメインが増えても作り直さずに済む、といった理由で OAuth を使う選択も認めています(7.1節)。
Next.js なら、BFF を別のサーバーに分けずアプリの中に置く道もあります。公式ガイドは、Route Handlers と proxy で BFF のパターンを作れるとしています。そのうえで、完全なバックエンドの代わりではないこと、誰でも呼べる公開のエンドポイントなので認証と認可を付けることを求め、流量制限を中に書く例も載せています。Server Actions の主な用途はデータの更新で、取得に使うと順番に実行される、という注意もあります(Next.js「Backend for Frontend」ガイド)。
スマホアプリ:挟む理由は、画面と通信の制約と、アプリの審査
例の店のアプリでは、欲しいものリストに出す項目が Web より少なく、呼び出しも減らしたいところです。アプリ用の BFF なら、要る項目だけを束ねて1回で返せます。Microsoft のパターン集の例でも、モバイル向けの BFF は1ページ分だけを取って軽く返し、デスクトップ向けは複数のページを1回の応答にまとめています(Azure Architecture Center「フロントエンド専用バックエンドパターン」)。リリースの面の理由もあります。Newman は、アプリと BFF を同じチームが持っていれば、機能をサーバー側に移してアプリストアの審査を通さずに早く出す判断を、そのチームだけでできると書いています。
BFF の数について、Newman が紹介する目安は「1つの体験に1つの BFF」です。iOS と Android の体験がよく似ていれば共有しやすく、大きく違えば分けるほうが筋が通ります。REA はプラットフォームごとに分け、SoundCloud は iOS と Android の視聴アプリで1つを共有していました(SoundCloud の技術者は、今なら考え直すかもしれないと話したそうです)。Newman 自身はプラットフォームごとに分ける形を好み、共有すると肥大しやすいと書いています。同じチームが両方を持つなら共有にも寛容です。ただし、チームの境界で数を決める考え方には、チームの形はシステムの設計より変わりやすい、という懸念も添えています。
アプリの BFF を共有するか、分けるか
iOS と Android で1つを共有
例:SoundCloud の視聴アプリ
- 2つのアプリの体験がよく似ている
- 1つのチームが両方のアプリと BFF を持つ
- 共有すると肥大しやすい
プラットフォームごとに分ける
例:REA
- 2つのアプリの体験が大きく違う
- アプリごとに別のチームが持つ
- Newman 自身が好む形
目安は「1つの体験に1つの BFF」。迷ったら分ける(Newman が好む形)。同じチームが両方を持つなら共有も許容
アプリの BFF を、SPA と同じトークンの話で説明しないでください。RFC 10017 はブラウザで動くアプリの文書で、ネイティブアプリはネイティブアプリ向けの BCP である RFC 8252(RFC 10017 と同じ BCP 212 に属する)を見るよう案内しています。
取引先向けの API:挟む理由は、呼び方を変えられない相手
Newman は、外部の相手にも BFF を使う組織を少なくとも1つ見たと書いています。Newman がいつも使う音楽の店の例で言えば、印税の支払い情報を渡す、Facebook と連携する、セットトップボックスへ配信する、といった相手ごとの BFF です。外部の相手は、呼び出し方を変える力も意思も限られていることが多くあります。汎用の API だと、変えられない一部の相手のために古い版を残し続けることになります。相手ごとの BFF なら、この問題はかなり小さくなります(Sam Newman「Backends For Frontends」)。例の店なら、取引先向けの BFF が相手の決まった形で返し、店の中のサービスは自由に変えられます。
取引先ごとの認可や監視をどこに置くかについて、Microsoft のパターン集は、BFF はクライアント固有の処理だけを扱い、監視や認可のような横断的な機能は切り出すべきだとしています。こうした機能は、ゲートキーパー、レート制限、ゲートウェイのルーティングといった別のパターンで扱います。API ゲートウェイとマイクロサービスの組み合わせで足りる場面もある、とも書いています(Azure Architecture Center「フロントエンド専用バックエンドパターン」)。一方で Newman は、認証・認可やログを BFF に入れるかは迷うところだとしています。汎用の機能なので上流の別の層に置きたい一方、層が増えれば待ち時間が延びる、という両面を挙げています。
BFF と API ゲートウェイは別の層
Microsoft のパターン集の例では、手前の Azure API Management(ゲートウェイ)がトークンの検証・記録・キャッシュ・振り分けを受け持ちます。その奥で、入口ごとの BFF が Azure Functions として動き、下のマイクロサービスを呼びます(Azure Architecture Center「フロントエンド専用バックエンドパターン」)。SPA の BFF は、この図の「BFF」の行に、トークンの保持と中継が加わったものです。
ゲートウェイと BFF の受け持ち
出典:Azure Architecture Center「フロントエンド専用バックエンドパターン」の例(API Management・Azure Functions)
GraphQL を使っている場合も、BFF が要るとは限りません。Microsoft のパターン集は、GraphQL ではクライアントが要るデータを自分で指定できるので、別の BFF の層が要らなくなる場合がある、と書いています。フロントエンド固有のリゾルバーを持つ GraphQL なら、BFF を足しても得るものが無いかもしれない、ともしています。
BFF に持たせる仕事と、持たせない仕事
持たせる仕事の中心は、その画面のための集約です。Newman は欲しいものリストの例で、リストの取得が終わったら商品の情報と在庫はできるだけ並行して呼ぶよう勧めています。在庫のサービスだけが落ちたときの扱いは、次の図のとおりです。
欲しいものリストの BFF がすること
在庫のサービスだけが落ちたら、在庫の表示を外して返す。画面は欠けた応答を表示できるようにしておく
出典:Sam Newman「Backends For Frontends」(例の店は説明のための架空の例)
次のコードは、この流れを TypeScript で書いた作例です。動作は確かめておらず、エンドポイントの名前や応答の形は架空です。
// 作例(架空のエンドポイント。動作は未確認)
// accessToken は BFF のセッションから取り出したもの。ブラウザには渡さない
async function getJson(url: string, accessToken: string) {
const res = await fetch(url, { headers: { Authorization: 'Bearer ' + accessToken } });
if (!res.ok) throw new Error(url + ' ' + res.status);
return res.json();
}
export async function wishlistView(userId: string, accessToken: string) {
const list = await getJson(WISHLIST_API + '/users/' + encodeURIComponent(userId) + '/wishlist', accessToken);
const ids = encodeURIComponent(list.itemIds.join(','));
const [catalog, inventory] = await Promise.allSettled([
getJson(CATALOG_API + '/items?ids=' + ids, accessToken),
getJson(INVENTORY_API + '/stock?ids=' + ids, accessToken),
]);
if (catalog.status === 'rejected') throw catalog.reason;
const stock = inventory.status === 'fulfilled' ? inventory.value : null;
const items = catalog.value.items.map((it: any) => ({
id: it.id, name: it.name, price: it.price,
stock: stock ? stock[it.id] : undefined,
}));
return { items, stockUnavailable: stock === null };
}
持たせないのは、どの入口から来ても同じ答えでなければならない業務の処理です。Microsoft のパターン集は、BFF が扱うのはクライアント固有の処理だけだとしています。例の店なら、送料の計算を Web 用とアプリ用の BFF にそれぞれ書くと、同じ計算が2か所に分かれ、片方だけ直す事故の元になります。こうした処理は下のサービスに置き、BFF は結果を画面に合わせて並べるだけにします。
入口ごとに分けると、同じ集約のコードが複数の BFF に並びます。Newman は、重複より共通化でサービス同士が強く結びつくほうを心配します。共通にする手として、Newman は次の3つを挙げています。共通のライブラリにする(安上がりだが、結びつきの元になりやすい)、業務の単位で新しいサービスに切り出す、その変形として集約を下のサービスに移す(欲しいものリストのサービス自身が商品と在庫を呼ぶ)、です。同じものを3回目に書くときに共通化を考える、という目安は、サービスの単位でも通じるとしています。BFF をまとめ直して汎用の集約用 API に戻すと、肥大したコードになりやすいとも書いています(Sam Newman「Backends For Frontends」)。
挟む前に見積もる代償
- サービスの数だけ運用が増える。デプロイ・保守・セキュリティの手当てが BFF ごとに要り、技術的負債にもなりえます(Azure Architecture Center「フロントエンド専用バックエンドパターン」)。
- ネットワークの経由が1つ増える。待ち時間が延びることがあるので、サービスレベルの目標を見直します(同)。
- コードが重複する。入口ごとの使い勝手と重複を比べます(同)。
- すべての要求が BFF を通る(SPA の BFF)。ブラウザだけのアプリよりかなり複雑で、展開の形によっては中継がサーバー側の大きな負担になります(RFC 10017 6.1.4.3節)。
- API からは、多くの利用者が1つの IP に見える。BFF を1台で動かし、API が IP アドレスで流量を制限していると、まとめて止められることがあります。API の側に BFF の存在を知らせておきます(同 6.1.3.5節)。
- BFF はすべての要求と応答を見られる。他社が提供する BFF を使うなら、プライバシーへの影響を考えに入れます(同 6.1.3.4節)。
Newman 自身も、Web の画面しかないアプリなら、サーバー側で束ねる処理がかなり多いときにだけ BFF が意味を持つと見ています。モバイルや外部の相手に固有の機能が要るなら、相手ごとの BFF を最初から強く考えるとしています。ただし、追加のサービスを動かす費用が高ければ考え直すかもしれない、とも書いています。
まず、入口ごとの注文とトークンの置き場所を書き出す
材料は手元で集められます。今のバックエンドに、どの入口のための分岐や項目の出し分けがいくつ入っているか。ブラウザのアプリがアクセストークンをどこに持っているか。取引先のために古い版の API をいくつ残しているか。この3つを書き出せば、上の表のどの行に当たるか、BFF を1つにするか入口ごとに分けるかが決まります。
入口ごとの線引きや、今のバックエンド・ゲートウェイとの仕事の分け方は、当社のシステム統合・基幹刷新の支援で一緒に整理できます。
Sam Newman の記事、Azure Architecture Center、RFC 10017、Next.js の公式ガイドは、2026年10月13日に開いて内容を確かめました。
サービス一覧
業務ツール・Microsoft 365/Google Workspace・AI活用・データ基盤・広告運用・会計ソフト・LINE運用・アクセス解析の8領域で、選定から構築・定着まで支援しています。課題に近い領域からご覧ください。





