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 の取り込み認証ファイルを取得する

  1. Google SecOps コンソールにログインします。
  2. [SIEM 設定] > [コレクション エージェント] に移動します。
  3. Ingestion Authentication File をダウンロードします。Bindplane をインストールするシステムにファイルを安全に保存します。

Google SecOps のお客様 ID を取得する

  1. Google SecOps コンソールにログインします。
  2. [SIEM 設定] > [プロファイル] に移動します。
  3. [組織の詳細情報] セクションから [お客様 ID] をコピーして保存します。

Bindplane エージェントをインストールする

Windows のインストール

  1. 管理者として コマンド プロンプトまたは PowerShell を開きます。
  2. 次のコマンドを実行します。

    msiexec /i "https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi" /quiet
    

Linux のインストール

  1. root 権限または sudo 権限でターミナルを開きます。
  2. 次のコマンドを実行します。

    sudo sh -c "$(curl -fsSlL https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh)" install_unix.sh
    

その他のインストール リソース

Syslog を取り込んで Google SecOps に送信するように Bindplane エージェントを構成する

  1. 構成ファイルにアクセスします。

    1. config.yaml ファイルを見つけます。通常、Linux では /etc/bindplane-agent/ ディレクトリに、Windows ではインストール ディレクトリにあります。
    2. テキスト エディタ(nanovi、メモ帳など)を使用してファイルを開きます。
  2. 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
    
  3. 自社のインフラストラクチャでの必要性に応じて、ポートと IP アドレスを置き換えます。

  4. <customer_id> は、実際の顧客 ID に置き換えます。

  5. /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 サービスを構成する

  1. Epic Systems コンソールにログインします。
  2. [スタート> Epic > Interconnect > <your instance> > 構成エディタ] に移動します。
  3. [ビジネス サービス] フォームを選択します。
  4. [サービス カテゴリ] タブで、[SendSIEMSyslogAudit] を選択します。
  5. [保存] をクリックします。

syslog をエクスポートするように Epic Systems を構成する

  1. [Epic system definitions] > [Security] > [Auditing options] > [SIEM syslog settings] に移動します。
  2. 次の構成の詳細を指定します。
    • ホスト: Bindplane エージェントの IP アドレスを入力します。
    • ポート: Bindplane エージェントのポート番号を入力します。
    • SIEM 形式: [CEF(Common Event Format)] を選択します。
    • Syslog ending character: [New Line "\n"] を選択します。
  3. [SIEM syslog 設定] メニューから [SIEM syslog] を選択します。
  4. [有効] をクリックします。

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 フィールドから取得され、値に基づいて WINDOWSMACLINUX、または 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 フィールドから取得され、値に基づいて LOWHIGH、または 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_AUDITAC_BREAK_THE_GLASS_FAILED_ACCESSAC_BREAK_THE_GLASS_INAPPROPRIATE_ATTEMPTAC_BREAK_THE_GLASS_ACCESSMCMEMEDISA のいずれかで、target_ip_set が true であるか、リソースが空でない場合、値は RESOURCE_READ に設定されます。event_id が FAILEDLOGINLOGINROVER_FAILED_LOGINSWITCHUSERAUTHENTICATIONEW_LOGINROVER_LOGINCTO_FAILED_LOGINCTO_LOGINHKU_FAILED_LOGINHKU_LOGINWPSEC_SEC_AUTH_OPT_OUTWPSEC_SEC_AUTH_OPT_INBCA_LOGIN_FAILUREBCA_LOGIN_SUCCESSBCA_USER_LOCKEDWPSEC_LOGIN_FAILWPSEC_LOGIN_SUCCESS のいずれかで、target_ip_set、resource、SERVICENAME、SERVICETYPE、shost のいずれか 1 つ以上が空でない場合、値は USER_LOGIN に設定されます。event_id が E_ADMINPASSWORDCHANGEE_FAILEDPASSWORDCHANGEE_SELFPASSWORDCHANGEWPSEC_USER_PASSWORD_CHANGE_FAILWPSEC_USER_PASSWORD_CHANGE のいずれかの場合、値は USER_CHANGE_PASSWORD に設定されます。event_id が CONTEXTCHANGE の場合、値は USER_UNCATEGORIZED に設定されます。event_id が SECUREUNSECUREMASKED_DATA_DISPLAYMASKED_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 のプロフェッショナルから回答を得ることができます。