Azure AD B2C 감사 로그 액세스

Azure AD B2C(Azure Active Directory B2C)는 B2C 리소스, 발행된 토큰 및 관리자 액세스와 관련하여 작업 정보가 포함된 감사 로그를 전송합니다. 이 문서에서는 감사 로그에서 사용할 수 있는 정보와 Azure AD B2C 테넌트에 대해 이 데이터에 액세스하는 방법에 대한 지침을 간략하게 설명합니다.

감사 로그 이벤트는 7일 동안만 유지됩니다. 더 긴 보존 기간이 필요한 경우 아래에 표시된 방법 중 하나를 사용하여 로그를 다운로드하고 저장하도록 계획합니다.

감사 로그의 B2C 범주에서 사용할 수 있는 활동 개요

감사 로그의 B2C 범주에는 다음과 같은 유형의 활동이 포함됩니다.

사용자 개체 CRUD 작업의 경우 Core Directory 범주를 참조하세요.

예제 활동

Azure Portal의 이 예제 이미지는 사용자가 외부 ID 공급자(이 경우 Facebook)로 로그인할 때 캡처된 데이터를 보여 줍니다.

활동 세부 정보 패널에는 다음과 같은 관련 정보가 포함됩니다.

Azure Portal에서 감사 로그 보기

Azure Portal은 Azure AD B2C 테넌트에서 감사 로그 이벤트에 대한 액세스를 제공합니다.

1. Azure Portal에 로그인합니다.
2. Azure AD B2C 테넌트가 포함된 디렉터리로 전환한 다음 , Azure AD B2C로 이동합니다.
3. 왼쪽 메뉴의 활동 에서 감사 로그를 선택합니다.

지난 7일 동안 기록된 활동 이벤트 목록이 표시됩니다.

다음과 같은 몇 가지 필터링 옵션을 사용할 수 있습니다.

• 활동 리소스 종류 - 사용 가능한 활동 개요 섹션의 표에 표시된 활동 유형을 필터링합니다.
• 날짜 - 표시된 활동의 날짜 범위를 필터링합니다.

목록에서 행을 선택하면 이벤트에 대한 활동 세부 정보가 표시됩니다.

CSV(쉼표로 구분된 값) 파일에서 활동 이벤트 목록을 다운로드하려면 다운로드를 선택합니다.

Microsoft Entra Reporting API를 사용하여 감사 로그 가져오기

감사 로그는 Microsoft Entra ID에 대한 다른 활동과 동일한 파이프라인에 게시되므로 Microsoft Entra Reporting API를 통해 액세스할 수 있습니다. 자세한 내용은 Microsoft Entra Reporting API 시작을 참조하세요.

보고서 API 액세스 활성화

Microsoft Entra Reporting API에 대한 스크립트 또는 애플리케이션 기반 액세스를 허용하려면 다음 API 권한이 있는 Azure AD B2C 테넌트에 등록된 애플리케이션이 필요합니다. B2C 테넌트 내에서 기존 애플리케이션 등록에 대해 이러한 권한을 사용하도록 설정하거나 감사 로그 자동화에 사용할 새 권한을 만들 수 있습니다.

• Microsoft Graph > 애플리케이션 권한 > AuditLog > AuditLog.Read.All

다음 문서의 단계에 따라 필요한 권한으로 애플리케이션을 등록합니다.

Microsoft Graph를 사용하여 Azure AD B2C 관리

적절한 권한으로 애플리케이션을 등록한 후에는 이 문서의 뒷부분에 나오는 PowerShell 스크립트 섹션을 참조하여 스크립트를 사용하여 활동 이벤트를 가져오는 방법에 대한 예제를 참조하세요.

API 액세스

API를 통해 Azure AD B2C 감사 로그 이벤트를 다운로드하려면 범주에 대한 B2C 로그를 필터링합니다. 범주별로 필터링하려면 Microsoft Entra Reporting API 엔드포인트를 호출할 때 쿼리 문자열 매개 변수를 사용합니다 filter .

https://graph.microsoft.com/v1.0/auditLogs/directoryAudits?$filter=loggedByService eq 'B2C' and activityDateTime gt 2019-09-10T02:28:17Z

PowerShell 스크립트

다음 PowerShell 스크립트는 Microsoft Entra Reporting API를 쿼리하는 방법의 예를 보여줍니다. API를 쿼리한 후 기록된 이벤트를 표준 출력에 출력한 다음 JSON 출력을 파일에 씁니다.

