管理者向けREST API

Keeper管理者向けREST APIを使用して、SIEM、CSPM、課金データを取得

概要

Keeper管理者向けREST APIでは、エンタープライズ連携向けのスコープ付きキーを発行できます。SIEM、CSPM、課金システム向けのデータの取得に利用します。

クライアント側でのデータ復号は不要で、顧客ホスト型のミドルウェアも必要ありません。

より広範なプラットフォームや管理ワークフローには、サービスモードREST APIをご利用ください。サービスモードでは、顧客ホスト型のミドルウェアサービスを通じて、コマンダーの多数の機能を利用できます。

要件

エンタープライズルート管理者権限 (APIキーの作成に必須)
APIキーの作成および管理に必要な、Keeper管理コンソールへのアクセスまたはKeeperコマンダーCLIのインストール

管理コンソールでAPIキーを管理する

Keeper管理コンソールで**[統合]** > [APIキー] に移動し、キーを作成します。

コマンダー (CLI) でAPIキーを管理する

コマンダーCLIには、public-api-key コマンドグループがあり、list、generate、revokeの各操作を実行できます。以下は、よく使用される操作の例です。

APIキーの一覧表示

# テーブル形式で表示
public-api-key list

# JSON形式でファイルに出力
public-api-key list --format json --output api_keys.json

# CSV形式でエクスポート
public-api-key list --format csv --output api_keys.csv

APIキーの生成

各キーは特定の連携専用で、その連携に関連するAPIエンドポイントにのみアクセスできます。

SIEM: SIEM / 監査イベントAPIへのアクセス許可
CSPM: リスク管理APIへのアクセス許可
BILLING: MSP課金APIへのアクセス許可

# 30日間有効のSIEMキー (読み取り)。SIEM / 監査イベントAPI向け
public-api-key generate --name "SIEM Integration" --integrations "SIEM:1" --expires 30d

# 30日間有効のCSPMキー (読み取り)。リスク管理API向け
public-api-key generate --name "CSPM Integration" --integrations "CSPM:1" --expires 30d

# 30日間有効の課金キー (読み取り)。MSP課金API向け
public-api-key generate --name "Billing Tool" --integrations "BILLING:1" --expires 30d

# 永続キー (有効期限なし) をJSON形式で出力
public-api-key generate --name "Permanent Tool" --integrations "SIEM:1" --expires never --format json --output backup_key.json

連携とアクションコード

連携: SIEM (SIEM / 監査イベントAPI)、CSPM (リスク管理API)、BILLING (MSP課金API)
アクション: 1 = READ、2 = READ_WRITE
有効期限のオプション: 24h、7d、30d、1y、never

例: --integrations "CSPM:1" はCSPM (読み取り) を意味し、リスク管理APIの呼び出しに使用します。

APIキーの取り消し

# 対話式で確認して取り消し
public-api-key revoke <token_value>

# 強制的に取り消し (確認なし)
public-api-key revoke <token_value> --force

セキュリティに関する注意事項

APIキーはパスワードと同様に扱い、定期的にローテーションしてください。
必要最小限のロールと操作に権限を制限してください。
有効期限はできるだけ短く設定し、無期限は特別な自動化用途に限って使用してください。
トークンは安全な場所 (例: Keeperボルト) に保管してください。

API仕様

前へAWS Marketplace

次へARAMイベント

最終更新 4 日前