Keeper Secrets Manager (プレビュー)
Keeper Secrets Manager は、DevOps および IT チーム向けのクラウドベースのゼロナレッジ シークレット管理プラットフォームです。 Keeper Vault に格納されているシークレット (資格情報、キー、パスワード) を安全に取得、作成、更新し、シークレットライフサイクルワークフローを自動化します。
このコネクタは、次の製品とリージョンで使用できます。
| Service | クラス | リージョン |
|---|---|---|
| コピロット スタジオ | Premium | 次を除くすべてのPower Automateリージョン: - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運営する China Cloud - 米国国防総省 (DoD) |
| ロジック アプリ | Standard | 次を除くすべての Logic Apps リージョン : - Azure Government リージョン - 中国リージョンAzure - 米国国防総省 (DoD) |
| Power Apps | Premium | 次を除くすべてのPower Appsリージョン: - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運営する China Cloud - 米国国防総省 (DoD) |
| Power Automate（パワーオートメート） | Premium | 次を除くすべてのPower Automateリージョン: - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運営する China Cloud - 米国国防総省 (DoD) |
| お問い合わせ | |
|---|---|
| 名前 | Keeper のセキュリティ サポート |
| URL | https://www.keepersecurity.com/support.html |
| sm@keepersecurity.com |
| コネクタ メタデータ | |
|---|---|
| パブリッシャー | Keeper セキュリティ - Logic Apps |
| Web サイト | https://www.keepersecurity.com |
| プライバシー ポリシー | https://www.keepersecurity.com/privacypolicy.html |
| カテゴリ | セキュリティ;IT 運用 |
Keeper Secrets Manager
開始する
Keeper Secrets Manager (KSM) は、DevOps および IT チーム向けに構築されたクラウドベースのゼロナレッジ シークレット管理プラットフォームです。 これにより、組織はプレーンテキストでシークレットを公開することなく、資格情報、API キー、証明書、およびその他の機密データを安全に格納し、プログラムでアクセスできます。
このコネクタは、Keeper Secrets Manager と Microsoft Power Automate とAzure Logic Appsを結び付け、自動化されたワークフローが Keeper Vault に格納されているシークレットを安全に取得、作成、更新できるようにします。 すべてのシークレット アクセスは、Keeper Secrets Manager SDK を介して認証され、組織がデプロイおよび制御する専用のAzure関数ミドルウェアを介してルーティングされます。
主な機能
- 必要に応じてシークレットを取得 します。ワークフロー内の資格情報をハードコーディングせずに、一意のレコード UID でシークレットをフェッチします。
- アクセス可能なすべてのシークレットとフォルダーを一覧表示 します。KSM アプリケーションにアクセス権が付与されているシークレットとフォルダー構造を列挙します。
- 新しいシークレットをプログラムで作成します。ログインタイプのシークレットは、Power Automate フローまたはロジック アプリから直接プロビジョニングします。
- 既存のシークレットを更新する - 関連のないフィールドを上書きせずに、シークレット レコードの 1 つ以上のフィールドにパッチを適用します。
- ゼロナレッジ アーキテクチャ — Keeper の SDK により、シークレット値が暗号化され、クライアント側で暗号化解除されます。Keeper も Microsoft もプレーンテキスト シークレットを見ることはありません。
- 最小特権アクセス — 構成する KSM アプリケーションによって、コネクタがアクセスできるコンテナー フォルダーが正確に決まります。
前提条件
このコネクタを使用する前に、次のものが必要です。
- Secrets Manager アドオンが有効になっている Keeper Security Enterprise アカウント。
- Keeper Vault または管理コンソールで構成され、少なくとも 1 つの共有フォルダーがアプリケーションに付与されている Keeper Secrets Manager アプリケーション。
- Keeper 管理コンソールから生成された Base64 でエンコードされた KSM 構成トークン (1 回限りの使用。パスワードとして扱います)。
- Azure Function Apps をデプロイおよび管理するためのアクセス許可を持つAzure サブスクリプション。
- Azure サブスクリプションにデプロイされた Function App Azure Keeper Secrets Manager ミドルウェアは、コネクタが通信するバックエンドです。 ワンクリック Azure テンプレートを使用してデプロイするか、azure-logic-apps リポジトリ README に従います。
- Function App ホスト キー — 接続の作成時に API キーとして使用されます。
資格情報を取得する方法
手順 1: KSM アプリケーションを構成する
- Keeper Vault にサインインします。
- Secrets Manager>Create Application に移動し、名前を付けます (例: "Power Automate コネクタ")。
- 1 つ以上のコンテナー フォルダーをアプリケーションと共有します。 これらのフォルダーは、コネクタからアクセスできるシークレットのスコープを定義します。
- [デバイスの追加] タブ>開き>構成ファイルを選択>Base64 形式を選択します。
- Base64 の値をすぐにコピーします。これは
KSM_CONFIGです。 これは 1 回限りのトークンです。紛失した場合は、新しいデバイスを追加して交換を生成します。
セキュリティに関する注意: Base64 構成値には、アプリケーションの暗号化された資格情報が含まれます。 パスワードのように扱います。 共有したり、ソース管理にコミットしたりしないでください。
手順 2: Azure関数ミドルウェアをデプロイする
ミドルウェアを Azure サブスクリプションにデプロイします。
- ワンクリックでのデプロイ:Azureへのデプロイ
- 手動デプロイ:azure-logic-apps README に従う
デプロイ中に、 KSM_CONFIG Base64 の値を ksmConfig パラメーターに貼り付けます。 デプロイ後、Function App の URL (例: yourfunctionapp.azurewebsites.net) を書き留めます。
手順 3: Function App ホスト キーを取得する
- Azure ポータルで、デプロイした関数アプリを開きます。
- 左側のメニューで、[ アプリ キー ] を選択します ([関数] セクションの下)。
- 最小特権アクセスの場合は、[ + 新しいホスト キー] をクリックし、
connector名前を付けて、[ OK] をクリックします。 - 生成された値をコピーします。これは、コネクタ接続の作成時に使用される Function App ホスト キー です。
手順 4: 接続を作成する
Keeper Secrets Manager コネクタを初めてワークフローに追加する場合:
-
Function App の URL を入力します。ホスト名は、
https://プレフィックス (例:yourfunctionapp.azurewebsites.net) なしで入力します。 - 手順 3 で取得した Function App Host キー を入力します。
- Create をクリックしてください。 ワークフロー内の後続のアクションはすべて、この接続を再利用します。
サポートされている操作
| Operation | Description |
|---|---|
| シークレットの一覧表示 | UID、タイトル、型、フォルダー UID など、KSM アプリケーションからアクセスできるすべてのシークレットを返します。 |
| シークレットを入手 | ログイン、パスワード、URL、メモ、ユーザー設定フィールドなど、UID によって 1 つのシークレットの完全な詳細を取得します。 |
| シークレットの作成 | 指定した共有フォルダーに新しいログインタイプのシークレットを作成します。 |
| シークレットの更新 | 既存のシークレットの 1 つ以上のフィールドを更新します。 指定されたフィールドのみが変更されます。省略されたフィールドは変更されません。 |
| フォルダーの一覧表示 | UID、名前、親フォルダー UID など、KSM アプリケーションからアクセスできるすべてのフォルダーを返します。 |
既知の問題と制限事項
-
作成専用のログイン レコードの種類: シークレットの作成操作では、
loginレコードの種類がサポートされます。 他の Keeper レコードの種類 (SSH キー、データベース資格情報など) は、現在、このコネクタを使用した作成ではサポートされていません。 -
1 回限り構成トークン:
KSM_CONFIGBase64 トークンは、初期バインディングに 1 回だけ使用できます。 その後、ミドルウェアは、Azure関数アプリケーション設定として格納された派生構成を使用します。 ローテーションするには、管理コンソールから新しいデバイス トークンを生成し、AzureでKSM_CONFIGアプリケーション設定を更新します。 - フォルダーの作成はサポートされていません。 フォルダーは、Keeper Vault または管理コンソールで作成する必要があります。 このコネクタでは、フォルダーの作成はサポートされていません。
-
共有フォルダーの要件: シークレットの作成操作の
folder_uidパラメーターは、KSM アプリケーションが明示的に書き込みアクセスできる共有フォルダーを参照する必要があります。 共有されていないフォルダーまたはアクセスできないフォルダーを使用すると、400 エラーが返されます。 - 添付ファイルが返されない: 添付ファイルを含むシークレットが一覧表示されますが、添付ファイルのバイナリ コンテンツには、このコネクタからアクセスできません。
- コールド スタート待機時間:Azure Function App が従量課金プランで実行されている場合、アイドル期間後の最初の要求でコールド スタート待機時間 (通常は 2 ~ 5 秒) が発生する可能性があります。
- レート制限:要求スループットは、Keeper Security サブスクリプション レベルと、Azure Function App のホスティング プラン (従量課金、Premium、または専用) によって制御されます。
Support
このコネクタに関するサポートについては、 Keeper セキュリティ サポート または電子メール sm@keepersecurity.comにお問い合わせください。
Azure関数ミドルウェアに関する問題については、azure-logic-apps リポジトリを参照してください。
接続を作成する
コネクタでは、次の認証の種類がサポートされています。
| デフォルト | 接続を作成するためのパラメーター。 | すべてのリージョン | 共有できません |
デフォルト
適用対象: すべてのリージョン
接続を作成するためのパラメーター。
これは共有可能な接続ではありません。 電源アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
| 名前 | タイプ | Description | 必須 |
|---|---|---|---|
| 関数アプリの URL | 文字列 | デプロイされた Azure Function App のベース URL (例: yourfunctionapp.azurewebsites.net)。 | True |
| Function App Host Key | securestring | Azure Function App のホスト キーまたは関数キー。 これは、Function App > App キーのAzure ポータルから取得します。 | True |
アクション
| シークレットの一覧表示 (プレビュー) |
構成された Keeper Secrets Manager アプリケーションからアクセスできるすべてのシークレット (レコード) の一覧を返します。 各エントリには、レコード UID、タイトル、種類、およびフォルダー UID が含まれています。 |
| シークレットの作成 (プレビュー) |
指定した Keeper Vault フォルダーに新しいログインタイプのシークレット (レコード) を作成します。 タイトル、ログイン、パスワード、URL、および省略可能なメモを指定します。 |
| シークレットの更新 (プレビュー) |
UID によって識別される既存のシークレットを更新します。 タイトル、ログイン、パスワード、URL、メモの任意の組み合わせを変更できます。 要求本文に含めるフィールドのみが更新されます。 |
| シークレットを取得する (プレビュー) |
一意のレコード UID を使用して、1 つのシークレットの完全な詳細を取得します。 すべてのレコードの種類のフィールド (ログイン、パスワード、URL、ホスト、keyPair、paymentCard など) は、ノート、ユーザー設定フィールド、およびフォルダー情報と共にフラットな最上位キーとして返されます。 |
| フォルダーの一覧表示 (プレビュー) |
構成済みの Keeper Secrets Manager アプリケーションからアクセスできるすべてのフォルダーの一覧を返します。 各フォルダーには、UID、名前、親フォルダー UID が含まれます。 |
シークレットの一覧表示 (プレビュー)
構成された Keeper Secrets Manager アプリケーションからアクセスできるすべてのシークレット (レコード) の一覧を返します。 各エントリには、レコード UID、タイトル、種類、およびフォルダー UID が含まれています。
返品
- アイテム
- SecretSummaryArray
シークレットの作成 (プレビュー)
指定した Keeper Vault フォルダーに新しいログインタイプのシークレット (レコード) を作成します。 タイトル、ログイン、パスワード、URL、および省略可能なメモを指定します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
フォルダー UID
|
folder_uid | True | string |
シークレットが作成されるターゲット フォルダーの UID。 アクセス可能な共有フォルダーである必要があります。 |
|
Title
|
title | True | string |
新しいシークレットの表示タイトル。 |
|
ログイン
|
login | string |
保存するログインまたはユーザー名。 |
|
|
パスワード
|
password | string |
保存するパスワード。 |
|
|
URL
|
url | string |
シークレットに関連付ける URL。 |
|
|
メモ
|
notes | string |
シークレットに添付するオプションの自由形式のノート。 |
返品
- Body
- CreateSecretResponse
シークレットの更新 (プレビュー)
UID によって識別される既存のシークレットを更新します。 タイトル、ログイン、パスワード、URL、メモの任意の組み合わせを変更できます。 要求本文に含めるフィールドのみが更新されます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
シークレット UID
|
uid | True | string |
更新するシークレットの一意識別子 (UID)。 |
|
Title
|
title | string |
シークレットの新しい表示タイトル。 |
|
|
ログイン
|
login | string |
新しいログインまたはユーザー名。 |
|
|
パスワード
|
password | string |
新しいパスワード。 |
|
|
URL
|
url | string |
シークレットに関連付ける新しい URL。 |
|
|
メモ
|
notes | string |
新しい自由形式のノート。 |
返品
- Body
- UpdateSecretResponse
シークレットを取得する (プレビュー)
一意のレコード UID を使用して、1 つのシークレットの完全な詳細を取得します。 すべてのレコードの種類のフィールド (ログイン、パスワード、URL、ホスト、keyPair、paymentCard など) は、ノート、ユーザー設定フィールド、およびフォルダー情報と共にフラットな最上位キーとして返されます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
シークレット UID
|
uid | True | string |
取得するシークレットの一意識別子 (UID)。 |
返品
ログイン資格情報、メモ、フォルダー情報など、シークレット レコードの完全な詳細。
- Body
- SecretDetail
フォルダーの一覧表示 (プレビュー)
構成済みの Keeper Secrets Manager アプリケーションからアクセスできるすべてのフォルダーの一覧を返します。 各フォルダーには、UID、名前、親フォルダー UID が含まれます。
返品
- アイテム
- FolderArray
定義
SecretSummary
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
シークレット UID
|
uid | string |
シークレット レコードの一意識別子。 |
|
Title
|
title | string |
シークレットの表示タイトル。 |
|
レコードの種類
|
type | string |
レコードの種類 (ログイン、sshKeys、databaseCredentials など)。 |
|
フォルダー UID
|
folder_uid | string |
このシークレットを含むフォルダーの UID。 |
SecretSummaryArray
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
アイテム
|
SecretSummary |
SecretDetail
ログイン資格情報、メモ、フォルダー情報など、シークレット レコードの完全な詳細。
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
シークレット UID
|
uid | string |
シークレット レコードの一意識別子。 |
|
Title
|
title | string |
シークレットの表示タイトル。 |
|
レコードの種類
|
type | string |
レコードの種類 (login、sshKeys、databaseCredentials、bankCard など)。 |
|
メモ
|
notes | string |
シークレットに関連付けられている自由形式のノート。 |
|
ログイン
|
login | string |
シークレットに格納されているログインまたはユーザー名。 |
|
パスワード
|
password | string |
シークレットに格納されているパスワード。 |
|
URL
|
url | string |
シークレットに関連付けられている URL。 |
|
フォルダー UID
|
folder_uid | string |
このシークレットを含むフォルダーの UID。 |
|
編集可能
|
is_editable | boolean |
現在のアプリケーションがこのシークレットを編集する権限を持っているかどうか。 |
CreateSecretResponse
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
メッセージ
|
message | string |
人間が判読できる成功メッセージ。 |
|
Title
|
title | string |
作成されたシークレットのタイトル。 |
|
フォルダー UID
|
folder_uid | string |
シークレットが作成されたフォルダーの UID。 |
|
新しいシークレット UID
|
response | string |
新しく作成されたシークレット レコードの UID。 |
UpdateSecretResponse
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
メッセージ
|
message | string |
人間が判読できる成功メッセージ。 |
Folder
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
フォルダー UID
|
uid | string |
フォルダーの一意識別子。 |
|
フォルダー名
|
name | string |
フォルダーの表示名です。 |
|
親フォルダー UID
|
parent_uid | string |
親フォルダーの UID (ルート レベル フォルダーの場合は空)。 |
FolderArray
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
アイテム
|
Folder |