본문으로 건너뛰기

프로젝트 설정 (Project Settings)

Project Settings는 현재 General, AWS Connection, Scheduled Runs, Project Members, Data Location 다섯 개의 탭으로 구성됩니다.

이 문서는 그중 AWS Connection, General, Scheduled Runs 탭과, 모든 실행 기록을 모아 보는 Run History 화면을 설명합니다.

Project Settings는 다음 설정 영역으로 구성됩니다.

  • General – 프로젝트 기본 정보 관리, 이 프로젝트의 알림 음소거, AWS 계정 소유자·팀·IAM 분석 대표 표시
  • AWS Connection – AWS 계정 연동 설정 (선택적으로 Encryption Key(BYOK)·Data Storage 연결 포함)
  • Scheduled Runs – 동기화·평가·IAM 분석을 정해진 주기로 반복 실행하도록 예약
  • Project Members – 프로젝트 사용자 관리
  • Data Location – 이 연결의 데이터 위치 리포트(데이터 위치 참고)

알림은 별도 탭이 아니라 General 탭 안의 음소거 설정입니다. 알림 채널·수신 항목은 조직 포털의 Notifications 페이지에서 관리합니다.

이 문서는 AWS Connection 설정 절차를 중심으로 설명합니다. AWS 계정을 연결하면 같은 영역에서 민감 데이터를 고객 소유 스토리지에 보관하는 Encryption Key(BYOK)·Data Storage를 선택적으로 설정할 수 있습니다. 자세한 내용은 데이터 보안을 참고하세요.

1. AWS Connection 개요​

AWS Connection은 사용자의 AWS 계정과 RMF 서비스를 안전하게 연결하는 과정입니다.

  • 계정 연동이 완료되어야 Asset Synchronization에서 Resource Explorer 기반의 자산 탐색 범위를 확장할 수 있습니다.
  • 연결 과정에서 AWS 자격 증명(Access Key/Secret)을 직접 공유하지 않고 연동합니다.

2. 사전 준비: Resource Explorer 활성화​

AWS Connection을 진행하기 전에 사용자의 AWS 계정에서 Resource Explorer를 먼저 활성화해야 합니다.

Resource Explorer는 AWS 계정 내의 리소스를 리전 간에 통합 검색할 수 있는 서비스입니다. Security Hero RMF는 이 서비스를 통해 자산을 탐색하므로, 활성화되어 있지 않으면 동기화가 정상적으로 동작하지 않습니다.

활성화 절차​

  1. AWS 콘솔에 로그인합니다.
  2. Resource Explorer 서비스로 이동합니다.
  3. Resource Explorer가 아직 활성화되지 않은 경우 Turn on Resource Explorer 버튼을 클릭합니다.

Resource Explorer 활성화

  1. Setup 유형에서 Quick setup 또는 원하는 옵션을 선택하고 활성화를 완료합니다.
  2. Aggregator index가 생성되는 리전을 확인합니다. (보통 현재 리전에 생성됩니다.)
주의

Resource Explorer 활성화 후 인덱싱이 완료되기까지 수 분이 소요될 수 있습니다. 활성화 직후에는 일부 리소스가 검색되지 않을 수 있으므로, 잠시 기다린 후 AWS Connection을 진행하세요.

자세한 내용은 AWS Resource Explorer 공식 블로그를 참고하세요.

3. 연결 절차 (3단계)​

3.1. AWS Account ID 입력​

연걸 Preview

사용자의 AWS Account ID를 입력합니다.

  • 입력한 Account ID는 AWS 계정 식별 및 연동 대상 확인에 사용됩니다.
  • 목적은 자격 증명 공유 없이 Security Hero RMF와 계정을 연결하는 것입니다.

3.2. CloudFormation Stack 생성​

연걸 Preview

Account ID 입력 후, AWS 콘솔에서 연동용 IAM Role을 생성합니다.

  • 서비스에서 제공하는 CloudFormation Template를 사용해 Stack 생성
  • Stack 생성 과정에서 RMF 연동에 필요한 IAM Role/권한 구성
  • 수동 생성 대비 설정 누락을 줄이고 연동 과정을 표준화

3.3. 연결 상태 확인​

AWS Connection 연결 상태

