本文へスキップ
導 LetUsInstallレットアスインストール
クラウド・連携

OAuth 2.0 による API 認証の理解

LetUsInstall 編集部 5分 2026.03.06
OAuth 2.0 による API 認証の理解

要点

  • OAuth 2.0 は「認可(authorization)」の枠組みであって「認証(authentication)」ではない。この取り違えが、ID トークンを持たない設計や、アクセストークンを本人確認に流用する実装ミスの温床になる。
  • 現在の実務では、ブラウザや公開クライアントに対して Authorization Code Flow に PKCE を併用する構成が標準とされ、Implicit Flow は非推奨とされている。移行の遅れた実装が攻撃面を残しやすい。
  • トークンの保管場所とスコープ設計は、フローの選択以上に運用の安全性を左右する。広すぎるスコープと失効設計の欠如が、漏洩時の被害を増幅する。

クラウドサービスや SaaS を連携させるとき、認可の仕組みとしてほぼ必ず登場するのが OAuth 2.0 である。「Google でログイン」のような画面の裏側で動いているのもこの枠組みだ。しかし OAuth 2.0 は広く使われている一方で、その役割がしばしば誤解される。本稿では、認可と認証の区別という出発点から、実装で実際に事故が起きる箇所までを整理する。

OAuth 2.0 は認可であり、認証ではない

最初に固定すべき区別がある。OAuth 2.0 が定めるのは、あるアプリケーションが利用者に代わって別のサービスのリソースへアクセスする「認可」の手順である。これは「この利用者が誰か」を確認する「認証」とは別の問題だ。IETF の RFC 6749 が定義するのはあくまで認可のフレームワークであり、本人確認のための ID トークンは、その上に構築された OpenID Connect が担う。

この区別が曖昧なまま実装すると、典型的な事故が起きる。アクセストークンを本人確認の証拠として扱ってしまうケースだ。アクセストークンは「このトークンの持ち主はリソースにアクセスしてよい」という認可の証明であって、「このトークンを提示した人物が特定の利用者本人である」ことを保証しない。第三者がなんらかの経路でアクセストークンを入手すれば、それを本人確認に使う実装は、その第三者を本人と誤認する。本人確認が必要なら、OpenID Connect の ID トークンを、発行者・対象者・有効期限まで含めて検証する必要がある。

フローの選択は「どのクライアントか」で決まる

OAuth 2.0 にはいくつかのフローがあり、どれを選ぶかはクライアントの性質で決まる。サーバーサイドで秘密を安全に保持できる機密クライアントと、ブラウザやモバイルアプリのように秘密を隠せない公開クライアントでは、適切なフローが異なる。

現在の実務上の指針は明確だ。IETF の OAuth 2.0 Security Best Current Practice は、ブラウザや公開クライアントに対して Authorization Code Flow に PKCE(Proof Key for Code Exchange)を併用する構成を推奨し、アクセストークンを URL フラグメントで直接返す Implicit Flow を非推奨としている。Implicit Flow はトークンがブラウザの履歴やリファラに残りやすく、傍受の余地が大きいためだ。ここで実務上の落とし穴になるのが、移行の遅れである。古い解説記事やライブラリの既定設定が Implicit Flow のままになっていることがあり、新規実装でも意図せず非推奨のフローを選んでしまう。フローを選ぶ際は、依拠する資料が現在の Best Current Practice を反映しているかを確認する必要がある。

事故はフローより「トークンの扱い」で起きる

フローを正しく選んでも、トークンの保管とスコープ設計を誤ると安全性は崩れる。ブラウザ上でアクセストークンをどこに置くかは、いまも議論のある領域だ。ローカルストレージに置けば、サイトに XSS の穴が一つあるだけでトークンが吸い出される。かといって扱いを誤れば別の経路が開く。ここに唯一の正解はなく、アプリの構成に応じて、トークンの寿命を短くし、失効の仕組みを用意することでリスクを下げるのが現実的な方針になる。

スコープ設計も見落とされやすい。連携時に「とりあえず広めの権限」を要求する実装は珍しくないが、これは漏洩時の被害を直接広げる。読み取りだけで足りる連携に書き込み権限まで付与していれば、トークンが漏れた瞬間に書き込みまで許してしまう。最小権限の原則をスコープに落とし込み、必要な範囲だけを要求することが、事故時の被害を限定する。トークンをやり取りする連携先の完全性という観点は、クラウドストレージ同期の仕組みと設計で扱う同期の信頼性とも通じる。デプロイ環境での秘密情報の扱いについてはコンテナのクラウドデプロイ入門でも触れる。

結論

OAuth 2.0 をめぐる事故の多くは、暗号やプロトコルの破れではなく、認可と認証の取り違え、非推奨フローの残存、そしてトークンとスコープの雑な扱いから生まれる。本人確認が必要なら OpenID Connect の ID トークンを検証し、公開クライアントには PKCE 併用の Authorization Code Flow を選び、スコープは最小限に絞る。フローの選択は出発点にすぎず、トークンをどこに置き、いつ失効させるかまで設計して初めて、連携は実用的な安全性を持つ。※本稿執筆時点の情報であり、仕様や推奨は更新されうる。最新情報は各 RFC および公式資料を参照のこと。

関連記事

AIアプリ

OllamaでローカルLLMを動かす導入ガイド

生成AIをクラウドではなく手元のパソコンで動かしたい——そんなときに便利なのが Ollama です。コマンド1行でモデルをダウンロードし、オフラインでも対話できます。この記事では …

2分 2026.06.19
クラウド・連携

コンテナのクラウドデプロイ入門

要点 コンテナのクラウドデプロイは「イメージを動かす」ことより「イメージをどう作り、どう構成を注入するか」が本質であり、事故の多くはこの二点に集中する。 「手元では動くのに本番で動…

4分 2026.03.13

更新のお知らせ

新しい導入ガイドをメールで受け取る

新規記事の要点と更新履歴を月 1〜2 回配信します。配信停止はいつでも可能です。