1Password Python SDK
1Passwordマニュアル|Python SDKを使用して、1Passwordの秘密情報にプログラムでアクセスする方法を説明し、安全な統合を構築しましょう。
1Password Python SDK
1Password の秘密にプログラムでアクセスする統合を構築します。
必要条件
1Password Python SDK は次のものと互換性があります:
- python3.9以降
- libssl3
- glibc2.32以降
libsslDebian 11 や Ubuntu 20.04 など、バージョン 1.1.1 をまだ使用している Linux ディストリビューションを実行している場合は、 Linux の新しいバージョンに更新するか、必要な依[Save]関係をインストールする必要があります。
🚀 始める
プロジェクトで 1Password Python SDK を使うには:
- サービス アカウントをCreateし、SDK で使うアイテムがSaveされている保管庫に適切な権限を付与します。
- サービス アカウント トークンをプロビジョニングします。環境からトークンをプロビジョニングすることをお勧めします。例えば、トークンをOP_SERVICE_ACCOUNT_TOKEN環境変数にエクスポートするには、次のようにします。 macOS または Linux export OP_SERVICE_ACCOUNT_TOKEN=<your-service-account-token> ウィンドウズ $Env:OP_SERVICE_ACCOUNT_TOKEN = "<your-service-account-token>"
- プロジェクトに 1Password Python SDK をインストールします。 pip install onepassword-sdk
- プロジェクトで Python SDK を使用します。
import asyncio
import os
from onepassword.client import Client
async def main():
# Gets your service account token from the OP_SERVICE_ACCOUNT_TOKEN environment variable.
token = os.getenv("OP_SERVICE_ACCOUNT_TOKEN")
# Connects to 1Password. Fill in your own integration name and version.
client = await Client.authenticate(auth=token, integration_name="My 1Password Integration", integration_version="v1.0.0")
# Retrieves a secret from 1Password. Takes a secret reference as input and returns the secret to which it points.
value = await client.secrets.resolve("op://vault/item/field")
# use value here
if __name__ == '__main__':
asyncio.run(main())
1Password からコードにシークレットを安全に読み込むには、構文でシークレット参照 URI を使うようにしてください。op://vault/item/field
サポートされている機能
1Password SDK は現在開発中です。次に何を希望するか、ぜひご意見をお聞かせください。賛Create票を投じるか、問題を報告してお知らせください。
アイテム管理
操Create:
フィールドタイプ:
- APIキー
- パスワード
- 隠されたフィールド
- テキストフィールド
- 注記
- SSH 秘密鍵 (部分的にサポート: シークレット参照の解決ではサポートされていますが、アイテムのCreate/取得/更新ではまだサポートされていません)
- SSH公開鍵、指紋、鍵の種類
- ワンタイムパスワード
- URL
- ウェブサイト(ログインの提案や自動入力に使用)
- 電話番号
- クレジットカードの種類
- ファイルの添付とドキュメント項目
金庫管理
ユーザーとアクセス管理
- ユーザーのプロビジョニング
- ユーザーを取得する
- ユーザーを一覧表示する
- ユーザーを停止する
- グループをCreateする
- グループメンバーシップを更新する
- 保管庫のアクセスと権限を更新する
コンプライアンスと報告
- ものみの塔の洞察
- 旅行モード
- イベント。今のところ、1Password イベント レポート API を直接使用してください。
認証
- 1Password サービスアカウント
- ユーザー認証
- 1Password Connect。今のところ、1Password/connect-sdk-pythonを使用してください。
📖 詳細はこちら