OS 로그인 감사 로그 모니터링

---

OS 로그인 감사 로그를 확인하여 OS 로그인 및 OS 로그인 2단계 인증(2FA)이 사용 설정된 가상 머신(VM) 인스턴스에 대한 연결 시도를 모니터링할 수 있습니다. 이러한 감사 로그는 항상 사용 설정되며 데이터 액세스 구성으로 중지될 수 없습니다.

Google Workspace 관리자 SDK를 사용하여 SSH 키의 추가, 삭제, 업데이트 또는 POSIX 정보의 삭제 같은 OS 로그인 관련 이벤트와 활동을 추적할 수 있습니다.

시작하기 전에

• 아직 인증을 설정하지 않았다면 설정합니다. 인증은 Google Cloud 서비스 및 API에 액세스하기 위해 ID를 확인하는 프로세스입니다. 로컬 개발 환경에서 코드 또는 샘플을 실행하려면 다음과 같이 Compute Engine에 인증하면 됩니다.
  

  Select the tab for how you plan to use the samples on this page:

  Console

  When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

  gcloud

  1. Google Cloud CLI를 설치한 후 다음 명령어를 실행하여 초기화합니다.

     gcloud init

  2. Set a default region and zone.

OS 로그인 감사 로그 보기

OS 로그인 연결 시도 목록을 표시하려면 Cloud 감사 로그를 쿼리합니다.

이 작업에 필요한 권한

이 작업을 수행하려면 다음과 같은 권한이 있어야 합니다.

• 로깅/로그 뷰어 역할 또는 프로젝트/뷰어 역할

OS 로그인 감사 로그 검토

OS 로그인이 사용 설정된 VM에 대한 연결 시도 유형과 해당 연결 시도를 시작한 사용자에 대해 알아보려면 감사 로그의 methodName 및 principalEmail 필드를 검토합니다.

• protoPayload 섹션을 펼쳐 연결 시도의 methodName 필드를 확인합니다. 각 methodName 필드의 의미에 대해 알아보려면 다음 표를 참조하세요.

  메서드	연결 유형	설명
  google.cloud.oslogin.v1.OsLoginService.CheckPolicy	모든 OS 로그인 연결	VM에 대한 연결 시도를 나타냅니다. 2FA가 아닌 연결의 경우 성공적인 응답은 사용자가 VM에 연결했음을 나타냅니다. 2FA 연결의 경우 성공적인 연결은 성공적인 CheckPolicy 호출과 성공적인 ContinueSession 호출로 표시됩니다.
  google.cloud.oslogin.OsLoginService.v1.StartSession	OS 로그인 2단계 인증 연결	새로운 2FA 인증 세션을 나타냅니다. StartSession 호출에서 클라이언트는 자신의 기능을 서버에 선언하고 사용 가능한 본인 확인 질문에 대한 정보를 가져옵니다.
  google.cloud.oslogin.OsLoginService.v1.ContinueSession	OS 로그인 2단계 인증 연결	인증 세션의 연속을 나타냅니다. 클라이언트는 이전 StartSession 호출 또는 요청에서 서버가 제안한 본인 확인 질문을 완료하고 다른 본인 확인 유형을 완료합니다. 그런 다음 ContinueSession 메서드는 본인 확인 질문 또는 메서드에 대한 응답을 수락하고 인증 시도를 인증 또는 거부합니다.

• authenticationInfo 섹션을 펼쳐 principalEmail 필드를 확인합니다. principalEmail 필드에는 VM 연결을 시도한 사용자의 이메일 주소가 표시됩니다.

OS 로그인 감사 로그 속성

다음 섹션에서는 감사 로그의 속성을 설명합니다. 일부 속성은 모든 감사 로그에 공통적이며 다른 속성은 CheckPolicy, StartSession, ContinueSession 메서드에 따라 다릅니다.

일반적인 OS 로그인 감사 로그 속성

다음 표에 나열된 속성은 모든 OS 로그인 감사 로그에서 공통적입니다.

