제로 트러스트 평가 문제 해결

제로 트러스트 평가의 연결 실패, 건너뛴 검사, 느린 실행, 종속성 충돌 및 보고서 문제를 조사합니다. 영향을 받은 단계부터 시작한 다음, 증상별 검사로 문제가 해결되지 않으면 진단 정보를 수집합니다. 조사를 위해 PowerShell 세션 또는 사용 가능한 진단을 보관해 두세요.

시작하기 전에 평가 결과, PowerShell 버전, 실행 범위 및 오류 요약을 수집하세요. 필요한 정보는 사전 요구 사항을 참조하세요.

Prerequisites

  • 평가 PowerShell 세션(아직 사용 가능한 경우) 또는 생성된 진단
  • 평가 및 PowerShell 버전, 선택한 핵심 요소 및 테스트 ID, 영향을 받는 단계 및 오류 요약입니다.

문제 해결 검사 목록

사용 권한, 종속성 또는 시간 제한을 변경하기 전에 실패 단계를 식별합니다.

영향을 받는 단계를 식별하세요

관련 진단을 선택할 수 있도록 어느 평가 단계에서 실패했는지 식별합니다.

  1. 연결 메시지 및 실행별 진단 파일을 검토하여 연결, 내보내기, 데이터베이스 만들기, 테스트 또는 보고서 처리 중에 문제가 발생하는지 여부를 식별합니다.
  2. 평가 버전, PowerShell 버전, 선택한 핵심 요소 및 테스트 ID, 그리고 민감 정보가 제거된 오류 요약을 기록합니다.
  3. 재개를 사용할 수 있는 경우 완료된 내보내기 및 데이터베이스를 유지합니다.

액세스 및 커버리지 확인

증상 표를 사용하여 다음 검사를 선택합니다. 성공적인 Microsoft Graph 연결이 자동으로 다른 모든 서비스까지 설정되는 것은 아니며, 건너뛴 검사가 보안 구성의 증거가 아닙니다.

증상 확인할 사항
Graph 동의 또는 역할 유효성 검사에 실패합니다. Get-ZtGraphScope와 권한 부여를 비교하고, 필요한 사용자 역할을 활성화하거나 앱 권한을 구성한 후 다시 연결합니다. 새 패키지에는 추가 동의가 필요할 수 있습니다.
서비스가 연결되지 않거나 테스트가 건너뛰어집니다. 서비스의 역할, 라이선스, 플랫폼 및 연결 메시지를 확인합니다. 연결 지침을 참조하세요.
보호, 레이블, DLP(데이터 손실 방지) 또는 헌팅 검사는 권한 부여 오류를 반환합니다. Microsoft Entra ID 역할 이름뿐만 아니라 명령 또는 API에 대한 워크로드 역할 할당 및 데이터 범위를 확인합니다. 액세스 테이블을 사용하세요.
인프라에는 발견된 항목이 없습니다. Azure 읽기 액세스와 구독 태그를 확인합니다. 태그가 지정되었거나 액세스 가능한 구독이 없으면 평가를 통과하지 못합니다.
런타임이 길거나, 요청이 제한되거나, 메모리 압력이 증가합니다. 수집기 및 테스트 로그를 검사합니다. 구성 설정에서 룩백, 동시성, 캐시 및 시간 제한을 검토합니다.
인증서 연결이 실패합니다. 인증서 유효성/프라이빗 키, 앱 공개 키 등록, 테넌트 GUID, 동의 및 서비스 주체 역할을 확인합니다. SharePoint 현재 커넥터에도 내보내기 가능한 키가 필요합니다.
제한된 언어 모드는 실행을 방지합니다. 평가를 지원하는 승인된 호스트/정책을 사용합니다. 조직 제어를 무시하지 마세요. 고급 재정의로도 제한된 작업이 작동하게 되지는 않습니다.

원인 및 해결 방법

종속성 및 보고 오류에 대해 다음 절차를 사용합니다. 해결 방법을 선택하기 전에 영향을 받는 버전을 확인합니다.

그래프 어셈블리 충돌 해결

