Akeyless を Google SecOps と統合する

このドキュメントでは、Akeyless を Google Security Operations と統合する方法について説明します。

ユースケース

Akeyless の統合では、Google SecOps の機能を使用して次のユースケースをサポートします。

  • 統合認証情報を同期する: Akeyless に保存されているシークレットを使用して、Google SecOps 統合インスタンス、コネクタ、ジョブ全体で認証情報と機密パラメータを自動的に更新します。

  • ハンドブックでシークレットを取得する: ハンドブックの実行中に Akeyless から静的シークレットまたは特定のシークレット バージョンをオンデマンドで取得し、外部サービスで認証します。

  • 認証情報のローテーションを自動化する: パラメータを latest シークレット バージョンにマッピングすることで、ローテーションされた API キー、トークン、パスワードを Akeyless から Google SecOps の統合、コネクタ、ジョブに伝播し、認証情報の有効期限切れによる中断を防ぎます。

  • バージョン固定で認証情報の更新を制御する: Akeyless の特定のシークレット バージョンに統合、コネクタ、ジョブ パラメータを固定して、認証情報の変更を検証したり、必要に応じて以前のバージョンにロールバックしたりします。

  • ワークフローでハードコードされたシークレットを排除する: 機密性の高い認証情報を、ハンドブックの入力やカスタム スクリプトに直接埋め込むのではなく、Akeyless で一元管理することで、SOC ワークフロー全体で認証情報の漏洩を減らします。

始める前に

Google SecOps プラットフォームで統合を構成する前に、次のものが揃っていることを確認してください。

  • API キー認証情報: 認証用の Akeyless アクセス ID とアクセスキー。

    詳細については、Akeyless API キー認証をご覧ください。

  • アクセス権限: Google SecOps が取得するシークレットに対して認証方法に付与された読み取り権限。

    詳細については、Akeyless ロールベース アクセス制御（RBAC）をご覧ください。

  • ネットワーク接続: Google SecOps インスタンスまたはリモート エージェントから Akeyless API Gateway URL へのネットワーク アクセス。

統合のパラメータ

Akeyless の統合には、次のパラメータが必要です。

パラメータ 説明
API Gateway URL

省略可。

Akeyless API Gateway の URL。

デフォルト値は https://api.akeyless.io です。
Access ID

必須。

Akeyless API キー認証方法のアクセス ID。
Access Key

必須。

Akeyless アクセス ID に関連付けられたアクセスキー。
Verify SSL

必須。

選択すると、統合によって Akeyless サーバーに接続するときに SSL 証明書が検証されます。

デフォルトで有効になっています。

Google SecOps で統合を構成する方法については、統合を構成するをご覧ください。

必要に応じて、後の段階で変更できます。統合インスタンスを構成すると、ハンドブックで使用できるようになります。複数のインスタンスを構成してサポートする方法の詳細については、複数のインスタンスのサポートをご覧ください。

操作

アクションの詳細については、 デスクから保留中のアクションに対応すると手動による対策を実行するをご覧ください。

シークレット値を取得する

Get Secret Value アクションを使用して、ハンドブックで使用するシークレット値を Akeyless から取得します。

このアクションは Google SecOps エンティティに対しては実行されません。

アクションへの入力

Get Secret Value アクションには、次のパラメータが必要です。

パラメータ 説明
Secret Name

必須。

Akeyless から取得するシークレットの名前またはパス。

最新バージョンを取得するには、SECRET_NAME または SECRET_NAME:latest を入力します。

特定のバージョンを取得するには、SECRET_NAME:VERSION_NUMBER を入力します。ここで、VERSION_NUMBER は正の整数です（例: /prod/api-key:2）。

アクションの出力

Get Secret Value アクションは、次の出力を提供します。

アクションの出力タイプ 対象
ケースウォールのアタッチメント 利用不可
ケースウォールのリンク 利用不可
ケースウォール テーブル 利用不可
拡充テーブル 利用不可
JSON の結果 利用可能
出力メッセージ 利用可能
スクリプトの結果 利用可能
JSON の結果

次の例は、シークレット値を取得アクションを使用したときに受信した JSON 結果の出力です。

{
  "secret_name": "/secops/integrations/example-api-key",
  "version": "latest",
  "secret_value": "EXAMPLE_SECRET_VALUE"
}
出力メッセージ

ケースウォールで、シークレット値を取得アクションにより、次の出力メッセージが表示されます。

