統合

手順

1. Configuration → Services に移動します。
2. Add Services を選択します。
3. General Settings で、Name と Description を指定します。
4. Integration Setting の Integration Type ドロップダウンメニューで Events v2 API を選択した状態で、Use our API Directly をクリックします。
5. Incident Settings で、Escalation Policy を選択し、通知設定とインシデントタイムアウトを設定します。
6. Incident Behavior と Alert Grouping のデフォルト設定を受け入れるか、必要に応じて設定します。
7. Add Service をクリックします。
8. Service Details ページで、Integration Key をメモします。

手順

1. RHACS ポータルで、Platform Configuration → Integrations に移動します。
2. Notifier Integrations セクションまで下にスクロールして、PagerDuty を選択します。
3. New Integration (add アイコン) をクリックします。
4. Integration Name の名前を入力します。
5. PagerDuty integration key フィールドに統合キーを入力します。
6. Test (checkmark アイコン) をクリックして、PagerDuty との統合が機能していることを確認します。
7. Create (save アイコン) をクリックして、設定を作成します。

手順

1. RHACS ポータルで、Platform Configuration → Policies に移動します。
2. アラートの送信先となるポリシーを 1 つ以上選択します。
3. Bulk actions で Enable notification を選択します。

4. Enable notification ウィンドウで、PagerDuty notifier を選択します。

   注記

   他の統合を設定していない場合、システムは通知機能が設定されていないメッセージが表示します。

5. Enable をクリックします。

前提条件

1. Webhook を作成するには、管理者アカウントまたは権限を持つユーザーアカウントが必要。

手順

1. 新しい Slack アプリケーションを作成します。

   注記

   既存の Slack アプリケーションを使用する場合は、https://api.slack.com/apps にアクセスしてアプリケーションを選択してください。

   1. https://api.slack.com/apps/new に移動します。
   2. App Name を入力し、Development Slack Workspace を選択してアプリケーションをインストールします。
   3. Create App をクリックします。
2. 設定ページの Basic Information セクションで、Incoming Webhooks を選択します (Add features and functionality の下)。
3. Activate Incoming Webhooks トグルをオンにします。
4. Add New Webhook to Workspace 選択します。
5. アプリケーションが投稿する channel を選択し、Authorize を選択します。ページが更新され、アプリケーションの設定ページに戻ります。
6. Webhook URLs for Your Workspace セクションにある Webhook URL をコピーします。

手順

1. RHACS ポータルで、Platform Configuration → Integrations に移動します。
2. Notifier Integrations セクションまで下にスクロールして、Slack を選択します。
3. New Integration (add アイコン) をクリックします。
4. Integration Name の名前を入力します。
5. 生成された Webhook URL を Default Slack Webhook フィールドに入力します。
6. Test (checkmark アイコン) を選択して、Slack との統合が機能していることをテストします。
7. Create (save アイコン) を選択して、設定を作成します。

手順

1. RHACS ポータルで、Platform Configuration → Policies に移動します。
2. アラートの送信先となるポリシーを 1 つ以上選択します。
3. Bulk actions で Enable notification を選択します。

4. Enable notification ウィンドウで、Slack notifier を選択します。

   注記

   他の統合を設定していない場合、システムは通知機能が設定されていないメッセージが表示します。

5. Enable をクリックします。

手順

1. RHACS ポータルで、Platform Configuration → Integrations に移動します。
2. Notifier Integrations セクションまでスクロールダウンし、Generic Webhook を選択します。
3. New integration をクリックします。
4. Integration name の名前を入力します。
5. Endpoint フィールドに Webhook の URL を入力します。

6. Webhook レシーバーが信頼できない証明書を使用している場合は、CA certificate フィールドに CA 証明書を入力します。それ以外の場合は、空白のままにします。

   注記

   Webhook レシーバーが使用するサーバー証明書は、エンドポイント DNS 名に対して有効である必要があります。Skip TLS verification をクリックして、この検証を無視できます。Red Hat は、TLS 検証をオフにすることを推奨していません。TLS 検証がないと、意図しない受信者によってデータが傍受される可能性があります。