Could not load file or assembly Microsoft.Graph.Authentication의 경우, 공유 모듈을 제거하는 대신 새 프로세스로 시작합니다.

  1. 새 pwsh -NoProfile 프로세스를 시작합니다.
  2. 평가가 다른 클라우드 모듈보다 먼저 고정된 종속성을 로드하도록 하세요.
  3. 문제가 지속되는 경우 종속성 캐시 및 정리 호스트 지침을 확인합니다.

설치된 다른 모듈은 자동으로 충돌하지 않지만 이미 로드된 어셈블리는 호환되지 않을 수 있습니다. 모듈을 제거하거나 다시 가져와도 어셈블리가 안정적으로 언로드되지는 않습니다. 기본 해결책으로 공유 Graph 모듈 및 타사 정리 스크립트를 일괄 제거하는 것은 피하십시오.

DuckDB 초기화 오류 해결

오류 The type initializer for 'DuckDB.NET.Data.DuckDBConnectionStringBuilder' threw an exception 의 근본 원인은 다를 수 있습니다.

  1. 내부 예외를 검사합니다. Windows에서 DllNotFoundException용 duckdb는 누락된 네이티브 종속성을 나타낼 수 있습니다.
  2. 누락된 경우 Microsoft Visual C++ 재배포 가능 패키지(x64)를 설치합니다.
  3. 새 PowerShell 세션에서 다시 시도합니다. 모든 데이터베이스 오류의 원인이 동일하다고 가정하지 마세요.

보고서 렌더링 오류에서 복구

이전 보고서에는 Unexpected Application Error! Invalid array length이(가) 표시될 수 있습니다. 관련 보고서에는 microsoft/zerotrustassessment#1235, microsoft/zerotrustassessment#1272, microsoft/zerotrustassessment#1310 및 microsoft/zerotrustassessment#1388이 포함됩니다.

  1. 버전에 대한 문제 및 릴리스 기록을 확인합니다. 시험판이 항상 필요하다고 가정하지 마세요.
  2. 내보내기 및 데이터베이스 만들기가 완료된 경우 해당 항목을 보존하십시오.
  3. 적용 가능한 수정 사항을 설치한 후 다시 연결하고 원래 경로 및 pillar와 함께 -Resume를 사용하여 평가 및 보고서 처리를 다시 실행합니다.
  4. 클래식 HTML 보고서가 성공적으로 생성된 경우 사용합니다.

평가 활동 확인

PowerShell 원본, 진행률 대시보드 및 실행별 로그를 검토하여 평가 활동을 이해합니다. 업스트림 고급 문제 해결 가이드 에서는 지원 패키지 분석에 대해 설명합니다.

고급 문제 해결 및 데이터 수집

진단마다 포착하는 단계가 다릅니다. 데이터를 수집하거나 공유하기 전에 실패와 일치하는 위치를 선택합니다.

로그 및 진단 파일

<Path>은 Invoke-ZtAssessment -Path에 전달하는 디렉터리 또는 기본값인 .\ZeroTrustReport 디렉터리입니다. 선택적 지원 패키지, 실행당 파일 및 확장된 PSFramework 로그는 세 개의 별도 진단 위치입니다.

위치 내용 및 사용
<Path>\log\ 성공적으로 완료되기 직전에 -ExportLog에서 생성된, .cliDat 스냅샷을 포함하는 PSFramework 지원 패키지 ZIP입니다. 스위치가 사용되지 않았거나 이 단계 전에 실행이 실패한 경우 없을 수 있습니다.
<Path>\zt-export\logs\<run>\1-export_progress.log 수집기 진행률 및 상태를 내보냅니다. 데이터 수집 문제의 경우 여기에서 시작하세요.
<Path>\zt-export\logs\<run>\2-database_progress.log 데이터베이스 빌드 진행률 및 타이밍 재개는 이 단계를 건너뜁니다.
<Path>\zt-export\logs\<run>\3-test_progress.log 평가 실행 진행률 및 상태입니다.
<Path>\zt-export\logs\<run>\1-Export\export_<Name>.md 수집기 상태, 기간, 타임스탬프, 엔드포인트/유형, 모듈 버전 및 진단 메시지.
<Path>\zt-export\logs\<run>\2-Tests\<TestID>.md 테스트 제목, 상태, 기간, 타임스탬프, 모듈 버전 및 쿼리 텍스트를 포함할 수 있는 자세한 메시지.
%APPDATA%\PowerShell\PSFramework\Logs\Windows 출력 경로와 관계없이 확장 메시지 로그 및 XML 오류 레코드 연결/가져오기 문제, 예외, 원본 위치, 스택 추적 및 개별 테스트와 무관한 메시지에 유용합니다.

