Keyboard shortcuts

Press ← or → to navigate between chapters

Press ? to show this help

Press Esc to hide this help

플랫폼, 인증과 인프라의 감사 범주

플랫폼 범주는 요청의 실행 맥락, 사용자와 권한 변경, 인증 정보 및 연산 인프라의 작업을 구분합니다. 아래의 요청 필드는 audit.3의 requestFields, 결과 필드는 resultFields에 해당합니다. 하나의 이벤트에 여러 범주가 함께 기록될 수 있습니다.

요청 맥락

범주의미요청 필드결과 필드
apiGatewayRequestAPI gateway로 들어온 요청입니다. 요청 이름과 출처를 확인하고 같은 traceId의 하류 이벤트를 연결합니다.operationNames(선택): 요청 이름. 배치 요청이면 여러 이름이 있을 수 있습니다.
inApplicationContext외부 애플리케이션에서 시작한 요청입니다.applicationRid(필수): 시작한 앱
inEnrollmentContext하나 이상의 플랫폼 인스턴스 맥락에서 수행한 요청입니다.enrollmentRids(필수): 관련 인스턴스
inHubContextHub-spoke 환경에서 자기 환경 외의 stack 또는 spoke 설정을 조회하는 등의 요청입니다.targetEnvironment(필수): 조회 대상 환경; targetSpokeEnvironment(선택): 대상 spoke 환경targetEnrollment(선택): 대상 인스턴스; targetDomain(선택): 대상 도메인
onBehalfOf대개 서비스 사용자가 다른 사용자를 대신해 실행한 요청입니다.onBehalfOfUserIds(필수): 상류 사용자 목록. 첫 ID가 가장 상류 사용자입니다.
passThrough보통 외부 시스템이 실행 시 감사 파라미터를 결정합니다.passThroughRequestParams(필수)passThroughResponseParams(필수)
internal그 밖의 내부 이벤트입니다. 보통 사용자 행동 조사에서는 신호가 낮습니다.

API gateway가 실제로 수행한 하류 요청은 같은 traceId와, gateway 로그의 service 이름으로 시작하는 userAgent를 함께 사용해 찾습니다. 사용자 시작 요청의 origins와 네트워크 출처의 위조 가능성은 스키마를 참조합니다.

애플리케이션 설정

이 설정은 사용자나 리소스에 연결될 수 있습니다. AppConfigSearch는 정확한 결과 값이 미리 알려져 있지 않거나 가변적인 조회에 사용합니다.

범주동작요청 필드결과 필드
appConfigAccess앱별 설정을 읽습니다.accessedAppConfigIds(필수): 접근한 앱 리소스; accessAppConfigDescription(필수): 접근 설명
appConfigCreate앱별 설정을 만듭니다.createAppConfigDescription(필수): 생성 설명createdAppConfigIds(필수): 생성한 앱 리소스
appConfigDelete앱별 설정을 삭제합니다.deletedAppConfigIds(필수): 삭제한 앱 리소스; deleteAppConfigDescription(필수): 삭제 설명
appConfigSearch앱별 설정을 검색합니다.appConfigSearchQuery(필수): 검색 쿼리appConfigSearchResults(필수): 사용자에게 반환한 결과
appConfigUpdate앱별 설정을 갱신합니다.updatedAppConfigIds(필수): 갱신한 앱 리소스; updateAppConfigDescription(필수): 갱신 설명
systemManagement환경의 앱 배치와 구성을 정하는 메타데이터에 접근하거나 수정한 이전 범주입니다. Audit.3에서는 appConfigCreate, Access, Update, Delete, Search 계열로 대체합니다.

인증과 권한 검사

범주동작요청 필드결과 필드
authenticationCheck토큰 검증 등 수동 또는 프로그램 방식의 인증 상태를 확인합니다.authenticationCheckTargets(선택): 검증할 식별자authenticationCheckResult(필수): 인증 성공 여부; authenticationCheckResultMessage(선택): 결과의 상세 설명
authorizationCheck특정 작업을 할 권한이 있는지 확인합니다.authorizationCheckTargets(선택): 검사 대상; authorizationCheckOperations(필수): 확인하는 권한 등 검사 값authorizationCheckSucceededTargets(필수): 통과 대상; authorizationCheckFailedTargets(필수): 실패 대상; authorizationCheckResultMessage(선택): 상세 설명
oauth2InitiateAuthFlow외부 OAuth 2.0 서버와 Authorization code flow를 시작합니다.oauth2InitiateAuthFlowUser(필수): 승인 절차의 사용자; oauth2InitiateAuthClientId(필수): 클라이언트 ID
userLogin사용자 로그인입니다.loginUserId(선택)
userLogout사용자 로그아웃입니다.logoutUserId(선택)
userJustify사용자가 작업 목적과 사유를 제출합니다.userJustifyId(필수): 사유 제출 사용자; userJustification(필수): 하나 이상의 사유

사용자, 그룹과 접근 요건 관리

