> 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/overview-of-1password-sdks.md).
# 1Password SDK
### 1Password SDK
1Password SDKを使うと、Go、JavaScript、またはPythonを使い、1PasswordにSaveされているシークレットにプログラムでアクセスできるシークレット管理統合を構築できます。1Password SDKを使うと、次のことが可能になります。
* [シークレット参照](https://developer.1password.com/docs/sdks/load-secrets/)を使って1Password のシークレットをコードに安全に読み込みます。
* パスワード、API キー、ワンタイムパスワードなど、1PasswordにSaveされている[シークレットを読み取り、書き込み、更新できます。](https://developer.1password.com/docs/sdks/manage-items/)
* 1Passwordアカウント内の[アイテムと保管庫を一覧表示](https://developer.1password.com/docs/sdks/list-vaults-items/)できます。
### サポートする言語
[Golang](https://github.com/1Password/onepassword-sdk-go)
[JavaScript](https://github.com/1Password/onepassword-sdk-js/)
[Python](https://github.com/1Password/onepassword-sdk-python/)
### サポートされている機能
| **特徴** | **サポートされている機能** | **注記** |
| -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- |
| シークレット参照 | | [サポートされているフィールド タイプ](https://developer.1password.com/docs/sdks/concepts/#supported-field-types)からシークレットを取得できます。 |
| アイテム管理 | | [サポートされているフィールドタイプ](https://developer.1password.com/docs/sdks/concepts/#supported-field-types)に対して操Createを実行できます。 |
| 保管庫管理 | | |
| 認証 | | |
### インテグレーションの例
パートナーがSDKを使って1Passwordとの統合を構築した例をご覧ください。
[Postman](https://go.pstmn.io/1password)
1PasswordにSaveされているAPI キーやその他のシークレットを、平文で公開することなく、安全にPostmanに読み込みませました。
[もっと詳しく知る](https://go.pstmn.io/1password)
[Pulumi ESC](https://www.pulumi.com/docs/esc/providers/1password-secrets/)
1Passwordからシークレットを環境に動的にインポートするようにしました。プロバイダーは、シークレットの名前のマップを返します。
[もっと詳しく知る](https://www.pulumi.com/docs/esc/providers/1password-secrets/)
### [始めましょう](https://developer.1password.com/docs/sdks/#get-started)
始める前に、[1Passwordアカウントにサインアップする](https://start.1password.com/sign-up/plan)必要があります。
#### ステップ 1：サービスアカウントをCreateる
[1Passwordサービスアカウント](https://developer.1password.com/docs/service-accounts/get-started)をCreateり、SDKで使うシークレットがSaveされている保管庫へのアクセス権を付与します。
SDKがアイテムを更新できるようにするには、適切な保管庫での読み取り権限と書き込み権限の両方をサービスアカウントに付与するようにしてください。
#### ステップ 2：サービスアカウントトークンを準備する
SDKは、サービスアカウントトークンを使って1Passwordに認証します。環境からトークンをプロビジョニングすることをお勧めします。
次の例を使用して、 という名前の環境変数にトークンをプロビジョニングしますOP\_SERVICE\_ACCOUNT\_TOKEN。ファイルから読み取るなど、他の方法でトークンをプロビジョニングすることもできます。
* **Bash、sh、zsh**
$ export OP\_SERVICE\_ACCOUNT\_TOKEN=\
* **fish**
$ set -x OP\_SERVICE\_ACCOUNT\_TOKEN \
* **PowerShell**
$ Env:OP\_SERVICE\_ACCOUNT\_TOKEN = "\"
#### ステップ3：SDKをインストールする
あなたのプロジェクトにSDKをインストールします。
* **Go**
go get [github.com/1password/onepassword-sdk-go](http://github.com/1password/onepassword-sdk-go)
* **JavaScript**
$ npm install @1password/sdk
* **Python**
pip install onepassword-sdk
#### ステップ4：SDKをインポートする
SDKをプロジェクトにインポートします。
* **Go**
import "github.com/1password/onepassword-sdk-go"
* **JavaScript**
**CommonJS**\
**const sdk = require("@1password/sdk");**
**ES Modules**\
**import sdk from "@1password/sdk";**
* Python
from onepassword import \*
#### ステップ5：SDKを初期化する
SDKを初期化すると、設定パラメーターを含むクライアントインスタンスがCreateされます。
* **Go**
このonepassword.NewClient関数は、サービス アカウントトークンをパラメーターとして受け取ります。SDKはこのトークンを認証に使用します。
次の例では、SDKは環境変数OP\_SERVICE\_ACCOUNT\_TOKENのパラメーターを使って関数onepassword.NewClientからサービスアカウントトークンを取得します。
”My 1Password Integration”と”v1.0.0”の代わりに、アプリケーションの名前とバージョンを必ず指定してください。
* **JavaScript**
このCreateClient関数は、サービスアカウントトークンをパラメーターとして受け取ります。SDK はこのトークンを認証に使用します。
次の例では、SDK は関数OP\_SERVICE\_ACCOUNT\_TOKENのパラメータを使用して環境変数からサービス アカウント トークンを取得しますCreateClient。
My 1Password Integrationおよびの代わりに、アプリケーションの名前とバージョンを必ず指定してくださいv1.0.0。
* **Python**
このclient.authenticate関数は、サービス アカウント トークンをパラメーターとして受け取ります。SDK はこのトークンを認証に使用します。
次の例では、SDK は関数OP\_SERVICE\_ACCOUNT\_TOKENのパラメータを使用して環境変数からサービス アカウント トークンを取得しますclient.authenticate。
My 1Password Integrationおよびの代わりに、アプリケーションの名前とバージョンを必ず指定してくださいv1.0.0。
#### ステップ6:構築開始
これで、SDK を使って構築を始める準備が整いました。例については、 [Go](https://github.com/1Password/onepassword-sdk-go/tree/main/example)、[JavaScript](https://github.com/1Password/onepassword-sdk-js/tree/main/examples)、または[Python](https://github.com/1Password/onepassword-sdk-python/blob/main/example/example.py) SDK の GitHub リポジトリにアクセスするか、次の方法を学んでください。
* [シークレットをロードする](https://developer.1password.com/docs/sdks/load-secrets/)
* [アイテムを管理する](https://developer.1password.com/docs/sdks/manage-items/)
* 保管庫[とアイテムの一覧](https://developer.1password.com/docs/sdks/list-vaults-items/)
### ヘルプを受ける
1Password SDK に関するサポートを受けるには、[Developer Slack ワークスペース](https://developer.1password.com/joinslack)に参加し、チャネルで質問してください#sdk。
新しい機能をリクエストしたり、バグを報告したりするには、適切な GitHub リポジトリに問題を報告してください。
* [Go](https://github.com/1Password/onepassword-sdk-go/issues/new/choose)
* [JavaScript](https://github.com/1Password/onepassword-sdk-js/issues/new/choose)
* [Python](https://github.com/1Password/onepassword-sdk-python/issues/new/choose)
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://manual.dxable.com/1password/overview-of-1password-sdks.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.