認証

Roboflow の認証方法 - API キー、公開可能キー、スコープ付きキー、OAuth。

Roboflow APIおよびRoboflow Inferenceへのすべてのリクエストは認証されています。このセクションでは、Roboflowが提供する認証情報の種類、それぞれを使うべき場面、そしてリクエストに必要なIDの確認場所を説明します。

APIキーは次で確認できます app.roboflow.com/settings/api.

認証情報の種類

Roboflowは複数の種類の認証情報をサポートしており、それぞれ異なる用途に適しています：

• プライベートAPIキー — デフォルトのワークスペース認証情報です。ワークスペースのデータ、モデル、プロジェクトへのフルアクセスを許可するため、パスワードのように扱い、サーバー側に保管してください。次の用途で使用します。 REST API, Python SDK, CLI、およびセルフホストの 推論。参照 Roboflow APIキーの確認.

• 公開可能キー — 形式が rf_<workspaceId>の秘密ではない認証情報で、ブラウザやエッジコードに埋め込んでも安全です。たとえば inferencejs。これは推論とモデルのダウンロード専用で、ワークスペースIDから導出されるため、ローテーションや失効はできません。参照： 公開可能キー.

• スコープ付き API キー — 特定の権限（たとえば、推論は実行できるがモデルは管理できない）に制限された Enterprise 向け認証情報で、必要に応じて特定のプロジェクトフォルダにも限定できます。参照： スコープ付き API キー.

• OAuth 2.1（Roboflowでサインイン） — ユーザーがRoboflowアカウントであなたのアプリにサインインし、PKCEを使った認可コードフローで、あなたのアプリに代わってスコープ付きアクセスを許可できるようにします。参照： Roboflow でサインイン（はじめに）.

キーの管理

• Roboflow APIキーの確認 — キーの保存場所、プライベートキーと公開可能キーの違い、侵害されたキーのローテーションについて。

• API キーの管理 — REST API、 roboflow api-key CLI、またはMCPサーバー経由で、キーをプログラムで作成、一覧表示、更新、保護、無効化、失効できます。

• スコープ付き API キー — 特定の権限に制限されたEnterpriseキーを発行します。

Roboflowでサインイン（OAuth）

• Roboflow でサインイン（はじめに） — OAuthアプリを登録し、PKCEフローを実行し、トークンを交換・更新し、利用可能なスコープの全一覧を確認できます。

• Roboflow でサインイン（開発者リファレンス） — エンドポイント、ホスト、可視性、トークンエンドポイント認証、エラー、および実行可能なサンプルアプリ。

• OAuth 2.1（Roboflowでサインイン） — 上記2つのガイドへのリンクをまとめた旧ランディングページ。

IDの確認

ほとんどのAPI呼び出しではキーだけでは不十分で、どのワークスペース、プロジェクト、モデルバージョンを対象にするかを知る必要があります。

• ワークスペースIDとプロジェクトID — 推論およびAPIリクエストで使用するプロジェクトIDとモデルバージョン番号を取得します。

各ホストで受け付けられるヘッダー形式とクエリパラメータ形式については、 REST API で認証する.