7. オプション: Enable audit logging をクリックして、Red Hat Advanced Cluster Security for Kubernetes で行われたすべての変更に関するアラートを受信します。

   注記

   Red Hat は、アラートと監査ログに別々の Webhook を使用して、これらのメッセージを異なる方法で処理することを提案しています。

8. Webhook レシーバーで認証するには、次のいずれかの詳細を入力します。

   • 基本 HTTP 認証の ユーザー名 と パスワード
   • カスタム ヘッダー、例: Authorization: Bearer <access_token>
9. Extra fields を使用して、Red Hat Advanced Cluster Security for Kubernetes が送信する JSON オブジェクトに追加のキーと値のペアを含めます。たとえば、Webhook レシーバーが複数のソースからのオブジェクトを受け入れる場合、追加フィールドとして "source": "rhacs" を追加し、この値でフィルター処理して、Red Hat Advanced Cluster Security for Kubernetes からのすべてのアラートを識別できます。
10. Test を選択してテストメッセージを送信し、一般的な Webhook との統合が機能していることを確認します。
11. Save を選択して設定を作成します。

手順

1. RHACS ポータルで、Platform Configuration → Policies に移動します。
2. アラートの送信先となるポリシーを 1 つ以上選択します。
3. Bulk actions で Enable notification を選択します。

4. Enable notification ウィンドウで、webhook notifier を選択します。

   注記

   他の統合を設定していない場合、システムは通知機能が設定されていないメッセージが表示します。

5. Enable をクリックします。

手順

1. RHACS ポータルで、Platform Configuration → Integrations に移動します。
2. Notifier Integrations セクションまでスクロールダウンし、Generic Webhook を選択します。
3. New integration をクリックします。
4. Integration name の名前を入力します。
5. Endpoint フィールドに Webhook の URL を入力します。

6. Webhook レシーバーが信頼できない証明書を使用している場合は、CA certificate フィールドに CA 証明書を入力します。それ以外の場合は、空白のままにします。

   注記

   Webhook レシーバーが使用するサーバー証明書は、エンドポイント DNS 名に対して有効である必要があります。Skip TLS verification をクリックして、この検証を無視できます。Red Hat は、TLS 検証をオフにすることを推奨していません。TLS 検証がないと、意図しない受信者によってデータが傍受される可能性があります。

7. オプション: Enable audit logging をクリックして、Red Hat Advanced Cluster Security for Kubernetes で行われたすべての変更に関するアラートを受信します。

   注記

   Red Hat は、アラートと監査ログに別々の Webhook を使用して、これらのメッセージを異なる方法で処理することを提案しています。

8. Webhook レシーバーで認証するには、次のいずれかの詳細を入力します。

   • 基本 HTTP 認証の ユーザー名 と パスワード
   • カスタム ヘッダー、例: Authorization: Bearer <access_token>
9. Extra fields を使用して、Red Hat Advanced Cluster Security for Kubernetes が送信する JSON オブジェクトに追加のキーと値のペアを含めます。たとえば、Webhook レシーバーが複数のソースからのオブジェクトを受け入れる場合、追加フィールドとして "source": "rhacs" を追加し、この値でフィルター処理して、Red Hat Advanced Cluster Security for Kubernetes からのすべてのアラートを識別できます。
10. Test を選択してテストメッセージを送信し、一般的な Webhook との統合が機能していることを確認します。
11. Save を選択して設定を作成します。

手順

1. RHACS ポータルで、Platform Configuration → Policies に移動します。
2. アラートの送信先となるポリシーを 1 つ以上選択します。
3. Bulk actions で Enable notification を選択します。

4. Enable notification ウィンドウで、webhook notifier を選択します。

   注記

   他の統合を設定していない場合、システムは通知機能が設定されていないメッセージが表示します。

5. Enable をクリックします。

手順

1. RHACS ポータルで、Platform Configuration → Integrations に移動します。
2. Notifier Integrations セクションまでスクロールダウンし、Generic Webhook を選択します。
3. New integration をクリックします。
4. Integration name の名前を入力します。
5. Endpoint フィールドに Webhook の URL を入力します。

6. Webhook レシーバーが信頼できない証明書を使用している場合は、CA certificate フィールドに CA 証明書を入力します。それ以外の場合は、空白のままにします。

   注記

   Webhook レシーバーが使用するサーバー証明書は、エンドポイント DNS 名に対して有効である必要があります。Skip TLS verification をクリックして、この検証を無視できます。Red Hat は、TLS 検証をオフにすることを推奨していません。TLS 検証がないと、意図しない受信者によってデータが傍受される可能性があります。