Stack 생성이 정상 완료되면 AWS 계정과 RMF 서비스 연결이 완료됩니다.

  • 연결 성공 시 이후 동기화 작업에서 확장된 자산 스캔 가능
  • 연동 상태는 AWS Connection 화면에서 확인 가능

4. 운영 팁​

  • 연동 이후 Sync Scope를 조정해 필요한 서비스/리소스만 선택적으로 스캔
  • CloudFormation Stack 변경 시 IAM Role 권한 영향 여부를 함께 점검

5. General 탭​

General 탭에는 프로젝트 이름·설명·알림 설정 외에 AWS account ownership 영역이 있습니다. 이 영역은 Standard 플랜의 연결에도 표시되며, 다음 항목으로 구성됩니다. 조직 관련 동작은 조직 문서를 참고하세요.

General 탭의 AWS account ownership 영역

  • 소유자(Owner) / 팀(Team) – 이 계정을 책임지는 사람·팀을 적어 두는 자유 입력 항목입니다. 조직 발견으로 만들어진 연결은 AWS 계정 태그(Owner/Team) 값이 기본으로 채워지며, 이후 언제든 직접 고쳐 쓸 수 있습니다. 이 값은 그 계정에서 새로 발견되는 위험 항목의 기본 담당자로도 쓰입니다.
  • IAM 분석 대표(IAM analysis primary for this account) – 같은 AWS 계정을 리전별로 여러 개 연결했을 때, IAM 권한 분석을 담당하는 연결인지 표시합니다. 계정마다 정확히 하나의 연결만 켜져 있을 수 있으며, 다른 연결에서 이 표시를 켜면 기존 대표 표시는 자동으로 꺼집니다. 끄기만 하는 것은 같은 계정의 다른 연결이 이미 대표를 가지고 있을 때만 가능합니다 — 계정에 대표가 하나도 없는 상태는 만들 수 없습니다. 자세한 내용은 조직 문서의 대표 연결 설명을 참고하세요.

연결 종류(관리 계정·멤버 계정)는 General 탭이 아니라 AWS Connection 탭의 연결 상태 옆에 배지(예: Member account)로 표시됩니다.

6. Scheduled Runs 탭​

Scheduled Runs 탭에서는 연결 하나에 대해 동기화·평가(스캔)·IAM 분석 등을 정해진 주기로 자동 실행하도록 예약할 수 있습니다. Add a schedule로 예약을 추가합니다.

Scheduled Runs 탭

  • 실행 종류 – 예약할 대상(동기화·평가·IAM 분석 등)을 고릅니다.
  • 주기 – Daily(매일)·Weekly(매주)·Monthly(매월)·Quarterly(분기) 중 하나를 고르거나, 직접 cron 표현식을 입력합니다. 시작 시각은 사용자가 지정한 타임존 기준이며, 따로 지정하지 않으면 02:00에 시작합니다.
  • 켜기/끄기 – 예약을 끄면 설정은 남고 더 이상 실행되지 않습니다. 삭제하면 그 예약 자체가 없어지지만, 그동안 그 예약으로 실행된 기록은 Run History에 그대로 남습니다.
  • Critical function 자산이 있을 때만 실행 – 이 연결에 critical function으로 표시된 자산이 하나도 없으면 그 회차는 실행하지 않고 건너뜁니다. 건너뛴 회차도 사유와 함께 기록됩니다.

예약이든 + New Scan처럼 사용자가 직접 누른 것이든, 모든 실행 결과는 연결의 Run History(실행 이력) 화면에서 확인할 수 있고, 무엇이 그 실행을 시작시켰는지(수동/예약/API)도 함께 표시됩니다. 자세한 내용은 7. Run History를 참고하세요.

7. Run History (실행 이력)​

Run History는 좌측 메뉴 Risk Management 그룹에 있는 화면으로, 이 연결에서 실행된 모든 스캔·동기화·IAM 분석을 누가 시작했든(직접 실행·예약·API) 한곳에 기록합니다. 스캔 직후 플랫폼이 스스로 대기열에 넣는 후속 계산 단계도 함께 남습니다. 감사인에게 "무엇이 언제 실행되었고, 실제로 무언가를 했는가"를 보여 주는 기록이기도 합니다.

