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 を使うには:

  1. サービス アカウントをCreateし、SDK で使うアイテムがSaveされている保管庫に適切な権限を付与します。

  2. サービス アカウント トークンをプロビジョニングします。環境からトークンをプロビジョニングすることをお勧めします。例えば、トークンをOP_SERVICE_ACCOUNT_TOKEN環境変数にエクスポートするには、次のようにします。 macOS または Linux export OP_SERVICE_ACCOUNT_TOKEN=<your-service-account-token>

    ウィンドウズ $Env:OP_SERVICE_ACCOUNT_TOKEN = "<your-service-account-token>"

  3. プロジェクトに 1Password Python SDK をインストールします。 pip install onepassword-sdk

  4. プロジェクトで 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する ( #36 )

  • 金庫を更新する

  • 金庫を削除する

  • 保管庫の一覧

ユーザーとアクセス管理

  • ユーザーのプロビジョニング

  • ユーザーを取得する

  • ユーザーを一覧表示する

  • ユーザーを停止する

  • グループをCreateする

  • グループメンバーシップを更新する

  • 保管庫のアクセスと権限を更新する

コンプライアンスと報告

認証

📖 詳細はこちら