7. オプション: Enable audit logging をクリックして、Red Hat Advanced Cluster Security for Kubernetes で行われたすべての変更に関するアラートを受信します。

   注記

   Red Hat は、アラートと監査ログに別々の Webhook を使用して、これらのメッセージを異なる方法で処理することを提案しています。

8. Webhook レシーバーで認証するには、次のいずれかの詳細を入力します。

   • 基本 HTTP 認証の ユーザー名 と パスワード
   • カスタム ヘッダー、例: Authorization: Bearer <access_token>
9. Extra fields を使用して、Red Hat Advanced Cluster Security for Kubernetes が送信する JSON オブジェクトに追加のキーと値のペアを含めます。たとえば、Webhook レシーバーが複数のソースからのオブジェクトを受け入れる場合、追加フィールドとして "source": "rhacs" を追加し、この値でフィルター処理して、Red Hat Advanced Cluster Security for Kubernetes からのすべてのアラートを識別できます。
10. Test を選択してテストメッセージを送信し、一般的な Webhook との統合が機能していることを確認します。
11. Save を選択して設定を作成します。

手順

1. RHACS ポータルで、Platform Configuration → Policies に移動します。
2. アラートの送信先となるポリシーを 1 つ以上選択します。
3. Bulk actions で Enable notification を選択します。

4. Enable notification ウィンドウで、webhook notifier を選択します。

   注記

   他の統合を設定していない場合、システムは通知機能が設定されていないメッセージが表示します。

5. Enable をクリックします。

手順

1. Sumo Logic ホームページにログインし、Setup Wizard を選択します。
2. カーソルを Set Up Streaming Data に移動し、Get Started を選択します。
3. データ型の選択ページで、Your Custom App を選択します。
4. コレクションの設定ページで、HTTP Source を選択します。
5. Source Category の名前 (たとえば、rhacs) を入力し、Continue をクリックします。
6. 生成された URL を Copy します。

手順

1. RHACS ポータルで、Platform Configuration → Integrations に移動します。
2. Notifier Integrations セクションまで下にスクロールして、Sumo Logic を選択します。
3. New Integration (add アイコン) をクリックします。
4. Integration Name の名前を入力します。
5. 生成された HTTP URL を HTTP Collector Source Address フィールドに入力します。
6. Test (checkmark アイコン) をクリックして、Sumo Logic との統合が機能していることをテストします。
7. Create (save アイコン) をクリックして、設定を作成します。

手順

1. RHACS ポータルで、Platform Configuration → Policies に移動します。
2. アラートの送信先となるポリシーを 1 つ以上選択します。
3. Bulk actions で Enable notification を選択します。

4. Enable notification ウィンドウで、Sumo Logic notifier を選択します。

   注記

   他の統合を設定していない場合、システムは通知機能が設定されていないメッセージが表示します。

5. Enable をクリックします。

1. Sumo Logic ホームページにログインし、Log Search をクリックします。
2. 検索ボックスに _sourceCategory=rhacs と入力します。Sumo Logic の設定時に入力したものと同じ Source Category 名を使用してください。
3. 時間を選択し、Start をクリックします。

手順

1. RHACS ポータルで、Platform Configuration → Integrations に移動します。
2. External backups セクションまで下にスクロールして、Google Cloud Storage を選択します。
3. New Integration (add アイコン) をクリックします。
4. Integration Name の名前を入力します。
5. Backups To Retain ボックスに、保持するバックアップの数を入力します。
6. Schedule で、バックアップの頻度 (毎日または毎週) とバックアッププロセスを実行する時間を選択します。
7. バックアップを保存する Bucket 名を入力します。
8. Service Account JSON フィールドに、サービスアカウントのキーファイルのコンテンツを入力します。
9. Test (checkmark アイコン) を選択して、GCS との統合が機能していることを確認します。
10. Create (save アイコン) を選択して、設定を作成します。

手順