속성	값
serviceName	oslogin.googleapis.com
resourceName	감사 로그가 속한 로그인 요청을 나타내는 프로젝트 번호가 포함된 문자열입니다. 예를 들면 projects/myproject12345입니다.
severity	로그 메시지의 심각도 예를 들면 INFO 또는 WARNING입니다. 심각도 수준에 대한 자세한 내용은 LogSeverity를 참조하세요.
authenticationInfo.principalEmail	메서드가 인증하고 있는 사용자의 이메일 주소입니다.
request.numericProjectId	Google Cloud 프로젝트의 프로젝트 번호입니다.

CheckPolicy 감사 로그 속성

다음 표에 나열된 속성은 CheckPolicy 감사 로그에 적용됩니다.

속성	값
methodName	google.cloud.oslogin.v1.OsLoginService.CheckPolicy
request.@type	type.googleapis.com/google.cloud.oslogin.v1.CheckPolicyRequest
request.policy	확인 중인 권한입니다. LOGIN(사용자가 VM에 로그인할 권한이 있는지 확인) 또는 ADMIN_LOGIN(사용자에게 VM에 대한 관리 액세스 권한이 있는지 확인)입니다.
response.success	LOGIN 또는 ADMIN_LOGIN request.policy 확인 결과입니다. 사용자에게 지정된 정책이 승인되었는지 여부에 따라 true 또는 false입니다.

StartSession 감사 로그 속성

OS 로그인 2단계 인증이 사용 설정된 VM의 경우 다음 표에 나열된 속성이 StartSession 감사 로그에 적용됩니다.

속성	값
methodName	google.cloud.oslogin.OsLoginService.v1.StartSession
request.@type	type.googleapis.com/google.cloud.oslogin.OsLoginService.v1.StartSessionRequest
request.supportedChallengeTypes	선택 가능한 질문 유형 또는 2FA 방법의 목록입니다.
response.authenticationStatus	세션 Authenticated, Challenge required, Challenge pending 중 하나입니다.
response.sessionId	세션을 고유하게 식별하는 ID 문자열입니다. 이 세션 ID는 시퀀스의 ContinueSession 호출에 전달됩니다.
response.challenges	이 인증 단계 중에 통과할 수 있는 일련의 본인 확인 질문입니다. 이러한 질문 중 최대 한 개가 시작되고 READY 상태가 됩니다. 나머지 질문은 사용자가 제안된 기본 질문 대안으로 지정할 수 있는 옵션으로 제공됩니다.

ContinueSession 감사 로그 속성

OS 로그인 2단계 인증이 사용 설정된 VM의 경우 다음 표에 나열된 속성이 ContinueSession 감사 로그에 적용됩니다.

속성	값
methodName	google.cloud.oslogin.OsLoginService.v1.ContinueSession
request.sessionId	이전 세션을 고유하게 식별하는 ID 문자열입니다. 이 세션 ID는 StartSession 호출에서 전달됩니다.
request.@type	type.googleapis.com/google.cloud.oslogin.OsLoginService.v1.ContinueSessionRequest
request.challengeId	시작하거나 실행할 질문을 식별하는 ID 문자열입니다. 이 ID는 StartSession 응답의 response.challenges 호출에서 반환된 본인 확인 질문 유형에 속해야 합니다.
request.action	본인 확인 질문을 완료하기 위해 수행할 작업입니다.
response.authenticationStatus	세션 예를 들면 Authenticated, Challenge required, Challenge pending입니다.
response.challenges.status	SUCCESS는 사용자가 VM에 성공적으로 연결되었음을 나타냅니다.
response.challenges	이 인증 단계를 통과할 수 있는 일련의 본인 확인 질문입니다. 이러한 질문 중 최대 한 개가 시작되고 READY 상태가 됩니다. 나머지 질문은 사용자가 제안된 기본 질문 대안으로 지정할 수 있는 옵션으로 제공됩니다.

다음 단계

• OS 로그인 감사 로그 쿼리를 맞춤설정하는 Logging 쿼리 언어 자세히 알아보기
• Compute Engine에서 Linux VM에 대한 SSH 연결이 작동하는 방식 알아보기