セキュリティイベントのログ記録

Pegaには、データやルールの変更監査、作業履歴の記録に加えて、セキュリティ関連のイベントをPegaRULES-SecurityEvent.logという名前のファイルに記録する機能があります。 このログファイルは、Dev StudioでConfigure > System > Operations > Logs > Log filesをクリックしてアクセスできます。

以下のアイテムは、セキュリティイベントログのエントリーの例です。 各エントリーがJSON形式を使用して記録されていることに注意してください。

Configure > Org & Security > Tools > Security > Security Event Configurationをクリックすると、記録するイベントの種類が表示されます。 その後、カスタムイベントのログ記録を有効または無効にすることができます。

セキュリティイベントの設定では、個々のカスタムイベントがログに記録されるタイミングを制御できません。 たとえば、データトランスフォームのステップまたはアクティビティステップでカスタムセキュリティイベントを記録するかどうかを制御するために、パラメーター化されたWhen Ruleを定義できます。 When Ruleパラメーターは、カスタムイベントのログ記録が有効になっているかどうかを確認するために、データページを介した参照を実行するために使用できます。

カスタムイベントのログ記録は、クライアントベースのアクセス制御（CBAC）の監査要件を満たすために使用できます。

以下のスクリプトを使用して、アクティビティJavaステップ内でカスタムイベントをログに記録できます。

次のいずれかのパラメーター値を使用します。

• eventType：カスタムイベントを追跡するためのイベントタイプの名前
• outcome：イベントの成果
• message：ユーザーがイベントの一部としてログに記録する必要がある任意のメッセージ。
• customFlds：イベントの追加情報をログに記録するキーと値のペアのマップ。 

しかし、Pega Platform™の将来のバージョンでアクティビティでのJavaステップの使用が制限される可能性があるため、長期的なアプローチとしてはRule-Utility-Functionを使用してこのAPIを実行するのが良いでしょう。

Pega Communityのトピック「Adding a custom security event」では、アクティビティ内にJavaステップを作成してカスタムセキュリティーイベントを記録する方法が説明されています。

関数を呼び出すコードにStringMap（Map<String, String>）customFldsパラメーターの指定を要求するのは、複雑すぎます。 この関数は、代わりにテキストベースのValueGroupプロパティを承認できます。 そのValueGroupプロパティは、関数内でStringMapに変換できます。 以下の手順で、この関数を設定する方法を説明します。

1. ライブラリと機能を作成します。
2. 関数が4つのパラメーター（String、String、String、ClipboardProperty）を承認するようにします。
3. 指定されたClipboardPropertyをValueGroupにします。
   関数は、ValueGroup ClipboardPropertyを、ローカルに宣言されたMap customFlds変数に変換します。

以下のコードは、カスタムセキュリティイベントの例です。