<run> 에서는 타임스탬프 형식 yy-MM-dd-HHmmss을 사용합니다. 각 단계가 실행됨에 따라 파일이 나타납니다. 부분 실행 또는 다시 시작된 실행에는 모든 파일이 포함되지 않아도 됩니다. 실행당 파일은 -ExportLog와는 독립적으로 생성됩니다.

확장된 PSFramework 파일에는 컴퓨터/프로세스 식별자 및 번호가 매겨진 세그먼트(예: <computer>_<pid>_message_0.log 및 <computer>_<pid>_error_0.xml)가 포함됩니다. 가용성 및 보존은 로깅 공급자 구성에 따라 달라집니다.

Windows에서 %APPDATA%는 일반적으로 %USERPROFILE%\AppData\Roaming인 사용자의 로밍 폴더를 식별합니다. PowerShell에서 $env:APPDATA을 사용하세요. 해당 로그 경로는 Join-Path $env:APPDATA 'PowerShell\PSFramework\Logs'입니다.

나머지 <Path>\zt-export는 로그만이 아니라 내보낸 엔터티, ztConfig.json, db\zt.db, ZeroTrustAssessmentReport.json, 그리고 ZeroTrustWorkshop.json를 포함한 평가 데이터입니다. 이러한 파일은 실행을 재현하거나 다시 시작하는 데 도움이 되지만 민감한 테넌트 데이터를 포함할 수 있습니다. <Path>를 삭제해도 별도의 PSFramework 로그는 제거되지 않습니다.

지원 패키지 캡처

실행이 선택적 지원 패키지를 만들기 전에 실패하면 세션을 닫기 전에 동일한 PowerShell 세션에서 진단을 캡처하세요.

  1. 진단 패키지에 대해 별도의 대상 위치를 선택합니다. 평가 출력 경로와 일치시킬 필요가 없습니다. 예제 대상을 이번 실행용 폴더로 바꾸세요.

    New-PSFSupportPackage -Path C:\AssessmentLogs\Run01 -Force
    
  2. 생성된 ZIP 파일의 압축을 풀어 .cliDat 파일에 액세스할 수 있습니다.

  3. 공유하기 전에 진단 정보를 검토하고 민감한 정보를 삭제하거나 가립니다. 스냅샷을 가져오고 조사하려면 고급 로그 분석 가이드를 참조하세요.

지원 패키지 스냅샷에는 메시지 및 오류 기록과, 경우에 따라 명령 기록이나 콘솔 출력을 포함한 사용 가능한 세션 진단 정보가 포함됩니다. 내보낸 모든 테넌트 파일의 자동 보관 파일이 아닙니다.

Warning

보고서, 내보내기, 지원 패키지 및 확장 로그에는 개인 정보, 테넌트 식별자, 쿼리 값 및 구성 세부 정보가 포함될 수 있습니다. 검토하지 않은 파일들을 공개 GitHub 이슈에 첨부하거나 승인되지 않은 도구에 업로드하지 마세요. 추가 진단 정보는 수신자와 합의한 승인된 비공개 채널을 통해서만 공유하세요.

문제 보고 또는 피드백 제공

GitHub 문제를 검색하거나 등록하거나 피드백 채널을 사용하세요. 평가 버전, PowerShell 버전, 선택한 핵심 요소 및 테스트 ID, 영향을 받는 단계 및 민감한 정보를 제거한 오류 요약을 포함합니다.

이 평가는 Microsoft의 공식 제품이 아니라 커뮤니티 프로젝트입니다. 커뮤니티 문제 보고는 지원 계약이나 응답 보장이 아닙니다. 진단을 공유하기 전에 지원 정책을 읽어 보세요.