7.1. 바로 실행 (Run now)​

화면 오른쪽 위의 선택 상자에서 Compliance scan·Resource sync·IAM analysis 중 하나를 고르고 Run now를 누르면 대기열에 등록됩니다. 등록되면 <종류> queued 알림이 뜹니다. 실행되지 않고 기록만 남은 경우에는 <종류> was not started 알림과 함께 그 사유(아래 건너뜀 사유 표)가 표시됩니다.

읽기 전용 사용자(Viewer)와 감사인은 Run now를 쓸 수 없습니다.

7.2. 목록과 필터​

목록 위 필터로 범위를 좁힐 수 있습니다.

  • 실행 종류 – Everything(전체), Compliance scan, Resource sync, IAM analysis, Exposure paths(스캔 직후 자동으로 실행되는 후속 계산 단계)
  • 결과 – Any outcome(전체), Queued, Running, Succeeded, Failed, Timed out, Skipped
  • Refresh – 목록을 다시 불러옵니다.
컬럼내용
What ran실행 종류와 실행 ID 앞부분
Asked for by시작한 주체 — By hand(직접 실행), Schedule(예약), API
Outcome현재 상태. Skipped이면 건너뛴 사유가, 실패이면 오류 코드가 옆에 함께 표시됩니다.
Due at예약 실행이 원래 예정된 시각
Recorded실행이 기록된 시각
Last change상태가 마지막으로 바뀐 시각
Result결과 화면 링크 — 스캔은 Assessment(위험 평가 결과), 동기화는 Sync jobs, IAM 분석은 Analysis

한 페이지에 25개씩 표시되며 Newer / Older로 넘깁니다. 기록이 없으면 No runs recorded yet. Start one above, or set up a schedule in project settings.가 표시됩니다.

건너뜀(Skipped) 사유​

Skipped는 실패가 아니라 실행하지 않고 그 사유만 기록했다는 뜻입니다.

화면 표시의미
No scans left on this plan플랜의 평가(스캔) 횟수를 모두 썼음(구독 참고)
Storage is not connected yet고객 소유 저장소(S3·KMS) 연결이 끝나지 않음(데이터 보안 참고)
Held back by the run budget실행 한도에 걸려 보류됨
The schedule is turned off예약이 꺼져 있음
The connection is gone연결이 삭제됨
A run of this kind was already going같은 종류의 실행이 이미 진행 중이었음
Another connection already covers this AWS account for account-level analysis같은 AWS 계정의 다른 연결이 IAM 분석 대표임(조직 문서의 대표 연결 참고)

7.3. 실행 상세​

행을 누르면 오른쪽에 상세 패널이 열립니다.

  • 상태, Asked for by, Requested by(요청한 사용자), From schedule(예약 실행일 때 그 예약 번호), Due at, Recorded, Started, Finished, Took(걸린 시간)과 결과 화면 링크
  • Tool – 사용한 도구의 이름·버전·점검 수·프레임워크 수(기록된 경우)
  • What this run measured – 그 실행이 남긴 수치(예: 스캔한 자원 수, 새로 생긴 문제 수, 사라진 문제 수, 다시 나타난 문제 수)
  • How it got here – 상태가 바뀐 순서. 각 단계에 시각과, 부분 결과만 남았으면 partial results, 스캐너가 바뀌었으면 scanner changed, 오류가 있었으면 그 메시지가 표시됩니다. 각 단계 아래의 짧은 해시는 아래 무결성 확인에 쓰이는 값입니다.

7.4. 기록 무결성 확인 (Check the record)​

실행 기록은 각 상태 변경이 직전 기록의 해시를 이어받는 해시 사슬로 저장됩니다. Check the record를 누르면 이 연결의 기록 전체를 다시 검증해 결과를 화면 위에 표시합니다.

  • All N recorded state changes are intact. – 기록이 그대로입니다.
  • The record does not verify after checking N state changes. – 기록이 검증되지 않습니다. 사슬이 처음 끊긴 항목 번호가 함께 표시됩니다.
  • 아직 기록이 없으면 No runs recorded for this connection yet. There is nothing to check.가 표시됩니다.

같은 검증 결과는 증빙 패키지의 ledger-verify.json에도 담깁니다.