1. RHACS ポータルで、Platform Configuration → Integrations に移動します。
2. Notifier Integrations セクションまでスクロールダウンし、Syslog を選択します。
3. New Integration (add アイコン) をクリックします。
4. Integration Name の名前を入力します。
5. Logging Facility の値を local0 から local7 まで選択します。
6. Receiver Host アドレスと Receiver Port 番号を入力します。
7. TLS を使用している場合は、Use TLS トグルをオンにします。
8. 信頼されていない証明書を使用している syslog レシーバーの場合は、Disable TLS Certificate Validation (Insecure) トグルをオンにします。それ以外の場合は、このトグルをオフのままにします。

9. Add new extra field をクリックして、追加フィールドを追加します。たとえば、syslog レシーバーが複数のソースからオブジェクトを受け入れる場合は、Key フィールドと Value フィールドに source と rhacs を入力します。

   syslog レシーバーのカスタム値を使用してフィルタリングし、RHACS からのすべてのアラートを識別できます。

10. Test (checkmark アイコン) を選択してテストメッセージを送信し、汎用 Webhook との統合が機能していることを確認します。
11. Create (save アイコン) を選択して、設定を作成します。

手順

1. RHACS ポータルで、Platform Configuration → Integrations に移動します。
2. External backups セクションまで下にスクロールして、Amazon S3 を選択します。
3. New Integration (add アイコン) をクリックします。
4. Integration Name の名前を入力します。
5. Backups To Retain ボックスに、保持するバックアップの数を入力します。
6. Schedule で、バックアップの頻度を日次または週次として選択し、バックアッププロセスを実行する時間を選択します。
7. バックアップを保存する Bucket 名を入力します。
8. バックアップを特定のフォルダー構造に保存する場合は、必要に応じて Object Prefix を入力します。詳細は、Amazon ドキュメントのトピック オブジェクトメタデータの操作 を参照してください。
9. 非公開の S3 インスタンスを使用している場合は、バケットの Endpoint を入力します。それ以外の場合は、空白のままにします。
10. バケットの Region を入力します。
11. Use Container IAM Role トグルをオンにするか、Access Key ID と Secret Access Key を入力します。
12. Test (checkmark アイコン) を選択して、AmazonS3 との統合が機能していることを確認します。
13. Create (save アイコン) を選択して、設定を作成します。

手順

1. RHACS ポータルで、Platform Configuration → Integrations に移動します。
2. External backups セクションで、AmazonS3 をクリックします。
3. バックアップを実行する S3 バケットの統合名を選択します。
4. Trigger Backup をクリックします。

手順

1. Adding vulnerability and threat sources to Cloud Security Command Center ガイドに従い、Red Hat Advanced Cluster Security for Kubernetes を信頼できるクラウド SCC ソースとして追加します。Red HatAdvanced Cluster Security for Kubernetes の統合のために Google Cloud が作成する Source ID をメモしておきます。登録後にソース ID が表示されない場合は、Cloud SCC Security Sources page で確認できます。
2. 前の手順で作成したサービスアカウント、または使用した既存のアカウントのキーを作成します。詳細については creating and managing service account keys Google Cloud のガイドを参照してください。

手順

1. RHACS ポータルで、Platform Configuration → Integrations に移動します。
2. Notifier Integrations セクションまで下にスクロールして、Google Cloud SCC を選択します。
3. New Integration (add アイコン) をクリックします。
4. Integration Name の名前を入力します。
5. Cloud SCC Source ID と Service Account Key (JSON) を入力します。
6. Create (save アイコン) を選択して、設定を作成します。

手順

1. RHACS ポータルで、Platform Configuration → Policies に移動します。
2. アラートの送信先となるポリシーを 1 つ以上選択します。
3. Bulk actions で Enable notification を選択します。

4. Enable notification ウィンドウで、Google Cloud SCC notifier を選択します。

   注記

   他の統合を設定していない場合、システムは通知機能が設定されていないメッセージが表示します。

5. Enable をクリックします。

1. Splunk に新しい HTTP イベントコレクターを追加し、トークン値を取得します。
2. トークン値を使用して、Red Hat Advanced Cluster Security for Kubernetes で通知を設定します。
3. 通知を送信するポリシーを特定し、それらのポリシーの通知設定を更新します。

手順

1. RHACS ポータルで、Platform Configuration → Integrations に移動します。
2. Image Integrations セクションで、Clair v4 を選択します。
3. New integration をクリックします。

