1Password SDK
1Passwordマニュアル｜Go言語でのシークレット管理を強化する1Password SDKの活用法。プログラムから安全にアクセス可能な統合方法を解説します。
1Passwordマニュアル｜Go言語でのシークレット管理を強化する1Password SDKの活用法。プログラムから安全にアクセス可能な統合方法を解説します。
1Password SDKを使うと、Go、JavaScript、またはPythonを使い、1PasswordにSaveされているシークレットにプログラムでアクセスできるシークレット管理統合を構築できます。1Password SDKを使うと、次のことが可能になります。
を使って1Password のシークレットをコードに安全に読み込みます。
パスワード、API キー、ワンタイムパスワードなど、1PasswordにSaveされている
1Passwordアカウント内のできます。
特徴
サポートされている機能
注記
シークレット参照
アイテム管理
保管庫管理
保管庫をリストする
認証
パートナーがSDKを使って1Passwordとの統合を構築した例をご覧ください。
1PasswordにSaveされているAPI キーやその他のシークレットを、平文で公開することなく、安全にPostmanに読み込みませました。
1Passwordからシークレットを環境に動的にインポートするようにしました。プロバイダーは、シークレットの名前のマップを返します。
SDKがアイテムを更新できるようにするには、適切な保管庫での読み取り権限と書き込み権限の両方をサービスアカウントに付与するようにしてください。
SDKは、サービスアカウントトークンを使って1Passwordに認証します。環境からトークンをプロビジョニングすることをお勧めします。
次の例を使用して、 という名前の環境変数にトークンをプロビジョニングしますOP_SERVICE_ACCOUNT_TOKEN。ファイルから読み取るなど、他の方法でトークンをプロビジョニングすることもできます。
Bash、sh、zsh
$ export OP_SERVICE_ACCOUNT_TOKEN=<your-service-account-token>
fish
$ set -x OP_SERVICE_ACCOUNT_TOKEN <your-service-account-token>
PowerShell
$ Env:OP_SERVICE_ACCOUNT_TOKEN = "<your-service-account-token>"
あなたのプロジェクトにSDKをインストールします。
Go
JavaScript
$ npm install @1password/sdk
Python
pip install onepassword-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 *
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。
新しい機能をリクエストしたり、バグを報告したりするには、適切な GitHub リポジトリに問題を報告してください。
からシークレットを取得できます。
に対して操Createを実行できます。
対応
始める前に、必要があります。
をCreateり、SDKで使うシークレットがSaveされている保管庫へのアクセス権を付与します。
go get
これで、SDK を使って構築を始める準備が整いました。例については、 、、または SDK の GitHub リポジトリにアクセスするか、次の方法を学んでください。
保管庫
1Password SDK に関するサポートを受けるには、に参加し、チャネルで質問してください#sdk。