出力メッセージ メッセージの説明
Successfully retrieved secret 'SECRET_NAME' (version: 'SECRET_VERSION') from Akeyless Security. アクションが成功しました。
Failed to retrieve secret 'SECRET_NAME' (version: 'SECRET_VERSION') from Akeyless Security. Reason: ERROR_REASON

操作に失敗しました。

シークレットのパスとバージョンが Akeyless に存在すること、および認証情報にシークレットへの読み取りアクセス権があることを確認します。
Error executing action 'Get Secret Value'. Reason: Invalid credential mapping format for value 'SECRET_NAME'. Expected format: 'secret_name' or 'secret_name:version' (where version is a positive integer or 'latest').

操作に失敗しました。

Secret Name パラメータの形式を確認します。
スクリプトの結果

次の表に、Get Secret Value アクションを使用した場合のスクリプト結果の出力値を示します。

スクリプトの結果名 値
is_success true または false

Ping

Ping アクションを使用して、Akeyless サーバーへの接続をテストします。

このアクションは Google SecOps エンティティに対しては実行されません。

アクションへの入力

なし

アクションの出力

Ping アクションは、次の出力を提供します。

アクションの出力タイプ 対象
ケースウォールのアタッチメント 利用不可
ケースウォールのリンク 利用不可
ケースウォール テーブル 利用不可
拡充テーブル 利用不可
JSON の結果 利用不可
出力メッセージ 利用可能
スクリプトの結果 利用可能
出力メッセージ

[ケースウォール] で、[Ping] アクションを実行すると、次の出力メッセージが表示されます。

出力メッセージ メッセージの説明
Successfully connected to the Akeyless server with the provided connection parameters! アクションが成功しました。
Failed to connect to the Akeyless server! Reason: ERROR_REASON

操作に失敗しました。

API Gateway URL、Access ID、Access Key、SSL の設定を確認します。
スクリプトの結果

次の表に、Ping アクションを使用した場合のスクリプト結果の出力値を示します。

スクリプトの結果名 値
is_success true または false

ジョブ

ジョブの詳細については、 新しいジョブを構成すると 高度なスケジューリングをご覧ください。

統合認証情報の同期ジョブ

Sync Integration Credentials Job を使用して、Akeyless に保存されているシークレットを、構成済みの Google SecOps 統合インスタンス、コネクタ、ジョブと自動的に同期します。

ジョブ パラメータ

同期統合認証情報ジョブには、次のパラメータが必要です。

パラメータ 説明
API Gateway URL

省略可。

Akeyless API Gateway の URL。

デフォルト値は https://api.akeyless.io です。
Access ID

必須。

Akeyless API キー認証方法のアクセス ID。
Access Key

必須。

Akeyless アクセス ID に関連付けられたアクセスキー。
Verify SSL

必須。

選択すると、統合によって Akeyless サーバーに接続するときに SSL 証明書が検証されます。

デフォルトで有効になっています。
Environment Name

必須。

ターゲットの統合インスタンス、コネクタ、ジョブが構成されている Google SecOps 環境。

デフォルト値は Default Environment です。
Credential Mapping

必須。

ターゲット統合インスタンス、コネクタ、ジョブを、パラメータ値を含む Akeyless シークレットにマッピングする JSON または YAML 辞書。

integration_instances、connectors、jobs のいずれかのキーに、マッピングされたパラメータを 1 つ以上含めます。

例については、Credential Mapping の例をご覧ください。

デフォルト値は {"integration_instances": {"Integration_Instance_Name": {"Parameter_Name": "Secret_Name"}}} です。

例 Credential Mapping

次の例は、Credential Mapping パラメータで統合インスタンス、コネクタ、ジョブのパラメータをマッピングする方法を示しています。

{
  "integration_instances": {
    "VirusTotal_Prod": {
      "API Key": "/secops/prod/virustotal-api-key"
    },
    "Jira_Instance_1": {
      "API Token": "/secops/prod/jira-api-token:2"
    }
  },
  "connectors": {
    "CrowdStrike Falcon Alerts Connector": {
      "Client Secret": "/secops/prod/crowdstrike-client-secret:latest"
    }
  },
  "jobs": {
    "ServiceNow Sync Closed Cases": {
      "Password": "/secops/prod/servicenow-password:1"
    }
  }
}

さらにサポートが必要な場合 コミュニティ メンバーや Google SecOps のプロフェッショナルから回答を得ることができます。