1Password JavaScript SDK
1Passwordマニュアル｜JavaScript SDKを使用して、プログラムで1Passwordの秘密にアクセスする方法を説明し、安全な統合を構築しましょう。
Written by Tomoyuki Kawashiri
Updated at July 23rd, 2025
1Password JavaScript SDK
1Password の秘密にプログラムでアクセスする統合を構築します。
🚀 始める
プロジェクトで 1Password JavaScript 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 JavaScript SDK をインストールします。 ## NPM
- npm install @1password/sdk ## PNPM
- pnpm add @1password/sdk ## Yarn
- yarn add @1password/sdk
- プロジェクトで JavaScript SDK を使用します。
import { createClient } from "@1password/sdk";
// Creates an authenticated client.
const client = await createClient({
auth: process.env.OP_SERVICE_ACCOUNT_TOKEN,
// Set the following to your own integration name and version.
integrationName: "My 1Password Integration",
integrationVersion: "v1.0.0",
});
// Fetches a secret.
const secret = await client.secrets.resolve("op://vault/item/field");1Password からコードにシークレットを安全に読み込むには、構文でシークレット参照 URI を使うようにしてください。op://vault/item/field
内でcreateClient()、 をintegrationNameアプリケーションの名前に設定し、 をintegrationVersionアプリケーションのバージョンに設定します。
サポートされている機能
1Password SDK は現在開発中です。次に何を希望するか、ぜひご意見をお聞かせください。賛Create票を投じるか、問題を報告してお知らせください。
アイテム管理 操
Create:
フィールドタイプ:
- APIキー
- パスワード
- 隠されたフィールド
- テキストフィールド
- 注記
- SSH 秘密鍵 (部分的にサポート: シークレット参照の解決ではサポートされていますが、アイテムのCreate/取得/更新ではまだサポートされていません)
- SSH公開鍵、指紋、鍵の種類
- ワンタイムパスワード
- URL
- ウェブサイト（ログインの提案や自動入力に使用）
- 電話番号
- クレジットカードの種類
- ファイル添付とドキュメント項目
金庫管理
ユーザーとアクセス管理
- ユーザーのプロビジョニング
- ユーザーを取得する
- ユーザーを一覧表示する
- ユーザーを停止する
- グループをCreateする
- グループメンバーシップを更新する
- 保管庫のアクセスと権限を更新する
コンプライアンスと報告
- ものみの塔の洞察
- 旅行モード
- イベント。今のところ、1Password イベント レポート API を直接使用してください。
認証
- 1Password サービスアカウント
- ユーザー認証
- 1Password Connect。今のところ、1Password/connect-sdk-jsを使用してください。
📖 詳細はこちら