범주동작요청 필드결과 필드
managementGroups그룹 소속을 변경합니다.groupPatches(필수)
managementPermissions리소스 공유나 provenance 변경 등 플랫폼 권한을 변경합니다.resourcesWithPermissionsChanges(필수): 권한이 바뀐 리소스; permissionChangeContext(선택): 변경 맥락
managementUsers사용자 존재 여부나 개인 정보를 변경합니다. 권한 변경은 managementPermissions, 그룹 소속 변경은 managementGroups로 구분합니다.managedUserIds(필수)
managementTokens토큰 활성화, 비활성화와 폐기 등을 관리합니다.managedTokens(필수): 영향을 받은 모든 토큰
managementMarkings강제 접근 통제에 대한 자격을 변경합니다.markingPatches(필수)
mandatoryControlManagement강제 접근 통제 관리의 이전 범주입니다. Audit.3에서는 managementMarkings로 대체합니다.
mandatoryControlApplication강제 접근 통제 적용의 이전 범주입니다. Audit.3에서는 managementPermissions로 대체합니다.

과거 audit.2의 managementPermissions 세부 변경은 result_params의 changes에도 기록될 수 있습니다. 이를 audit.3의 동일한 필드로 가정하지 말고 스키마와 범주에 맞춰 해석합니다.

토큰과 비밀값

범주동작요청 필드결과 필드
tokenAccess이미 생성한 토큰에 접근합니다.accessedTokens(필수): 접근한 토큰과 감사 맥락
tokenGeneration새 토큰을 생성하는 작업입니다.generateTokensDescription(선택): 생성 맥락generatedTokens(선택): 생성한 모든 토큰
tokenRevoke토큰을 폐기합니다.revokeTokensDescription(선택): 토큰 작업의 감사 맥락revokedTokens(필수): 폐기한 모든 토큰
secretCreate비밀 문자열을 만듭니다.createdSecretType(필수): 만든 비밀의 종류createdSecretIdentifiers(필수): 만든 비밀의 식별자
secretDeprecate비밀값을 사용 중단 대상으로 표시합니다.deprecatedSecretIdentifier(필수)
secretLoad저장소에서 비밀값을 가져옵니다.loadedSecretIdentifiers(필수)
secretUse백엔드 엔드포인트를 통해 비밀값을 사용합니다.usedSecretOperation(필수): 사용 작업; usedSecretIdentifiers(필수): 사용한 비밀 식별자

코드와 연산 환경

범주동작요청 필드결과 필드
codeExecution코드를 실행합니다. 결과가 DataResource에 저장되지 않을 수도 있습니다.executedResourceEnvironment(필수): liveRID나 workbookRID 같은 실행의 상위 환경executedResources(필수): modelUUID, buildRID 또는 컨테이너 식별자 같은 실제 실행 리소스
cancelCodeExecution진행 중인 코드 실행을 취소합니다.cancelledExecutedResources(필수): 취소 전 실행한 구체적 리소스; cancelledExecutedResourceEnvironment(필수): liveRID나 workbookRID 같은 상위 환경
containerLaunchSpark 모듈 실행처럼 연산 환경을 준비합니다. 가능한 경우 호스트명 같은 위치 식별자를 포함합니다.requestedContainerIdsToLaunch(선택): 시작 요청 대상launchedContainerIds(필수): 실제 시작한 대상
containerLoadSpark 모듈 읽기처럼 연산 환경 정보를 읽습니다. 가능한 경우 위치 식별자를 포함합니다.requestedContainerLoadIds(필수): 요청한 대상loadedContainerLoadIds(필수): 실제 읽은 대상
containerSearchSpark 모듈 목록처럼 연산 환경을 검색합니다.containerSearchQuery(선택): 쿼리containerSearchResults(필수): 사용자에게 반환한 결과
containerStop연산 환경을 종료합니다.stoppedContainerIds(필수): 종료한 대상; containerStopReason(선택): 실패 또는 사용자 요청 같은 설명

인프라 작업

범주동작요청 필드결과 필드
configureInfra노드나 서비스 등의 인프라를 구성합니다.configureInfraTargets(필수): 구성할 SystemResourceconfigureInfraRequestId(필수): 구성 이벤트의 요청 ID
createInfra인프라를 만듭니다.createInfraTargets(필수): 만들 대상createdInfraResources(필수): 더 구체적인 식별자를 가진 생성 결과
infraLogsAccess인프라 리소스의 로그를 요청합니다.infraLogsAccessTarget(필수): 로그를 요청한 SystemResourceinfraLogsAccessRequestId(필수): 요청 ID
restartInfra노드나 서비스를 다시 시작합니다.restartedResources(필수): 재시작한 모든 SystemResource
reviewInfraAction인프라 구성 등의 작업을 승인하거나 거부합니다.reviewInfraActionRequestId(필수): 검토 요청 ID; reviewInfraActionUser(필수): 검토 사용자reviewInfraActionWasApproved(필수): 승인 여부
upgradeInfra다운그레이드를 포함해 인프라 버전을 변경합니다.upgradedResources(필수): 변경한 모든 SystemResource

데이터 범주는 데이터 이동과 공유를, 업무 리소스 범주는 객체 조회와 액션 관련 로직 및 승인 요청을 구분합니다.