> ## Documentation Index
> Fetch the complete documentation index at: https://developers.authlete.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 認証（Authlete 2.x）

> Authlete 2.x API の認証方法：API キーと API シークレット（HTTP Basic 認証）の取得と使い方

<Note>
  このページは **Authlete 2.x** 用です。3.0 では [API 認証（3.0）](/ja/get-started/concepts/authentication) をご覧ください。
</Note>

# 認証（2.x）

Authlete 2.x の API は **HTTP Basic 認証**で保護されています。**Bearer トークン**ではなく、**API キー**（サービス API キー）と **API シークレット**で認証し、Authlete 2.x API（`api.authlete.com`）へのリクエストごとにこれらを含めます。

## 認証の仕方

**API キー**をユーザー名、**API シークレット**をパスワードとして HTTP Basic 認証で送信します。

**ヘッダー形式:**

```http theme={null}
Authorization: Basic <base64(API_KEY:API_SECRET)>
```

**curl の例:**

```bash theme={null}
curl -X POST "https://api.authlete.com/api/auth/authorization" \
  -u '<API_KEY>:<API_SECRET>' \
  -H "Content-Type: application/json" \
  -d '{"parameters": "response_type=code&client_id=..."}'
```

curl の `-u` オプションで HTTP Basic 認証として送信されます。`<API_KEY>` と `<API_SECRET>` を、ご利用のサービスの API キーと API シークレットに置き換えてください。

***

## API キーと API シークレットの取得（2.x）

Authlete 2.x では、各**サービス**に **API キー** と **API シークレット** が 1 組あります。認可サーバーが Authlete を呼び出す際の識別と認証に使います。

**取得手順**

1. [Service Owner Console](https://so.authlete.com/)（2.x）にサインアップまたはログインする。
2. **サービス**を開く（まだなければ作成する）。
3. サービス設定で **API Key** と **API Secret** を確認する。
4. コピーして安全に保管する。Basic 認証の「ユーザー名」に API キー、「パスワード」に API シークレットを使用する。

そのサービス向けの Authlete 2.x API 呼び出し（例: `/auth/authorization`、`/auth/token`、`/auth/introspection`）は、すべて同じ API キーとシークレットで行います。2.x には「サービスアクセストークン」や「組織トークン」はなく、API キーとシークレットのみです。

<Info>
  **セキュリティ:** API キーと API シークレットは秘密として扱い、バージョン管理にコミットしたりクライアント側で露出させたりしないでください。環境変数やシークレットマネージャーを利用してください。
</Info>

***

## 動作確認（2.x）

次のような簡単な呼び出しで認証情報を確認できます。

```bash theme={null}
curl -s -X POST "https://api.authlete.com/api/auth/authorization" \
  -u '<API_KEY>:<API_SECRET>' \
  -H "Content-Type: application/json" \
  -d '{"parameters": "response_type=code&client_id=YOUR_CLIENT_ID&redirect_uri=https://example.com/cb"}'
```

`<API_KEY>`、`<API_SECRET>`、`YOUR_CLIENT_ID` を、ご利用のサービスの API キー、API シークレット、およびそのサービスの有効なクライアント ID に置き換えてください。成功時は `action`（例: `INTERACTION`）と `ticket` が含まれたレスポンスが返ります。

***

## 2.x と 3.0 の違い

|          | Authlete 2.x                           | Authlete 3.0                                                 |
| -------- | -------------------------------------- | ------------------------------------------------------------ |
| **認証方式** | HTTP Basic（API キー + API シークレット）        | Bearer トークン（サービスまたは組織のアクセストークン）                              |
| **取得先**  | Service Owner Console（so.authlete.com） | Authlete Console（console.authlete.com）— サービスまたは組織 → アクセストークン |
| **スコープ** | サービスごとに 1 組のキー/シークレット                  | サービスアクセストークン（サービス単位）または組織トークン（組織全体）                          |

3.0 の認証（Bearer トークン、サービス・組織トークン）については [API 認証（3.0）](/ja/get-started/concepts/authentication) をご覧ください。

***

## 次のステップ

* [はじめに（2.x）](/ja/v2/get-started/quickstarts/getting-started) — Authlete 2.x で OAuth 2.0 フローを試す。
* [OAuth 2.0 Basics（2.x）](/ja/v2/get-started/core-concepts/oauth-basics) — Authlete 2.x API をステップごとに呼び出す。