> For the complete documentation index, see [llms.txt](https://manual.dxable.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://manual.dxable.com/1password/get-started-with-1password-service-accounts.md).

# 1Password Service Accountsを初めて使う

### **1Password Service Accountsを初めて使う** <a href="#yix8chij2yvl" id="yix8chij2yvl"></a>

1Password Service Accountsを使うと、追加のサービスを導入することなく、アプリケーションとインフラ内のシークレット管理を自動化するツールを構築できます。

サービスアカウントは次のことができます。

* アイテムをCreate、編集、削除、共有する。
* 保管庫をCreateする。
* 保管庫を削除する。\
  サービスアカウントは、自分がCreateした保管庫のみを削除できます。[サービスアカウントのセキュリティー](https://developer.1password.com/docs/service-accounts/security/)を参照してください。
* ユーザーとグループに関する情報を取得する。

各サービスアカウントには、認証用の環境変数として提供できる[サービスアカウントトークン](https://developer.1password.com/docs/service-accounts/security/#service-accounts-and-token-generation)があります。サービスアカウントがアクセスできる保管庫と、各保管庫での権限を選択できます。

<https://youtu.be/E3HKeG9P8HA><br>

制限事項

サービスアカウントには次の制限があります。

* サービスアカウントには[レート制限があり、リクエストクォータがあります](https://developer.1password.com/docs/service-accounts/rate-limits/)。
* 組み込みの[個人用](https://support.1password.com/1password-glossary/#personal-vault)、[プライベート](https://support.1password.com/1password-glossary/#private-vault)、[従業員用](https://support.1password.com/1password-glossary/#employee-vault)コンテナー、またはデフォルトの[共有](https://support.1password.com/1password-glossary/#shared-vault)コンテナーへのアクセス権をサービスアカウントに付与することはできません。
* サービスアカウントは、1Password CLI バージョン 2.18.0 以降でのみ機能します。「[1Password CLI でサービスアカウントを使う](https://developer.1password.com/docs/service-accounts/use-with-1password-cli/)」を参照してください。
* [Kubernetes Operator](https://developer.1password.com/docs/k8s/k8s-integrations/#kubernetes-operator)ではサービスアカウントは使えません（[Kubernetes Secrets Injector](https://developer.1password.com/docs/k8s/k8s-integrations/#kubernetes-injector)のみ使えます）。

### **必要条件** <a href="#t4nqdsvfephi" id="t4nqdsvfephi"></a>

サービスアカウントをCreateって使う前に、次のことを行う必要があります。

* [1Passwordにサインアップする。](https://1password.com/pricing)
* サービスアカウントをCreateするための適切なアカウント権限を持っていること。

サービスアカウントをCreateするオプションが表示されない場合は、管理者に[サービスアカウントのCreateと管理のアクセス権を付与する](https://developer.1password.com/docs/service-accounts/manage-service-accounts#manage-who-can-create-service-accounts)よう依頼してください。

### **サービスアカウント** <a href="#e2yhqqml2hzs" id="e2yhqqml2hzs"></a>

1Password.comまたは[1Password CLI](https://developer.1password.com/docs/cli/)を使ってサービスアカウントをCreateできます。サービスアカウントをCreateした後は、保管庫をCreateする機能や保管庫に対する権限を編集することはできません。

* 1Password.com

1Password.comでサービスアカウントをCreateするには以下のようにします。

①1Password.com のアカウントに[サインイン](https://start.1password.com/signin)します。\
②サイドバーで\[Developer Tools]を選択します。既にアクティブなDeveloper Toolsがある場合は、「Developer Tools」ページの上部にある\[Directory]を選択します。\
③「Infrastructure Secrets Management」で、[「Other」](https://start.1password.com/developer-tools/infrastructure-secrets)を選択します。\
④\[Create a Service Account]を選択し、画面の指示に従います。

* * 1\. サービスアカウントの名前を選択します。
  * 2\. サービスアカウントが保管庫をCreateできるかどうかを選択します。
  * 3\. サービスアカウントがアクセスできる保管庫を選択します。\
    組み込みの個人用、プライベート、従業員用保管庫、またはデフォルトの共有保管庫へのアクセス権をサービスアカウントに付与することはできません。
  * 4\. 設定アイコ&#x30F3;**⚙**&#x3092;選択をクリックして、サービスアカウントが保管庫内で持つ権限を選択します。これは後で変更できません。
  * 5\. \[Create Account]を選択して サービスアカウントをCreateします。
  * 6\. \[Save in 1Password]を選択して、サービスアカウントトークンを 1Password アカウントにSaveします。次のウィンドウで、アイテムの名前を入力し、Save先の保管庫を選択します。

🔥危険\
サービスアカウントCreateウィザードでは、サービスアカウントトークンが1度だけ表示されます。**トークンを紛失しないように、すぐに1PasswordにSaveしてください。**&#x3053;のトークンはパスワードのように扱い、平文でSaveしないでください。

* 1Password CLI

1Password CLIでサービスアカウントをCreateするには以下のようにします。\
①お使いのマシンに1Password CLIの最新バージョンがあることを確認してください。\
②op service-account createコマンドを使って新しいサービスアカウントをCreateします。

$ op service-account create \<serviceAccountName> --expires-in \<duration> --vault \<vault-name:\<permission>,\<permission>

* 利用可能なパーミッション： read\_items、 write\_items（read\_itemsが必要）、 share\_items（read\_itemsが必要）
* サービスアカウントが新しいデータ保管庫をCreateできるようにするには、--can-create-vaultsフラグを含めます。
* サービスアカウント名またはデータ保管庫名にスペースが含まれる場合は、その名前を引用符で囲みます（例："My Service Account"）。文字列にスペースが含まれない場合は、引用符で囲む必要はありません（例：myServerName）。
* サービスアカウントは、Create後に変更することはできません。変更が必要な場合は、サービスアカウントを失効させ、新しいアカウントをCreateしてください。

③サービスアカウントトークンを1PasswordアカウントにSaveします。\
④1Password CLIでサービスアカウントの使用を開始する場合は、トークンを環境変数OP\_SERVICE\_ACCOUNT\_TOKENにエクスポートします。

例えばProductionという名前のデータ保管庫に読み取り権限と書き込み権限を持ち、新しいデータ保管庫をCreateでき、24時間で有効期限が切れるMy Service Accountという名前のサービスアカウントをCreateるには次のように入力します。\
$ op service-account create "My Service Account" --can-create-vaults --expires-in 24h --vault Production:read\_items,write\_items

🔥危険\
1Password CLIはサービスアカウントトークンを一度しか返しません。**トークンを紛失しないように、すぐに1PasswordにSaveしてください。**&#x3053;のトークンはパスワードのように扱い、平文でSaveしないでください。

⚠️注意\
[サインインアドレス](https://support.1password.com/1password-glossary/#sign-in-address)を変更した場合は、[サービスアカウントトークンをローテートする](https://developer.1password.com/docs/service-accounts/manage-service-accounts#rotate-token)必要があります。

### **次のステップ** <a href="#id-59w7o6m41h8h" id="id-59w7o6m41h8h"></a>

サービスアカウントの使用方法については、以下を参照してください。

* [1Password CLIでサービスアカウントを使用します。](https://developer.1password.com/docs/service-accounts/use-with-1password-cli/)
* [サービスアカウントを管理します。](https://developer.1password.com/docs/service-accounts/manage-service-accounts/)
* [サービスアカウントをCI/CDパイプラインと統合します。](https://developer.1password.com/docs/ci-cd/)
* [サービスアカウントをKubernetesと統合します。](https://developer.1password.com/docs/k8s/k8s-integrations/)

💡ヘルプが必要ですか?

[開発者向けのSlackワークスペースに参加して](https://developer.1password.com/joinslack)質問したりフィードバックを提供したりしてください。