Azure AD 로그인 로그 수집
이 문서에서는 Azure 스토리지 계정을 사용하여 Azure AD 로그인 로그를 Google Security Operations로 내보내는 방법을 설명합니다. 파서는 JSON 형식의 원시 로그를 가져와 통합 데이터 모델 (UDM)을 준수하는 구조화된 형식으로 변환합니다. 관련 필드를 추출하고, 값을 정규화하고, 다양한 타임스탬프를 처리하고, 사용자 정보, IP 주소, 조건부 액세스 정책과 같은 보안 관련 컨텍스트로 데이터를 보강합니다.
시작하기 전에
다음 기본 요건이 충족되었는지 확인합니다.
- Google SecOps 인스턴스
- 활성 Azure 테넌트
- Azure에 대한 액세스 권한 관리
Azure 스토리지 계정 구성
- Azure 콘솔에서 스토리지 계정을 검색합니다.
- + 만들기를 클릭합니다.
- 다음 입력 파라미터의 값을 지정합니다.
- 구독: 구독을 선택합니다.
- 리소스 그룹: 리소스 그룹을 선택합니다.
- 리전: 리전을 선택합니다.
- 성능: 성능을 선택합니다 (표준 권장).
- 중복성: 중복성을 선택합니다 (GRS 또는 LRS 권장).
- 스토리지 계정 이름: 새 스토리지 계정의 이름을 입력합니다.
- 검토 + 만들기를 클릭합니다.
- 계정 개요를 검토하고 만들기를 클릭합니다.
- 스토리지 계정 개요 페이지의 보안 + 네트워킹에서 액세스 키 하위 메뉴를 선택합니다.
- key1 또는 key2 옆에 있는 표시를 클릭합니다.
- 클립보드에 복사를 클릭하여 키를 복사합니다.
- 나중에 사용할 수 있도록 키를 안전한 위치에 저장합니다.
- 스토리지 계정 개요 페이지의 설정에서 엔드포인트 하위 메뉴를 선택합니다.
- 클립보드에 복사를 클릭하여 Blob 서비스 엔드포인트 URL(예:
https://<storageaccountname>.blob.core.windows.net
)을 복사합니다. - 나중에 사용할 수 있도록 엔드포인트 URL을 안전한 위치에 저장합니다.
Azure AD 로그인 로그의 로그 내보내기를 구성하는 방법
- 권한이 있는 계정을 사용하여 Azure Portal에 로그인합니다.
- Microsoft Entra ID > Monitoring > Diagnostic settings으로 이동합니다.
- 진단 설정 추가를 클릭합니다.
- 진단 설정을 설명하는 이름을 입력합니다.
- 로그인 로그를 선택합니다.
- 스토리지 계정에 아카이브 체크박스를 대상으로 선택합니다.
- 구독 및 스토리지 계정을 지정합니다.
피드 설정
Google SecOps 플랫폼에서 피드를 설정하는 방법은 두 가지입니다.
- SIEM 설정 > 피드 > 새 피드 추가
- 콘텐츠 허브 > 콘텐츠 팩 > 시작하기
Azure AD 로그인 피드를 설정하는 방법
- Azure 플랫폼 팩을 클릭합니다.
- Azure AD 로그인 로그 유형을 찾습니다.
다음 필드의 값을 지정합니다.
- 소스 유형: Microsoft Azure Blob Storage V2
- Azure URI: blob 엔드포인트 URL입니다.
ENDPOINT_URL/BLOB_NAME
- 다음을 바꿉니다.
ENDPOINT_URL
: blob 엔드포인트 URL (https://<storageaccountname>.blob.core.windows.net
)BLOB_NAME
: Blob의 이름 (예:insights-logs-<logname>
)
- 다음을 바꿉니다.
소스 삭제 옵션: 수집 환경설정에 따라 삭제 옵션을 선택합니다.
최대 파일 기간: 지난 일수 동안 수정된 파일 기본값은 180일입니다.
공유 키: Azure Blob Storage의 액세스 키입니다.
고급 옵션
- 피드 이름: 피드를 식별하는 미리 채워진 값입니다.
- 애셋 네임스페이스: 피드와 연결된 네임스페이스입니다.
- 수집 라벨: 이 피드의 모든 이벤트에 적용되는 라벨입니다.
피드 만들기를 클릭합니다.
이 제품군 내에서 다양한 로그 유형에 대해 여러 피드를 구성하는 방법에 관한 자세한 내용은 제품별 피드 구성을 참고하세요.
UDM 매핑 테이블
로그 필드 | UDM 매핑 | 논리 |
---|---|---|
AppDisplayName | read_only_udm.target.application | 원시 로그의 AppDisplayName 필드에서 직접 매핑됩니다. |
AppId | read_only_udm.security_result.detection_fields.value | 원시 로그의 AppId 필드에서 직접 매핑됩니다. 키가 appId 로 설정됩니다. |
카테고리 | read_only_udm.security_result.category_details | 원시 로그의 Category 필드에서 직접 매핑됩니다. |
ConditionalAccessPolicies[].displayName | read_only_udm.security_result.rule_name | 원시 로그의 ConditionalAccessPolicies 배열 내 displayName 필드에서 직접 매핑됩니다. |
ConditionalAccessPolicies[].enforcedGrantControls[] | read_only_udm.security_result.rule_labels.value | 원시 로그의 ConditionalAccessPolicies 배열 내 enforcedGrantControls 배열에서 직접 매핑됩니다. 키가 applied_conditional_access_policies_enforced_grant_controls 로 설정됩니다. |
ConditionalAccessPolicies[].enforcedSessionControls[] | read_only_udm.security_result.rule_labels.value | 원시 로그의 ConditionalAccessPolicies 배열 내 enforcedSessionControls 배열에서 직접 매핑됩니다. 키가 applied_conditional_access_policies_enforced_session_controls 로 설정됩니다. |
ConditionalAccessPolicies[].id | read_only_udm.security_result.rule_id | 원시 로그의 ConditionalAccessPolicies 배열 내 id 필드에서 직접 매핑됩니다. |
ConditionalAccessPolicies[].Result | read_only_udm.security_result.rule_labels.value | 원시 로그의 ConditionalAccessPolicies 배열 내 Result 필드에서 직접 매핑됩니다. 키가 applied_conditional_access_policies_result 로 설정됩니다. |
ConditionalAccessStatus | read_only_udm.additional.fields.value.string_value | 원시 로그의 ConditionalAccessStatus 필드에서 직접 매핑됩니다. 키가 conditionalAccessStatus 로 설정됩니다. |
CorrelationId | read_only_udm.security_result.detection_fields.value | 원시 로그의 CorrelationId 필드에서 직접 매핑됩니다. 키가 correlationId 로 설정됩니다. |
DurationMs | read_only_udm.additional.fields.value.string_value | 원시 로그의 DurationMs 필드에서 직접 매핑됩니다. 키가 durationMs 로 설정됩니다. |
HomeTenantId | read_only_udm.security_result.detection_fields.value | 원시 로그의 HomeTenantId 필드에서 직접 매핑됩니다. 키가 HomeTenantId 로 설정됩니다. |
IPAddress | read_only_udm.principal.asset.ip, read_only_udm.principal.ip | 원시 로그의 IPAddress 필드에서 직접 매핑됩니다. |
ID | read_only_udm.security_result.detection_fields.value | 원시 로그의 Id 필드에서 직접 매핑됩니다. 키가 id 로 설정됩니다. |
ID | read_only_udm.target.resource.attribute.labels.value | 원시 로그의 Identity 필드에서 직접 매핑됩니다. 키가 identity 로 설정됩니다. |
수준 | read_only_udm.security_result.severity, read_only_udm.security_result.severity_details | 원시 로그의 Level 필드에서 직접 매핑됩니다. 심각도는 Level 값에 따라 결정됩니다. Information , Informational , 0 또는 4 는 INFORMATIONAL 에 매핑되고, Warning , 1 또는 3 는 MEDIUM 에 매핑되고, Error 또는 2 는 ERROR 에 매핑되고, Critical 는 CRITICAL 에 매핑됩니다. |
OperationName | read_only_udm.metadata.product_event_type | 원시 로그의 OperationName 필드에서 직접 매핑됩니다. |
ResourceGroup | read_only_udm.security_result.detection_fields.value | 원시 로그의 ResourceGroup 필드에서 직접 매핑됩니다. 키가 ResourceGroup 로 설정됩니다. |
ResultSignature | read_only_udm.additional.fields.value.string_value | 원시 로그의 ResultSignature 필드에서 직접 매핑됩니다. 키가 resultSignature 로 설정됩니다. |
ResultType | read_only_udm.additional.fields.value.string_value | 원시 로그의 ResultType 필드에서 직접 매핑됩니다. 키가 resultType 로 설정됩니다. |
TenantId | read_only_udm.metadata.product_deployment_id | 원시 로그의 TenantId 필드에서 직접 매핑됩니다. |
TimeGenerated | read_only_udm.metadata.event_timestamp.seconds, read_only_udm.metadata.event_timestamp.nanos | 원시 로그의 TimeGenerated 필드에서 직접 매핑됩니다. 이 필드는 타임스탬프로 파싱되며 seconds 및 nanos 필드를 채우는 데 사용됩니다. |
TokenIssuerType | read_only_udm.security_result.detection_fields.value | 원시 로그의 TokenIssuerType 필드에서 직접 매핑됩니다. 키가 TokenIssuerType 로 설정됩니다. |
UniqueTokenIdentifier | read_only_udm.security_result.detection_fields.value | 원시 로그의 UniqueTokenIdentifier 필드에서 직접 매핑됩니다. 키가 UniqueTokenIdentifier 로 설정됩니다. |
UserAgent | read_only_udm.network.http.user_agent, read_only_udm.network.http.parsed_user_agent | 원시 로그의 UserAgent 필드에서 직접 매핑됩니다. 이 필드는 사용자 에이전트 문자열로 파싱되고 parsed_user_agent 객체를 채우는 데 사용됩니다. |
UserDisplayName | read_only_udm.target.user.user_display_name | 원시 로그의 UserDisplayName 필드에서 직접 매핑됩니다. |
UserId | read_only_udm.target.user.userid | 원시 로그의 UserId 필드에서 직접 매핑됩니다. |
UserPrincipalName | read_only_udm.target.user.email_addresses | 원시 로그의 UserPrincipalName 필드에서 직접 매핑되지만 이메일 주소 패턴과 일치하는 경우에만 매핑됩니다. |
UserType | read_only_udm.target.user.attribute.roles.name | 원시 로그의 UserType 필드에서 직접 매핑됩니다. |
_Internal_WorkspaceResourceId | read_only_udm.security_result.detection_fields.value | 원시 로그의 _Internal_WorkspaceResourceId 필드에서 직접 매핑됩니다. 키가 Internal_WorkspaceResourceId 로 설정됩니다. |
_ItemId | read_only_udm.security_result.detection_fields.value | 원시 로그의 _ItemId 필드에서 직접 매핑됩니다. 키가 ItemId 로 설정됩니다. |
properties.appId | read_only_udm.security_result.detection_fields.value | 원시 로그의 properties 객체 내 appId 필드에서 직접 매핑됩니다. 키가 appId 로 설정됩니다. |
properties.authenticationDetails[].authenticationMethod | read_only_udm.security_result.detection_fields.value | 원시 로그의 authenticationDetails 배열 내 authenticationMethod 필드에서 직접 매핑됩니다. 키가 authenticationMethod 로 설정됩니다. |
properties.authenticationDetails[].authenticationMethodDetail | read_only_udm.security_result.detection_fields.value | 원시 로그의 authenticationDetails 배열 내 authenticationMethodDetail 필드에서 직접 매핑됩니다. 키가 authenticationMethodDetail 로 설정됩니다. |
properties.authenticationDetails[].authenticationStepDateTime | read_only_udm.security_result.detection_fields.value | 원시 로그의 authenticationDetails 배열 내 authenticationStepDateTime 필드에서 직접 매핑됩니다. 키가 authenticationStepDateTime 로 설정됩니다. |
properties.authenticationDetails[].authenticationStepRequirement | read_only_udm.security_result.detection_fields.value | 원시 로그의 authenticationDetails 배열 내 authenticationStepRequirement 필드에서 직접 매핑됩니다. 키가 authenticationStepRequirement 로 설정됩니다. |
properties.authenticationDetails[].authenticationStepResultDetail | read_only_udm.security_result.detection_fields.value | 원시 로그의 authenticationDetails 배열 내 authenticationStepResultDetail 필드에서 직접 매핑됩니다. 키가 authenticationStepResultDetail 로 설정됩니다. |
properties.authenticationDetails[].succeeded | read_only_udm.security_result.action, read_only_udm.security_result.action_details | 원시 로그의 authenticationDetails 배열 내 succeeded 필드에서 직접 매핑됩니다. 값이 true 이면 작업이 ALLOW 로 설정되고, 그렇지 않으면 BLOCK 로 설정됩니다. |
properties.conditionalAccessStatus | read_only_udm.additional.fields.value.string_value | 원시 로그의 properties 객체 내 conditionalAccessStatus 필드에서 직접 매핑됩니다. 키가 conditionalAccessStatus 로 설정됩니다. |
properties.id | read_only_udm.security_result.detection_fields.value | 원시 로그의 properties 객체 내 id 필드에서 직접 매핑됩니다. 키가 id 로 설정됩니다. |
properties.status.errorCode | read_only_udm.security_result.action | 값이 0이면 작업이 ALLOW 로 설정되고, 그렇지 않으면 BLOCK 로 설정됩니다. |
properties.userId | read_only_udm.target.user.userid | 원시 로그의 properties 객체 내 userId 필드에서 직접 매핑됩니다. |
properties.userPrincipalName | read_only_udm.target.user.email_addresses | 원시 로그의 properties 객체 내 userPrincipalName 필드에서 직접 매핑되지만 이메일 주소 패턴과 일치하는 경우에만 매핑됩니다. |
resourceId | read_only_udm.target.resource.name | 원시 로그의 resourceId 필드에서 직접 매핑됩니다. |
시간 | read_only_udm.metadata.event_timestamp.seconds, read_only_udm.metadata.event_timestamp.nanos | 원시 로그의 time 필드에서 직접 매핑됩니다. 이 필드는 타임스탬프로 파싱되며 seconds 및 nanos 필드를 채우는 데 사용됩니다. |
read_only_udm.extensions.auth.type | 값은 AUTHTYPE_UNSPECIFIED 로 설정됩니다. |
|
read_only_udm.metadata.event_type | 값은 principal.ip 및 target.user.userid 필드의 존재 여부에 따라 결정됩니다. 두 필드가 모두 있으면 유형이 USER_LOGIN 로 설정되고, principal.ip 만 있으면 유형이 STATUS_UPDATE 로 설정되며, 그렇지 않으면 GENERIC_EVENT 로 설정됩니다. |
도움이 더 필요하신가요? 커뮤니티 회원 및 Google SecOps 전문가로부터 답변을 받으세요.