4. 以下のフィールドに詳細を記入します。

   1. Integration name: インテグレーションの名前。
   2. Endpoint: スキャナーのアドレス。
5. オプション: レジストリーへの接続時に TLS 証明書を使用していない場合は、Disable TLS certificate validation (insecure) を選択します。
6. (オプション) Test をクリックして、選択したレジストリーとの統合が機能していることをテストします。
7. Save をクリックします。

手順

1. RHACS ポータルで、Platform Configuration → Integrations に移動します。

2. Image Integrations セクションで、Google Container Registry を選択します。

   Configure image integration ボックスが開きます。

3. New Integration をクリックします。

4. 以下のフィールドに詳細を記入します。

   1. Integration Name: 統合の名前。
   2. Types: Scanner を選択します。
   3. Registry Endpoint: レジストリーのアドレス。
   4. Project: Google Cloud プロジェクト名。
   5. Service Account Key (JSON) 認証用のサービスアカウントキー。
5. Test (checkmark アイコン) を選択して、選択したレジストリーとの統合が機能していることをテストします。
6. Create (save アイコン) を選択して、設定を作成します。

手順

1. RHACS ポータルで、Platform Configuration → Integrations に移動します。
2. Image Integrations セクションで Red Hat Quay.io を選択します。
3. New integration をクリックします。
4. Integration name を入力します。

5. Type で、Scanner を選択します。(レジストリーとも統合する場合は、Scanner + Registry を選択します。) 以下のフィールドに情報を入力します。

   • Endpoint: レジストリーのアドレスを入力します。
   • OAuth token: RHACS が API を使用して認証するために使用する OAuth トークンを入力します。
   • オプション: Robot username: Scanner + Registry を設定しており、Quay ロボットアカウントを使用してレジストリーにアクセスしている場合は、<namespace>+<accountname> の形式でユーザー名を入力します。
   • オプション: Robot password: Scanner + Registry を設定していて、Quay ロボットアカウントを使用してレジストリーにアクセスしている場合は、ロボットアカウントのユーザー名のパスワードを入力します。
6. オプション: レジストリーへの接続時に TLS 証明書を使用していない場合は、Disable TLS certificate validation (insecure) を選択します。
7. オプション: テストを行わずにインテグレーションを作成するには、Create integration without testing を選択します。
8. Save を選択します。

手順

1. RHACS ポータルで、Platform Configuration → Integrations に移動します。
2. Notifier Integrations セクションまでスクロールダウンし、Jira Software を選択します。
3. New Integration をクリックします。
4. Integration Name の名前を入力します。
5. Username ボックスと Password or API Token ボックスにユーザーのクレデンシャルを入力します。
6. Issue Type に、有効な Jira Issue Type (Task、Sub-task、Bug など) を入力します。
7. Jira URL ボックスに Jira サーバーの URL を入力します。
8. 問題を作成するプロジェクトのキーを Default Project ボックスに入力します。
9. Annotation Key For Project ボックスを使用して、さまざまな Jira プロジェクトで課題を作成します。
10. Jira プロジェクトでカスタムプライオリティーを使用する場合は、Priority Mapping トグルを使用してカスタムプライオリティーを設定します。

11. JIRA プロジェクトで必須のカスタムフィールドを使用する場合は、Default Fields JSON (Necessary If Required Fields) ボックスに JSON 値として入力します。以下に例を示します。

    {
      "customfield_10004": 3,
      "customfield_20005": "Alerts",
    }

12. Test (checkmark アイコン) を選択して、Jira との統合が機能していることをテストします。
13. Create (save アイコン) を選択して、設定を作成します。

手順

1. RHACS ポータルで、Platform Configuration → Policies に移動します。
2. アラートの送信先となるポリシーを 1 つ以上選択します。
3. Bulk actions で Enable notification を選択します。

4. Enable notification ウィンドウで、Jira notifier を選択します。

   注記

   他の統合を設定していない場合、システムは通知機能が設定されていないメッセージが表示します。

5. Enable をクリックします。

手順

1. JIRA プロジェクトからカスタムプライオリティーの値を取得するには、次のコマンドを実行して、JIRA 統合のデバッグログをオンにします。

   $ roxctl -e "$ROX_CENTRAL_ADDRESS" central debug log --level Debug --modules notifiers/jira

