# API 認証方法

アプリのユースケースに最適な API 認証方法を選択してください。

ユーザーに代わって Stripe API へのリクエストを認証するには、アプリで次の 3 つの方法のいずれかを使用します。

| 方法                                                                                           | 説明                                                                                                            | ユースケース                                                                                                                                    |
| -------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| [プラットフォームキー](https://docs.stripe.com/stripe-apps/build-backend.md#using-stripe-apis) (デフォルト) | アカウントのシークレット API キーがユーザーのアカウントに代わって Stripe API へのリクエストを行います。                                                  | - インストールごとに管理するキーの数を減らしたい。
  - (プライベートプレビュー版)[埋め込み型 Stripe Apps](https://docs.stripe.com/stripe-apps/embedded-apps.md) を使用してアプリを配布する予定です。 |
| [OAuth 2.0](https://docs.stripe.com/stripe-apps/api-authentication/oauth.md)                 | 業界標準の OAuth 2.0 を使用して、Stripe API とやり取りするためのアクセストークンを生成します。代理で運用しているアカウントに対するアクセストークンを使用して Stripe SDK を初期化します。 | - 他のシステムとやり取りする際にすでに OAuth を使用している。
  - ユーザーがソフトウェアから実装を管理することを希望している。                                                                    |
| [制限付き API キー](https://docs.stripe.com/stripe-apps/api-authentication/rak.md)                 | ユーザーがアプリをインストールすると、Stripe は許可された制限付き API キーを生成します。ユーザーはこの API キーをコピーして、Stripe とやり取りするソフトウェアに貼り付ける必要があります。     | - 使用しているソフトウェアがプラットフォームまたは OAuth によるアカウント登録をサポートできない。
  - ユーザーがオンプレミスでソフトウェアを実行する。                                                        |

## 設定

API 認証方法を設定するには、[アプリのマニフェスト](https://docs.stripe.com/stripe-apps/reference/app-manifest.md)の `stripe_api_access_type` を編集します。設定手順については、上表に記載されているリンク先ページをご覧ください。

```json
{
  "id": "com.example.app",
  "version": "0.0.1",
  "name": "Your Stripe App",
  "distribution_type": "public",
  "permissions": [],"stripe_api_access_type": "platform" | "oauth" | "restricted_api_key",
}
```

## See also

- [OAuth 2.0 の設定](https://docs.stripe.com/stripe-apps/api-authentication/oauth.md)
- [制限付きアクセスキー認証の設定](https://docs.stripe.com/stripe-apps/api-authentication/rak.md)