Azure Cloud Shell에서 이 스크립트를 사용해 볼 수 있습니다. 애플리케이션 ID, 클라이언트 암호 및 Azure AD B2C 테넌트 이름으로 업데이트해야 합니다.

# This script requires an application registration that's granted Microsoft Graph API permission
# https://learn.microsoft.com/azure/active-directory-b2c/microsoft-graph-get-started

# Constants
$ClientID       = "your-client-application-id-here"       # Insert your application's client ID, a GUID
$ClientSecret   = "your-client-application-secret-here"   # Insert your application's client secret value
$tenantdomain   = "your-b2c-tenant.onmicrosoft.com"       # Insert your Azure AD B2C tenant domain name

$loginURL       = "https://login.microsoftonline.com"
$resource       = "https://graph.microsoft.com"           # Microsoft Graph API resource URI
$7daysago       = "{0:s}" -f (get-date).AddDays(-7) + "Z" # Use 'AddMinutes(-5)' to decrement minutes, for example
Write-Output "Searching for events starting $7daysago"

# Create HTTP header, get an OAuth2 access token based on client id, secret and tenant domain
$body       = @{grant_type="client_credentials";resource=$resource;client_id=$ClientID;client_secret=$ClientSecret}
$oauth      = Invoke-RestMethod -Method Post -Uri $loginURL/$tenantdomain/oauth2/token?api-version=1.0 -Body $body

# Parse audit report items, save output to file(s): auditX.json, where X = 0 through n for number of nextLink pages
if ($oauth.access_token -ne $null) {
    $i=0
    $headerParams = @{'Authorization'="$($oauth.token_type) $($oauth.access_token)"}
    $url = "https://graph.microsoft.com/v1.0/auditLogs/directoryAudits?`$filter=loggedByService eq 'B2C' and activityDateTime gt  " + $7daysago

    # loop through each query page (1 through n)
    Do {
        # display each event on the console window
        Write-Output "Fetching data using Uri: $url"
        $myReport = (Invoke-WebRequest -UseBasicParsing -Headers $headerParams -Uri $url)
        foreach ($event in ($myReport.Content | ConvertFrom-Json).value) {
            Write-Output ($event | ConvertTo-Json)
        }

        # save the query page to an output file
        Write-Output "Save the output to a file audit$i.json"
        $myReport.Content | Out-File -FilePath audit$i.json -Force
        $url = ($myReport.Content | ConvertFrom-Json).'@odata.nextLink'
        $i = $i+1
    } while($url -ne $null)
} else {
    Write-Host "ERROR: No Access Token"
}

다음은 문서 앞부분에 표시된 예제 활동 이벤트의 JSON 표현입니다.

{
    "id": "B2C_DQO3J_4984536",
    "category": "Authentication",
    "correlationId": "aaaa0000-bb11-2222-33cc-444444dddddd",
    "result": "success",
    "resultReason": "N/A",
    "activityDisplayName": "Issue an id_token to the application",
    "activityDateTime": "2019-09-14T18:13:17.0618117Z",
    "loggedByService": "B2C",
    "operationType": "",
    "initiatedBy": {
        "user": null,
        "app": {
            "appId": "00001111-aaaa-2222-bbbb-3333cccc4444",
            "displayName": null,
            "servicePrincipalId": null,
            "servicePrincipalName": "00000000-0000-0000-0000-000000000000"
        }
    },
    "targetResources": [
        {
            "id": "00000000-0000-0000-0000-000000000000",
            "displayName": null,
            "type": "User",
            "userPrincipalName": null,
            "groupType": null,
            "modifiedProperties": []
        }
    ],
    "additionalDetails": [
        {
            "key": "TenantId",
            "value": "test.onmicrosoft.com"
        },
        {
            "key": "PolicyId",
            "value": "B2C_1A_signup_signin"
        },
        {
            "key": "ApplicationId",
            "value": "00000000-0000-0000-0000-000000000000"
        },
        {
            "key": "Client",
            "value": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/76.0.3809.132 Safari/537.36"
        },
        {
            "key": "IdentityProviderName",
            "value": "facebook"
        },
        {
            "key": "IdentityProviderApplicationId",
            "value": "0000000000000000"
        },
        {
            "key": "ClientIpAddress",
            "value": "127.0.0.1"
        }
    ]
}

다음 단계

예를 들어 Microsoft Graph를 사용하여 Azure AD B2C 사용자 계정을 관리하는 등 다른 관리 작업을 자동화할 수 있습니다.