Auth スキーマ🔗
注意
スキーマドキュメントでは、正規化に利用できるフィールドを表示しています。XDRでスキーマフィールドが反映されるには、パーサーで定義された対応するフィールドが元データ内に存在している必要があります。正規化されたデータはイベントの正規化されたデータタブに表示され、対応するフィールドが元データに存在する場合のみXDRで検索可能です。データレイク検索のスキーマライブラリーでは、検索可能なフィールドのみが表示されます。
| 正規化されたフィールド | 型 | パーサーのフィールド | 説明 |
|---|---|---|---|
| resource_id | string | resoureId$ | レコードを識別する完全なリソース文字列 |
| tenant_id | string | tenantId$ | この特定の CTPX ID を所有するテナントの ID |
| sensor_type | string | sensorType$ | このイベントを生成したデバイスのタイプ。例: redcloak |
| sensor_event_id | string | sensorEventId$ | センサーによって割り当てられた original_data のイベント ID |
| sensor_tenant | string | sensorTenant$ | データの発生元アプリケーションによって提供される顧客 ID。例: redloak-domain, ctp-client-id |
| sensor_id | string | sensorId$ | データの発生元アプリケーションによって提供されるデータの ID。例: redcloak-agent-id |
| sensor_cpe | string | sensorCpe$ | アラートを生成するプラットフォームの CPE。 例: cpe:2.3:a:secureworks:redcloak:*:*:*:*:*:*:* |
| original_data | string | originalData$ | 変換前の元の未加工データ。 |
| event_time_usec | uint64 | eventTimeUsec$ | マイクロ秒 (µs) 単位のイベント時刻 |
| ingest_time_usec | uint64 | ingestTimeUsec$ | マイクロ秒 (µs) 単位の取り込み時刻。 |
| event_time_fidelity | TimeFidelity | eventTimeFidelity$ | event_time_usec の設定に使用された時刻の元の精度を指定します |
| host_id | string | hostId$ | ホスト ID -- イベントの発生元ホストを一意に識別します。例: IPv(4/6) アドレス、デバイスの MAC アドレス |
| process_id | string | processId$ | 実行中のプロセスに対して OS が提供する識別子 |
| process_create_time_usec | uint64 | processCreateTimeUsec$ | 認可を要求したプロセスの作成時刻 |
| process_correlation_id | string | processCorrelationId$ | ローリング ID redcloak に対する保護のためのプロセス相関 ID -- host_id:id.pid:id.time_window |
| process_filename | string | processFilename$ | 認可を要求したプロセスのファイル名 |
| process_file_hash | FileHash | fileHash$ | 認可を要求したプロセスのファイルのハッシュ |
| commandline | string | commandline$ | 認可要求を行ったプロセスの完全なコマンドライン |
| sensor_version | string | sensorVersion$ | 文字列としてのエージェントバージョン。 |
| action | Auth.Action | action$ | 認証イベントのタイプ (例: LOGON、LOGOFF) |
| auth_category | Auth.AuthCategory | authCategory$ | 認証イベントのタイプ (例: ACCOUNT_LOGON、ACCOUNT_LOCK) |
| action_result | Auth.ActionResult | actionResult$ | auth_category で実行されたアクションの結果 (例: SUCCESS、FAILED) |
| failure_category | Auth.FailureCategory | failureCategory$ | action_result が FAILED の場合の理由 |
| trust_features | Auth.TrustFeatures | trustFeatures$ | ユーザーログオンが正当である可能性を示す理由。たとえば MFA が使用された場合など |
| auth_system | string | authSystem$ | イベントを識別するシステム (例: Windows、PAM、SSHD、sudo) |
| target_user_name | string | targetUserName$ | アクションの影響を受けたアカウント |
| target_domain_name | string | targetDomainName$ | ユーザーがログインしている先のドメイン |
| target_address | string | targetAddress$ | ユーザーがログインしている先の IP アドレス |
| target_port | string | targetPort$ | ユーザーがログインしている先のポート。 |
| target_port_number | uint32 | targetPortNumber$ | ユーザーがログインしている先のポート。 |
| target_host_name | string | targetHostName$ | ターゲットのホスト名。例: Windows ワークステーション名 |
| source_user_name | string | sourceUserName$ | ユーザーがログイン元としているアカウント |
| source_domain_name | string | sourceDomainName$ | ユーザーがログイン元としているドメイン |
| source_address | string | sourceAddress$ | ユーザーがログイン元としている IP アドレス |
| source_port | string | sourcePort$ | ユーザーがログイン元としているポート。 |
| source_port_number | uint32 | sourcePortNumber$ | ユーザーがログイン元としているポート。 |
| os | OperatingSystem | os\(.os\) | ユーザーのマシンのオペレーティングシステム、アーキテクチャ |
| logon_application_family | string | logonApplicationFamily$ | ユーザーがログオンに使用したアプリケーション。バージョン情報を除いたもの (例: chrome、firefox) |
| user_agent | string | userAgent$ | リクエストで使用された user-agent 文字列 |
| user_display_name | string | userDisplayName$ | ユーザーアカウントの表示名 |
| member_name | string | memberName$ | セキュリティが有効なローカルグループに追加または削除されたアカウントの識別名 |
| session_id | string | sessionId$ | ログオン/ログオフを対応付けるためのセッション識別子 |
| logon_type | Auth.LogonType | logonType$ | ログオンタイプの値 (例: '...Logon Type: 3...') |
| mfa_used | bool | mfaUsed$ | ユーザー認証時に MFA が使用されたかどうか |
| encryption_type | Auth.EncryptionType | encryptionType$ | チケット暗号化タイプ。例: 0x12 または 0x17 |
| win_event_level | string | winEventLevel$ | Windows によってイベントに割り当てられた緊急度レベル |
| win_summary | string | winSummary$ | Windows によって提供されたイベント概要 |
| win_keywords | string | winKeywords$ | Windows がイベントに適用するキーワード |
| win_task_category | string | winTaskCategory$ | Windows がイベントを分類したカテゴリ |
| win_event_id | string | winEventId$ | Windows ログによって生成されたイベントの識別子 |
| device_trust_type | string | deviceTrustType$ | Microsoft Graph Signin Events の deviceDetails 内の trustType フィールドから取得: https://docs.microsoft.com/en-us/graph/api/resources/devicedetail?view=graph-rest-1.0{: target="_blank"}。サインインデバイスの信頼性の指標として使用できます |
| src_ipblacklist_hits | string | repeated | ソースに一致したブラックリスト名を提供します |
| dest_ipblacklist_hits | string | repeated | 宛先に一致したブラックリスト名を提供します |
| src_ipgeo_summary | GeoSummary | ソース IP の地理的位置。カスタムパーサーからは書き込みできません — source_address からの Taegis IP エンリッチメントによって自動的に設定されます。このページの最後にある note を参照してください。 |
|
| dest_ipgeo_summary | GeoSummary | 宛先 IP の地理的位置。カスタムパーサーからは書き込みできません — target_address からの Taegis IP エンリッチメントによって自動的に設定されます。このページの最後にある note を参照してください。 |
|
| status | string | status$ | |
| sub_status | string | subStatus$ | |
| extra_authenticationpackagename | string | extraAuthenticationpackagename$ | 認証を実行するシステム。例: NTLM、Kerberos |
| extra_elevatedtoken | string | extraElevatedtoken$ | このイベントで表されるセッションが管理者権限を持つかどうかを示します |
| extra_failurereason | string | extraFailurereason$ | ログイン失敗、リソースアクセス失敗などの理由 |
| extra_homedirectory | string | extraHomedirector$ | ログイベントに関連付けられたユーザープロセスのホームディレクトリ |
| extra_impersonationlevel | string | extraImpersonationlevel$ | MS WMI の偽装レベル |
| extra_keylength | int32 | extraKeylength$ | "secure channel" を保護するキーの長さ |
| extra_lmpackagename | string | extraLmpackagename$ | このログオンが NTLM プロトコル (たとえば Kerberos ではなく) で認証された場合、このフィールドは使用された NTLM のバージョンを示します |
| extra_logonprocessname | string | extraLogonprocessname$ | MS の信頼されたログオンプロセス名。例: Winlogon、IKE など |
| extra_restrictedadminmode | string | extraRestrictedadminmode$ | クライアントがコマンドラインで /restrictedAdmin を指定した受信 Remote Desktop 接続の場合は "Yes" |
| extra_samaccountname | string | extraSamaccountname$ | 以前のバージョンの Windows (Windows 2000 より前) のクライアントおよびサーバーをサポートするために使用されるユーザーログオン名 |
| extra_targetoutbounddomainname | string | extraTargetoutbounddomainname$ | ターゲットログオンの MS ドメイン名 |
| extra_targetoutboundusername | string | extraTargetoutboundusername$ | ターゲットログオンの MS ユーザー名 |
| extra_targetservername | string | extraTargetservername$ | ターゲットログオンのホスト名 |
| extra_userprincipalname | string | extraUserpricipalname$ | インターネット標準 RFC 822 に基づく、ユーザーのインターネット形式のログイン名 |
| extra_virtualaccount | string | extraVirtualAccount$ | MS サービスが "Virtual Account" でログオンするよう設定されていることを示します |
| extra_workstationname | string | extraWorkstationname$ | The |
| extra_subject_domain_user_id | string | extraSubjectDomainUserId$ | ログオンを要求したアカウントを識別します - ログオンされるユーザーではありません |
| extra_target_domain_user_id | string | extraTargetDomainUserId$ | ログオンされるアカウントを識別します |
| application_name | string | applicationName$ | ログイン先のアプリケーションを識別します。特にクラウドインテグレーションで使用されます |
| service_name | string | serviceName$ | ユーザーがログインしようとしているサービス名 |
| service_sid | string | serviceSid$ | ユーザーがログインしようとしているサービスを識別します |
| ticket_options | string | ticketOptions$ | ログオンチケットのオプション |
| event_metadata | KeyValuePairsIndexed | event_metadata はコンテキストを追加するためにアプライアンスから提供される場合があります | |
| client_credential_type | Auth.ClientCredentialType | clientCredentialType$ | ユーザークライアントまたはサービスプリンシパルが提供した資格情報タイプを説明します |
| auth_protocol | Auth.AuthProtocol | authProtocol$ | 認証で使用されたプロトコルタイプ |
Auth.Action🔗
認証イベントのタイプ
| Name | Number | Description |
|---|---|---|
| UNCLASSIFIED | 0 | |
| LOGON | 1 | ユーザーのログイン/認証操作。またはユーザーセッションの開始 |
| ACCOUNT | 2 | |
| PRIVILEGE | 3 | |
| POLICY | 4 | アカウント/ドメインポリシーの変更。Windows では、このコンピューターの Security Settings\Account Policy または Account Lockout Policy が、ローカルセキュリティポリシーまたは Active Directory のグループポリシーを通じて変更されました。Web ベースの Auth プラットフォーム (例: Okta) では、1. ライフサイクルポリシーの変更 2. ユーザーセッションの有効期間 3. MFA 要件 4. パスワード複雑性要件 |
| SYSTEM | 5 | システム監査ポリシーの変更。Web ベースの Auth プロバイダーでは、1. API トークンの作成/取り消し 2. MFA 検証リクエスト |
| LOG | 6 | |
| LOGOFF | 7 | ユーザーのログアウト操作。またはユーザーセッションの終了 |
| FAILURE | 8 | ユーザー認証試行の失敗 |
| USER_MANAGEMENT | 9 | 1. アカウントへの新規ユーザー追加 2. 既存ユーザーの変更 3. アカウントからのユーザー削除 4. ライフサイクルイベント 5. パスワード/MFA 設定の更新 を含むアクション |
Auth.AuthCategory🔗
認証イベントのタイプ。
| Name | Number | Description |
|---|---|---|
| UNKNOWN_AUTH_CATEGORY | 0 | |
| ACCOUNT_LOGON | 10 | |
| ACCOUNT_LOGOFF | 20 | |
| ACCOUNT_LOCK | 30 | |
| ACCOUNT_UNLOCK | 40 | |
| PASSWORD_CHANGE_ATTEMPT | 50 | ユーザーが自分自身のパスワード変更を試行しました |
| PASSWORD_RESET_ATTEMPT | 60 | ソースユーザーがターゲットユーザーのパスワード変更を試行しました (例: 管理者によるリセット) |
| PRE_AUTHENTICATION | 70 | Kerberos 認証チケットの要求など、認証に必要な事前ステップ |
Auth.ActionResult🔗
auth_category で実行されたアクションの結果。
| Name | Number | Description |
|---|---|---|
| UNKNOWN_ACTION_RESULT | 0 | |
| SUCCESS | 10 | auth_category ステップの結果は成功でした |
| FAILED | 20 | auth_category ステップの結果は成功ではありませんでした |
Auth.FailureCategory🔗
action_result が FAILED の場合の理由。
| Name | Number | Description |
|---|---|---|
| UNKNOWN_FAILURE_CATEGORY | 0 | |
| INCORRECT_USER_OR_PASSWORD | 10 | |
| EXPIRED_PASSWORD | 20 | |
| INVALID_ACCOUNT | 30 | |
| INCORRECT_MFA | 40 | |
| OUTSIDE_PERMISSIBLE_HOURS | 50 | |
| OVERDUE_PASSWORD_CHANGE | 60 | |
| ACCOUNT_LOCKED_OUT | 70 | |
| ACCOUNT_DISABLED | 80 | |
| OTHER_ERROR | 90 | ここにある他のカテゴリではカバーされないエラーが報告されています |
Auth.TrustFeatures🔗
| Name | Number | Description |
|---|---|---|
| UNKNOWN_TRUSTED_FEATURES | 0 | |
| MFA_USED | 10 | |
| TRUSTED_IP_ADDRESS | 20 | |
| OTHER_TRUSTED_ACCOUNT | 30 | アカウントが別の方法で信頼されていることを示します。たとえば Entra ID に登録または参加しているデバイスなど |
Auth.EncryptionType🔗
| Name | Number | Description |
|---|---|---|
| ENCRYPTION_UNKNOWN | 0 | |
| DES_CBC_CRC | 1 | |
| DES_CBC_MD4 | 2 | |
| DES_CBC_MD5 | 3 | |
| DES3_CBC_MD5 | 4 | |
| DES3_CBC_SHA1 | 5 | |
| DSA_WITH_SHA1_CMSOID | 6 | |
| MD5_WITH_RSA_ENCRYPTION_CMSOID | 7 | |
| SHA1_WITH_RSA_ENCRYPTION_CMSOID | 8 | |
| RC2CBC_ENVOID | 9 | |
| RSA_ENCRYPTION_ENVOID | 10 | |
| RSA_ES_OAEP_ENV_OID | 11 | |
| DES_EDE3_CBC_ENV_OID | 12 | |
| DES3_CBC_SHA1_KD | 13 | |
| AES128_CTS_HMAC_SHA1_96 | 14 | |
| AES256_CTS_HMAC_SHA1_96 | 15 | |
| RC4_HMAC | 16 | |
| RC4_HMAC_EXP | 17 | |
| SUBKEY_KEYMATERIAL | 18 |
Auth.LogonType🔗
WIN32 の値に対応するログオンタイプの値
| Name | Number | Description |
|---|---|---|
| SYSTEMONLY | 0 | 未使用ですが、proto3 で必要です |
| UNKNOWN | 1 | |
| INTERACTIVE | 2 | |
| NETWORK | 3 | |
| BATCH | 4 | |
| SERVICE | 5 | |
| PROXY | 6 | |
| UNLOCK | 7 | |
| NETWORKCLEARTEXT | 8 | |
| NEWCREDENTIALS | 9 | |
| REMOTEINTERACTIVE | 10 | |
| CACHEDINTERACTIVE | 11 | |
| CACHEDREMOTEINTERACTIVE | 12 | |
| CACHEDUNLOCKED | 13 |
Auth.ClientCredentialType🔗
ユーザークライアントまたはサービスプリンシパルが提供した資格情報タイプを説明します。
| Name | Number | Description |
|---|---|---|
| UNKNOWN_CLIENT_CREDENTIAL_TYPE | 0 | |
| CLIENT_SECRET | 1 | |
| CLIENT_ASSERTION | 2 | |
| FEDERATED_IDENTITY_CREDENTIAL | 3 | |
| MANAGED_IDENTITY | 4 | |
| CERTIFICATE | 5 |
Auth.AuthProtocol🔗
認証で使用されたプロトコルタイプ。
| Name | Number | Description |
|---|---|---|
| UNKNOWN_AUTH_PROTOCOL | 0 | |
| KERBEROS | 1 | |
| LDAP | 2 | |
| OAUTH2 | 3 | |
| SAML | 4 | |
| ROPC | 5 | |
| RADIUS | 6 | |
| CHAP | 7 | |
| DIAMETER | 8 | |
| EAP | 9 | |
| PAP | 10 | |
| TACACS | 11 | |
| WSFEDERATION | 12 | |
| DEVICECODE | 13 | |
| AUTH_TRANSFER | 14 |
地理 IP フィールド (src_ipgeo_summary, dest_ipgeo_summary) はカスタムパーサーから書き込みできません
src_ipgeo_summary フィールドと dest_ipgeo_summary フィールドは、カスタムパーサーの正規化の 後 に実行される自動 Taegis IP エンリッチメントステップによって設定されます。カスタムパーサーがこれらのフィールドに書き込んだ値は、イベントがクエリ可能なストレージに到達する前に置き換えられます。
地理データを設定するには、パーサーが関連する IP アドレスを source_address$ と target_address$ に書き込むようにしてください。エンリッチメントはそれらのフィールドを使用して地理データを検索し、src_ipgeo_summary (source_address から) と dest_ipgeo_summary (target_address から) を自動的に入力します。
エンリッチメントはパブリックにルーティング可能な IP アドレスにのみ適用されます。プライベートアドレスとループバックアドレスはスキップされます。