# Stripe CLI をインストールする

macOS、Windows、Linux に Stripe CLI をインストールします。

Stripe CLI では、コマンドラインから統合を構築、テスト、管理できます。Stripe CLI を使用して、次のことができます。

- サンドボックス内の Stripe リソースを作成、取得、更新、または削除します。
- アカウントで発生しているリアルタイムの API リクエストやイベントをストリーミングする。
- イベントをトリガーして Webhook 統合をテストする。

詳細については、[Stripe CLI リファレンス](https://docs.stripe.com/cli.md)を参照してください。
[Watch on YouTube](https://www.youtube.com/watch?v=iFwBGI-kqeE)
## Stripe CLI をインストールする

コマンドラインから、インストールスクリプトを使用するか、お使いのオペレーティングシステム用のバージョン管理されたアーカイブファイルをダウンロードして展開し、CLI をインストールします。

#### homebrew

[homebrew](https://brew.sh/) で Stripe CLI をインストールするには、以下を実行します。

```bash
brew install stripe/stripe-cli/stripe
```

#### apt

CLI の Debian ビルドは [JFrog](https://packages.stripe.dev) で利用可能ですが、これは Stripe が所有するドメインではありません。この URL にアクセスすると、JFrog アーティファクトリーのリストにリダイレクトされます。

Debian および Ubuntu ベースのディストリビューションに Stripe CLI をインストールする方法は以下のとおりです。

1. Stripe CLI の GPG キーを apt ソースのキーリングに追加します。

   ```bash
   curl -s https://packages.stripe.dev/api/security/keypair/stripe-cli-gpg/public | gpg --dearmor | sudo tee /usr/share/keyrings/stripe.gpg > /dev/null
   ```

1. CLI の apt リポジトリを apt ソースリストに追加します。

   ```bash
   echo "deb [signed-by=/usr/share/keyrings/stripe.gpg] https://packages.stripe.dev/stripe-cli-debian-local stable main" | sudo tee -a /etc/apt/sources.list.d/stripe.list
   ```

1. パッケージリストを更新します。

   ```bash
   sudo apt update
   ```

1. CLI をインストールします。

   ```bash
   sudo apt install stripe
   ```

#### yum

CLI の RPM ビルドは [JFrog](https://packages.stripe.dev) で利用可能ですが、これは Stripe が所有するドメインではありません。この URL にアクセスすると、JFrog アーティファクトリーのリストにリダイレクトされます。

RPM ベースのディストリビューションに Stripe CLI をインストールする方法は以下のとおりです。

1. CLI の yum リポジトリーを yum ソースリストに追加します。

   ```bash
   echo -e "[Stripe]\nname=stripe\nbaseurl=https://packages.stripe.dev/stripe-cli-rpm-local/\nenabled=1\ngpgcheck=0" >> /etc/yum.repos.d/stripe.repo
   ```

1. CLI をインストールします。

   ```bash
   sudo yum install stripe
   ```

#### Scoop

[Scoop](https://scoop.sh/) で Stripe CLI をインストールするには、以下を実行します。

```bash
scoop bucket add stripe https://github.com/stripe/scoop-stripe-cli.git
```

```bash
scoop install stripe
```

#### macOS

homebrew なしで Stripe CLI を macOS にインストールする方法は以下のとおりです。

1. [GitHub](https://github.com/stripe/stripe-cli/releases/latest) から、ご使用の cpu アーキテクチャータイプの最新の `mac-os` tar.gz ファイルをダウンロードします。

1. `tar -xvf stripe_[X.X.X]_mac-os_[ARCH_TYPE].tar.gz` を使用して、ファイルを解凍します。

オプションで、バイナリをグローバルに実行できる店舗ンストールできます (例: `/usr/local/bin`)。

#### Linux

Package Manager なしで Stripe CLI を Linux にインストールする方法は以下のとおりです。

1. [GitHub](https://github.com/stripe/stripe-cli/releases/latest) から、最新の `linux` tar.gz ファイルをダウンロードします。

1. `tar -xvf stripe_X.X.X_linux_x86_64.tar.gz` を使用して、ファイルを解凍します。

1. `./stripe` を自身の実行パスに移動します。

#### Windows

Scoop なしで Stripe CLI を Windows にインストールする方法は、以下のとおりです。

1. [GitHub](https://github.com/stripe/stripe-cli/releases/latest) から、最新の `windows` zip ファイルをダウンロードします。

1. `stripe_X.X.X_windows_x86_64.zip` ファイルを解凍します。

1. 解凍した `stripe.exe` ファイルへのパスを `Path` 環境変数に追加します。環境変数を更新する方法については、 [Microsoft PowerShell のドキュメント](https://learn.microsoft.com/ja-jp/powershell/module/microsoft.powershell.core/about/about_environment_variables?view=powershell-7.3#saving-changes-to-environment-variables) ご覧ください。

Windows アンチウイルススキャナは、Stripe CLI に安全でないフラグを立てることがあります。これは誤検知である可能性が非常に高いです。詳細については、GitHubリポジトリの[問題 #692](https://github.com/stripe/stripe-cli/issues/692) を参照してください。

#### Docker

Stripe CLI は、[Docker イメージ](https://hub.docker.com/r/stripe/stripe-cli)としても使用できます。最新バージョンをインストールするには、以下を実行します。

```bash
docker run --rm -it stripe/stripe-cli:latest
```

## CLI にログインする

1. ログインして Stripe ユーザー[アカウント](https://docs.stripe.com/get-started/account/set-up.md)を認証すると、制限付きキーのセットを生成できます。詳細については、[Stripe CLI のキーと権限](https://docs.stripe.com/stripe-cli/keys.md)を参照してください。

   ```bash
     stripe login
   ```

1. キーボードの **Enter** キーを押して、ブラウザーでの認証プロセスを完了します。

   ```bash
   Your pairing code is: enjoy-enough-outwit-win
   This pairing code verifies your authentication with Stripe.
   Press Enter to open the browser or visit https://dashboard.stripe.com/stripecli/confirm_auth?t=THQdJfL3x12udFkNorJL8OF1iFlN8Az1 (^C to quit)
   ```

オプションとして、ブラウザーを使用しない場合は、`--interactive` フラグを使用して既存の API シークレットキーまたは制限付きキーで認証できます。これは、CI/CD パイプライン内などで、ブラウザーを使用せずに CLI で認証する場合に便利です。

```bash
stripe login --interactive
```

また、`--api-key` フラグを使用して、リクエストを送信するたびに API シークレットキーをインラインで指定します。

```bash
stripe login --api-key <<YOUR_SECRET_KEY>>
```