2. 指示に従って、Jira 統合用の Red Hat Advanced Cluster Security for Kubernetes を設定します。統合をテストすると、統合テストが失敗した場合でも、生成されたログには JIRA プロジェクトスキーマとカスタムプライオリティーが含まれます。

3. デバッグ情報を圧縮された .zip ファイルとして保存するには、次のコマンドを実行します。

   $ roxctl -e "$ROX_CENTRAL_ADDRESS" central debug dump

4. .zip ファイルを解凍して、JIRA プロジェクトで使用されているカスタムプライオリティーの値を取得します。

5. デバッグログをオフにするには、次のコマンドを実行します。

   $ roxctl -e "$ROX_CENTRAL_ADDRESS" central debug log --level Info

6. Jira 統合のために Red Hat Advanced Cluster Security for Kubernetes を再度設定し、プライオリティーの値を使用してカスタムプライオリティーを設定します。

1. デプロイメント YAML ファイルに次の例のようなアノテーションを追加します。ここで、emailは、メールインテグレーションで指定する Annotation key です。

   annotations:
     email: <email_address>

2. RHACS を設定するときは、Annotation key for recipient フィールドでアノテーションキーの email を使用します。

手順

1. Platform Configuration → Integrations に移動します。
2. Notifier Integrations セクションで、Email を選択します。
3. New Integration を選択します。
4. Integration Name フィールドに、メールインテグレーションの名前を入力します。
5. Email server フィールドに、メールサーバーのアドレスを入力します。メールサーバーアドレスには、完全修飾ドメイン名 (FQDN) とポート番号が含まれます (例: smtp.example.com:465)。

6. オプション: 認証されていない SMTP を使用している場合は、Enable unauthenticated SMTP を選択します。これは安全ではなく、推奨されませんが、インテグレーションによっては必要になる場合があります。たとえば、認証を必要としない通知に内部サーバーを使用する場合、このオプションを有効にする必要がある場合があります。

   注記

   認証を使用して認証されていない SMTP を有効にする既存のメールインテグレーションを変更できません。既存のインテグレーションを削除し、Enable unauthenticated SMTP を選択して新しいインテグレーションを作成する必要があります。

7. 認証に使用するサービスアカウントのユーザー名とパスワードを入力します。
8. オプション: メール通知の FROM ヘッダーに表示する名前を From フィールドに入力します。たとえば、Security Alerts などです。
9. メール通知の SENDER ヘッダーに表示するメールアドレスを Sender フィールドに指定します。
10. Default recipient フィールドに、通知を受信するメールアドレスを指定します。
11. オプション: Annotation key for recipient にアノテーションキーを入力します。アノテーションを提供し、デプロイメントまたは namespace にこの値のキーがある場合、通知はアノテーションのメールアドレスに送信されます。それ以外の場合、通知は Default Recipient フィールドで指定されたメールに送信されます。

12. オプション: Disable TLS certificate validation (insecure) を選択して、TLS を使用せずにメールを送信します。StartTLS を使用していない限り、TLS を無効にしないでください。

    注記

    メール通知には TLS を使用します。TLS がないと、すべてのメールは暗号化されずに送信されます。

13. オプション: StartTLS を使用するには、Use STARTTLS (Requires TLS To Be Disabled) ドロップダウンメニューで Login または Plain を選択します。

    重要

    StartTLS を使用すると、セッションの暗号化が確立される前に、クレデンシャルがプレーンテキストでメールサーバーに渡されます。

    • login パラメーターを指定した StartTLS は、base64 でエンコードされた文字列で認証クレデンシャルを送信します。
    • Plain パラメーターを指定した StartTLS は、認証クレデンシャルをプレーンテキストでメールリレーに送信します。

手順

1. RHACS ポータルで、Platform Configuration → Policies に移動します。
2. アラートの送信先となるポリシーを 1 つ以上選択します。
3. Bulk actions で Enable notification を選択します。

4. Enable notification ウィンドウで、メール通知機能を選択します。

   注記

   他の統合を設定していない場合、システムは通知機能が設定されていないメッセージが表示します。

5. Enable をクリックします。