Epic Systems ログを収集する
このドキュメントでは、Bindplane エージェントを使用して Epic Systems のログを Google Security Operations に収集する方法について説明します。パーサーは、未加工の Epic EMR/EHR システムログを統合データモデル(UDM)に変換します。まず、ログ メッセージをクリーンアップして構造化し、Key-Value ペアを抽出してから、抽出したフィールドを対応する UDM フィールドにマッピングします。さまざまなログ形式とデータ不整合を処理して、包括的で標準化されたデータ表現を確保します。
始める前に
- Google Security Operations インスタンスがあることを確認します。
- Windows 2016 以降、または
systemd
を使用する Linux ホストを使用していることを確認します。 - プロキシの背後で実行している場合は、ファイアウォール ポートが開いていることを確認します。
- Epic Systems への特権アクセス権があることを確認します。
Google SecOps の取り込み認証ファイルを取得する
- Google SecOps コンソールにログインします。
- [SIEM 設定] > [コレクション エージェント] に移動します。
- Ingestion Authentication File をダウンロードします。Bindplane をインストールするシステムにファイルを安全に保存します。
Google SecOps のお客様 ID を取得する
- Google SecOps コンソールにログインします。
- [SIEM 設定] > [プロファイル] に移動します。
- [組織の詳細情報] セクションから [お客様 ID] をコピーして保存します。
Bindplane エージェントをインストールする
Windows のインストール
- 管理者として コマンド プロンプトまたは PowerShell を開きます。
次のコマンドを実行します。
msiexec /i "https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi" /quiet
Linux のインストール
- root 権限または sudo 権限でターミナルを開きます。
次のコマンドを実行します。
sudo sh -c "$(curl -fsSlL https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh)" install_unix.sh
その他のインストール リソース
- その他のインストール オプションについては、こちらのインストール ガイドをご覧ください。
Syslog を取り込んで Google SecOps に送信するように Bindplane エージェントを構成する
構成ファイルにアクセスします。
config.yaml
ファイルを見つけます。通常、Linux では/etc/bindplane-agent/
ディレクトリに、Windows ではインストール ディレクトリにあります。- テキスト エディタ(
nano
、vi
、メモ帳など)を使用してファイルを開きます。
config.yaml
ファイルを次のように編集します。receivers: udplog: # Replace the port and IP address as required listen_address: "0.0.0.0:514" exporters: chronicle/chronicle_w_labels: compression: gzip # Adjust the path to the credentials file you downloaded in Step 1 creds: '/path/to/ingestion-authentication-file.json' # Replace with your actual customer ID from Step 2 customer_id: <customer_id> endpoint: malachiteingestion-pa.googleapis.com # Add optional ingestion labels for better organization ingestion_labels: log_type: EPIC raw_log_field: body service: pipelines: logs/source0__chronicle_w_labels-0: receivers: - udplog exporters: - chronicle/chronicle_w_labels
自社のインフラストラクチャでの必要性に応じて、ポートと IP アドレスを置き換えます。
<customer_id>
は、実際の顧客 ID に置き換えます。/path/to/ingestion-authentication-file.json
の値を、Google SecOps の取り込み認証ファイルを取得するで認証ファイルを保存したパスに更新します。
Bindplane エージェントを再起動して変更を適用する
Linux で Bindplane エージェントを再起動するには、次のコマンドを実行します。
sudo systemctl restart bindplane-agent
Windows で Bindplane エージェントを再起動するには、Services コンソールを使用するか、次のコマンドを入力します。
net stop BindPlaneAgent && net start BindPlaneAgent
SendSIEMSyslogAudit サービスを構成する
- Epic Systems コンソールにログインします。
- [スタート> Epic > Interconnect >
<your instance>
> 構成エディタ] に移動します。 - [ビジネス サービス] フォームを選択します。
- [サービス カテゴリ] タブで、[SendSIEMSyslogAudit] を選択します。
- [保存] をクリックします。
syslog をエクスポートするように Epic Systems を構成する
- [Epic system definitions] > [Security] > [Auditing options] > [SIEM syslog settings] に移動します。
- 次の構成の詳細を指定します。
- ホスト: Bindplane エージェントの IP アドレスを入力します。
- ポート: Bindplane エージェントのポート番号を入力します。
- SIEM 形式: [CEF(Common Event Format)] を選択します。
- Syslog ending character: [New Line "\n"] を選択します。
- [SIEM syslog 設定] メニューから [SIEM syslog] を選択します。
- [有効] をクリックします。
UDM マッピング テーブル
ログフィールド | UDM マッピング | ロジック |
---|---|---|
APIID | read_only_udm.additional.fields.api.value.string_value | 値は未加工ログの APIID フィールドから取得されます |
APPLICATIONID | read_only_udm.additional.fields.application_id.value.string_value | 値は、未加工ログの APPLICATIONID フィールドから取得されます |
アプリ | read_only_udm.target.application | 値は未加工ログの APP フィールドから取得されます |
監査セッション | read_only_udm.network.session_id | 値は、未加工ログの AUDIT SESSION フィールドから取得されます |
AUTH_SOURCE | このフィールドは UDM にマッピングされません | |
BCAPCS | read_only_udm.target.application | 値は未加工ログの BCAPCS フィールドから取得されます |
BTGEXPLANATION | read_only_udm.security_result.description | 値は、未加工ログの BTGEXPLANATION フィールドから取得されます |
BTGNOACCESSREAS | read_only_udm.security_result.summary | 値は、未加工ログの BTGNOACCESSREAS フィールドから取得されます |
BTGREASON | read_only_udm.security_result.summary | 値は未加工ログの BTGREASON フィールドから取得されます |
CLIENTNAME | read_only_udm.principal.hostname | 値は未加工ログの CLIENTNAME フィールドから取得されます |
CSISESS_TOKEN | read_only_udm.network.session_id | 値は、未加工ログの CSISESS_TOKEN フィールドから取得されます |
CTXT | read_only_udm.metadata.description | 値は未加工ログの CTXT フィールドから取得されます |
CVG | read_only_udm.additional.fields.cvg.value.string_value | 値は未加工ログの CVG フィールドから取得されます |
DAT | このフィールドは UDM にマッピングされません | |
DEP | read_only_udm.principal.user.department | 値は、未加工ログの DEP フィールドから取得されます。未加工ログに NEWDEPARTMENT フィールドと PREVDEPARTMENT フィールドの両方が存在する場合、値は PREVDEPARTMENT:-{PREVDEPARTMENT}, NEWDEPARTMENT:-{NEWDEPARTMENT} になります。NEWDEPARTMENT のみが存在する場合、値は PREVDEPARTMENT:-NONE, NEWDEPARTMENT:{NEWDEPARTMENT} になります。PREVDEPARTMENT のみが存在する場合、値は PREVDEPARTMENT:{PREVDEPARTMENT}, NEWDEPARTMENT:-NONE になります。 |
devTime | read_only_udm.metadata.event_timestamp | 値は未加工ログの devTime フィールドから取得され、エポックからの経過秒数に変換されます |
devTimeFormat | このフィールドは UDM にマッピングされません | |
E3MID | read_only_udm.network.session_id | 値は未加工ログの E3MID フィールドから取得されます |
ENCRYPTED | read_only_udm.additional.fields.encrypt.value.string_value | 値は未加工ログの ENCRYPTED フィールドから取得されます |
ERRMSG | read_only_udm.security_result.summary | 値は未加工ログの ERRMSG フィールドから取得されます |
eventCnt | このフィールドは UDM にマッピングされません | |
FILENAME | read_only_udm.target.file.full_path | 値は未加工ログの FILENAME フィールドから取得され、\\\\ のすべての出現箇所が \ に置き換えられます。 |
フラグ | read_only_udm.security_result.description | 値は未加工ログのフラグ フィールドから取得され、先頭と末尾の - はすべて削除されます。 |
HKUAPVER | read_only_udm.metadata.product_version | 値は未加工ログの HKUAPVER フィールドから取得されます |
HKUDVCID | read_only_udm.principal.asset_id | 値は未加工ログの HKUDVCID フィールドから取得され、Device ID:{HKUDVCID} としてフォーマットされます。 |
HKUOSNAM | read_only_udm.principal.platform | 値は未加工ログの HKUOSNAM フィールドから取得され、値に基づいて WINDOWS 、MAC 、LINUX 、または UNKNOWN_PLATFORM にマッピングされます。 |
HKUOSVER | read_only_udm.principal.platform_version | 値は未加工ログの HKUOSVER フィールドから取得されます |
INSTANCEURN | read_only_udm.intermediary.hostname | 値は、未加工ログの INSTANCEURN フィールドから取得されます |
IP | read_only_udm.target.ip | 値は、未加工ログの IP フィールドから取得されます。値に / が含まれている場合は、2 つの IP アドレスに分割されます。値に , が含まれている場合は、複数の IP アドレスに分割されます。 |
LOGINERROR | read_only_udm.security_result.summary | 値は未加工ログの LOGINERROR フィールドから取得されます |
LOGIN_CONTEXT | read_only_udm.metadata.description | 値は、未加工ログの LOGIN_CONTEXT フィールドから取得されます |
LOGIN_DEVICE | read_only_udm.additional.fields.login_device.value.string_value | 値は未加工ログの LOGIN_DEVICE フィールドから取得されます |
LOGIN_LDAP_ID | read_only_udm.principal.user.userid | 値は、未加工ログの LOGIN_LDAP_ID フィールドから取得されます |
LOGIN_REASON | read_only_udm.security_result.summary | 値は、未加工ログの LOGIN_REASON フィールドから取得されます |
LOGIN_REVAL | read_only_udm.additional.fields.login_reval.value.string_value | 値は未加工ログの LOGIN_REVAL フィールドから取得されます |
MASKMODE | read_only_udm.additional.fields.masked_mode.value.string_value | 値は未加工ログの MASKMODE フィールドから取得されます |
MYCACCT | read_only_udm.principal.user.userid | 値は未加工ログの MYCACCT フィールドから取得されます |
NEWDEPARTMENT | read_only_udm.principal.user.department | DEP フィールドのロジックを参照する |
NEWUSER | このフィールドは UDM にマッピングされません | |
NSC | read_only_udm.additional.fields.nsc.value.string_value | 値は未加工ログの NSC フィールドから取得されます |
OSUSR | read_only_udm.target.user.userid | 値は未加工ログの OSUSR フィールドから取得されます |
患者 | read_only_udm.target.user.userid | 値は未加工ログの PATIENT フィールドから取得されます |
PREVDEPARTMENT | read_only_udm.principal.user.department | DEP フィールドのロジックを参照する |
PREVPROVIDER | このフィールドは UDM にマッピングされません | |
PREVUSER | read_only_udm.principal.resource.attribute.labels.prev_user.value | 値は、未加工ログの PREVUSER フィールドから取得されます |
PWREASON | read_only_udm.metadata.description | 値は未加工ログの PWREASON フィールドから取得されます |
役職 | read_only_udm.principal.user.attribute.roles.name | 値は未加工ログの ROLE フィールドから取得されます |
リソース | read_only_udm.target.hostname | 値は未加工ログのリソース フィールドから取得されます |
SERVICEID | read_only_udm.additional.fields.service_id.value.string_value | 値は未加工ログの SERVICEID フィールドから取得されます |
SERVICECATEGORY | read_only_udm.additional.fields.service_category.value.string_value | 値は、未加工ログの SERVICECATEGORY フィールドから取得されます |
SERVICEMSGID | このフィールドは UDM にマッピングされません | |
SERVICENAME | read_only_udm.target.resource.name | 値は、未加工ログの SERVICENAME フィールドから取得されます |
SERVICETYPE | read_only_udm.target.resource.type | 値は、未加工ログの SERVICETYPE フィールドから取得されます。event_id が PHI_CLIENT_FILE の場合、値は FILE に設定されます。 |
SERVICE_USER | read_only_udm.target.user.userid | 値は未加工ログの SERVICE_USER フィールドから取得されます |
SERVICE_USERTYP | read_only_udm.additional.fields.service_user_type.value.string_value | 値は、未加工ログの SERVICE_USERTYP フィールドから取得されます |
sev | read_only_udm.security_result.severity | 値は未加工ログの sev フィールドから取得され、値に基づいて LOW 、HIGH 、または CRITICAL にマッピングされます。 |
shost | read_only_udm.target.resource.attribute.labels.workstation_type.value | 値は未加工ログの shost フィールドから取得されます |
ソース | read_only_udm.additional.fields.login_source.value.string_value | 値は未加工ログの SOURCE フィールドから取得されます |
SUCCESS | read_only_udm.additional.fields.success_yes_no.value.string_value | 値は未加工ログの SUCCESS フィールドから取得されます |
タイムアウトです | read_only_udm.additional.fields.time_out.value.string_value | 値は未加工ログの TIMEOUT フィールドから取得されます |
UID | read_only_udm.principal.user.userid | 値は未加工ログの UID フィールドから取得されます |
USERJOB | このフィールドは UDM にマッピングされません | |
usrName | read_only_udm.principal.user.userid、read_only_udm.principal.user.user_display_name | 未加工ログに UID フィールドまたは LOGIN_LDAP_ID フィールドが存在する場合、usrName は read_only_udm.principal.user.user_display_name に使用され、もう一方のフィールドは read_only_udm.principal.user.userid に使用されます。それ以外の場合は、usrName が read_only_udm.principal.user.userid に使用されます。 |
WEBLGAPP | read_only_udm.target.application | 値は未加工ログの WEBLGAPP フィールドから取得されます |
read_only_udm.extensions.auth.type | LOGIN_LDAP_ID が空でない場合、値は SSO に設定されます。それ以外の場合、値は AUTHTYPE_UNSPECIFIED に設定されます。 |
|
read_only_udm.intermediary.ip | 値は、ログソースの IP アドレスに設定されます。 | |
read_only_udm.metadata.event_type | event_id が IC_SERVICE_AUDIT 、AC_BREAK_THE_GLASS_FAILED_ACCESS 、AC_BREAK_THE_GLASS_INAPPROPRIATE_ATTEMPT 、AC_BREAK_THE_GLASS_ACCESS 、MCMEMEDISA のいずれかで、target_ip_set が true であるか、リソースが空でない場合、値は RESOURCE_READ に設定されます。event_id が FAILEDLOGIN 、LOGIN 、ROVER_FAILED_LOGIN 、SWITCHUSER 、AUTHENTICATION 、EW_LOGIN 、ROVER_LOGIN 、CTO_FAILED_LOGIN 、CTO_LOGIN 、HKU_FAILED_LOGIN 、HKU_LOGIN 、WPSEC_SEC_AUTH_OPT_OUT 、WPSEC_SEC_AUTH_OPT_IN 、BCA_LOGIN_FAILURE 、BCA_LOGIN_SUCCESS 、BCA_USER_LOCKED 、WPSEC_LOGIN_FAIL 、WPSEC_LOGIN_SUCCESS のいずれかで、target_ip_set、resource、SERVICENAME、SERVICETYPE、shost のいずれか 1 つ以上が空でない場合、値は USER_LOGIN に設定されます。event_id が E_ADMINPASSWORDCHANGE 、E_FAILEDPASSWORDCHANGE 、E_SELFPASSWORDCHANGE 、WPSEC_USER_PASSWORD_CHANGE_FAIL 、WPSEC_USER_PASSWORD_CHANGE のいずれかの場合、値は USER_CHANGE_PASSWORD に設定されます。event_id が CONTEXTCHANGE の場合、値は USER_UNCATEGORIZED に設定されます。event_id が SECURE 、UNSECURE 、MASKED_DATA_DISPLAY 、MASKED_DATA_PRINTING のいずれかの場合、値は USER_RESOURCE_ACCESS に設定されます。event_id が PHI_CLIENT_FILE の場合、値は USER_RESOURCE_UPDATE_CONTENT に設定されます。CLIENTNAME が空でない場合、値は STATUS_UPDATE に設定されます。prin_usr_id が空でない場合、値は USER_UNCATEGORIZED に設定されます。それ以外の場合、値は GENERIC_EVENT に設定されます。 |
|
read_only_udm.metadata.log_type | 値は EPIC に設定されています。 |
|
read_only_udm.metadata.product_name | 値は Epic Systems に設定されています。 |
|
read_only_udm.metadata.vendor_name | 値は EPIC に設定されています。 |
|
read_only_udm.network.ip_protocol | 値は、未加工ログの proto フィールドから取得され、対応する IP プロトコル名にマッピングされます。 | |
read_only_udm.principal.resource.attribute.labels.workstation_type.key | 値は Workstation ID/Type に設定されています。 |
|
read_only_udm.principal.resource.attribute.labels.prev_user.key | 値は Prev User に設定されています。 |
|
read_only_udm.security_result.action | 未加工ログに ERRMSG フィールドまたは LOGINERROR フィールドのいずれかが存在する場合、値は BLOCK に設定されます。 |
さらにサポートが必要な場合 コミュニティ メンバーや Google SecOps のプロフェッショナルから回答を得ることができます。