시작하기
- InfraGuard 시작하기InfraGuard 가 무엇이고 어떤 문제를 해결하는지, 그리고 이 설명서를 어떻게 쓰는지 5분 안에 파악합니다.
- 이 설명서 검색하기자동완성 검색과 ⌘K 커맨드 팔레트로 궁금한 점을 즉시 찾는 방법.
- 로그인 · 인증콘솔 세션 로그인, 매 요청 세션 재동기화, 외부 인제스트 API 키 인증을 설명합니다.
- 권한 등급 (demo · staff · admin)user_level 정수와 메뉴의 min_req 를 비교하는 InfraGuard 의 단일 접근 제어 모델.
- 역할 · 팀 · 담당자역할과 팀은 정보성 라벨이며 접근은 오직 등급이 결정합니다 — 사용자·팀 통합 담당자(Owner) 선택기까지 설명합니다.
- 탐색 · 역할 우선 메뉴역할별로 먼저 나뉘고 DB(infr_sitemap + min_req)로 구동되는 InfraGuard 메뉴 체계 — 8개 역할 영역과 권한 경계를 설명합니다.
- 라이트 / 다크 테마콘솔의 밝은·어두운 테마 전환 — 루트의 data-theme 속성, localStorage(infr-theme) 영속, 헤더 토글, 모든 색은 --infr-* CSS 변수 토큰.
- 언어 전환 · 다국어InfraGuard 콘솔의 표시 언어를 바꾸는 방법 — 8개국어, 관리자가 켠 활성 언어, 그리고 세션→쿠키→프로필→사이트 기본 순의 결정 규칙.
- 실시간 업데이트 (Reverb + 폴링)화면이 자동으로 갱신되는 두 가지 방법 — Reverb WebSocket 즉시 푸시와 경량 폴링(30초 · rev 변경감지) — 과 WS가 꺼져도 끊기지 않는 graceful 폴백 원리.
- 개요(Overview) 랜딩 읽기가용성·보안 합성 스코어, KPI 카드, 탐지 도넛, 풀폭 서버 스트립을 한 화면에서 읽고 라이브로 갱신되는 통합 관제 랜딩입니다.
- 내 프로필내 계정 정보를 확인하고, 본인 비밀번호를 직접 변경하는 셀프 서비스 화면입니다.
- 공개 랜딩 · 데모 요청 · 방문자 분석 태그로그인 없이 열리는 공개 표면(랜딩·데모 폼·사용 설명서)과 그 방문자를 측정하는 GA4/GTM 태그, 그리고 접수된 데모 요청을 처리하는 관리 화면을 다룹니다.
DBA
- 서비스 ▸ 데이터베이스등록된 DB에 직접 연결해 SHOW GLOBAL STATUS와 information_schema로 실시간 부하(동시성·처리량)와 스키마 구조를 관제합니다.
- DB 튜닝 개념 — 락·캐시·인덱스·체크포인트·메모리Service ▸ Database 화면의 교육용 hover 팝오버가 가르치는 DB 성능 개념(행 락 대기 7원인·버퍼풀 캐시 적중·인덱스 사용률·체크포인트/redo 압력·dirty 페이지 flush)을 요약합니다.
- 세션 (Redis)내부망 대표 수집기가 적재한 노드별 Redis 세션·캐시 상태(수용률·처리량·적중률·메모리 관리·키스페이스)를 직접 연결 없이 읽어 관제합니다.
- Redis 튜닝 개념 (세션 관제 교육)Service ▸ Sessions 화면의 Redis 지표를 해석하는 개념 안내 — slowlog 7대 원인, 적중률, 메모리 단편화 건강 대역, 만료 대 축출.
- 데이터베이스 수집기 등록access=database 수집기를 호스트별 db@alias 행으로 등록해 Service ▸ Database·경보를 구동하고, 비밀번호는 Crypt 로 저장하거나 cred_ref=env:PREFIX 로 재사용합니다.
DevOps
- 인프라 헬스 보드노드별 부하·CPU·메모리·디스크와 nginx/php/mysql/mongo 서비스 상태를 한 화면에서 라이브로 관제합니다.
- 서버 (부하 시계열)서버별 부하·CPU·메모리를 링 게이지와 시계열 차트로 한눈에 보는 Infrastructure ▸ Servers 화면.
- 스토리지 & RAIDRAID 컨트롤러 건전성(Optimal/Degraded/Failed)·물리 디스크 맵·호스트 디스크 사용률을 한 화면에서 라이브로 관제하는 읽기 전용 대시보드입니다.
- 포트 연결 (PORT OVERVIEW)감시 포트별로 서버 TCP 상태 분포·상위 소스 IP·연결 강도를 라이브 카드로 보여주는 플래그십 포트 관제 화면.
- IP 연결 (IP Connections)서버별 원격 peer IP를 포트 강도 도트로 보고, IP를 클릭해 접속 분포·기간 이력·지오/ASN·평판·차단까지 조사하는 host view 콘솔.
- 트래픽 (네트워크 I/O)server_traffic 의 인/아웃 바이트·패킷 처리량을 서버별 ECharts 선그래프로 노출 — 레거시가 수집만 하고 못 보여주던 데이터.
- 경보 (Alerts)시스템·웹·DB·보안 조건을 묶은 경보 그룹(정책)을 만들고, 위반 시 담당자에게 SMS/메일로 자동 알림을 보냅니다.
- 서비스 개요 — 큐레이션 라이브 보드운영자가 관심 서비스(웹·DB·세션·프록시·Docker)를 우선순위 카드로 골라 배치하고 가용성 게이지와 라이브 시계열로 관제하는 서비스 보드입니다.
- 웹 서비스 관제등록한 웹사이트를 nginx-vts 카운터로 라이브 관제하고, 능동 합성 프로브로 24시간 가동율·다운타임·TLS 인증서 만료를 추적합니다.
- 방문자·검색 유입 분석등록 웹사이트 카드에서 GA4 방문자 분석과 Search Console 검색 유입을 사이트별 서비스 계정으로 직접 조회합니다. 자격·속성은 사이트마다 따로 저장합니다.
- 서비스 카탈로그인스턴스 버전 원장의 데몬성 소프트웨어를 [분석 및 빌드]로 서비스(infr_service)에 자동 구성하고, 라이브니스·의존성·설정값을 한 콘솔에서 관리합니다.
- 프로젝트 (Service ▸ Projects)작업자가 공유할 프로젝트 메타데이터 레지스트리 — 소스(GitHub)·CI/CD(Jenkins)·web/db 연결·백업 대상·기밀 참조를 등록합니다(배포 도구 아님).
- 문제 해결 (인시던트 케이스)장애·오류를 케이스로 등록해 등록→분석→원인판명→해결→종료 순으로 추적하고, 직접·배경 원인과 조치·재발 방지를 기록하는 인시던트 워크플로우입니다.
- 백업 스케줄 보드백업 계획의 일정·저장 위치·다음 실행·최근 성공 이력을 한 화면에서 보는 읽기 전용 시각화(오브젝트/달력 2모드 + 보관소 CRUD).
- 백업 스크립트등록된 백업 스크립트를 그리드로 관리합니다 — 러너 실행 대상(is_run) 켜기/끄기·삭제, 버전·체크섬이 붙은 생성 스크립트 열람.
- 백업 스크립트 빌더프로젝트 정의에서 대상을 프리필해 mysqldump·rsync 백업 스크립트 골격을 생성하고, "N U" 스케줄과 함께 작업·스크립트 버전을 저장합니다.
- 백업 보관소(Vaults)백업 파일이 저장되는 보관소(저장 대상)를 카드로 관리하고 저장량·용량·오프사이트(3-2-1)를 한눈에 봅니다.
- 복구 & 검증성공한 백업 실행을 복구지점으로 목록화하고, 유형별 복원 명령을 안내하며, sha256 무결성 검증 결과를 infr_restore_run 에 기록합니다.
- 백업 리포트 콜백 (report-callback)대상 호스트의 백업 스크립트가 실행 결과를 POST /api/v1/backup/report 로 보고하면 infr_backup_run(+backup_history)에 기록되고 잡 상태가 갱신되는 무상태 인제스트 계약입니다.
- 인벤토리 (주머니)장애·침해 상황에서 즉시 꺼내 쓰는 스크립트(Tools)·명령어(Snippets)·가이드 문서(Docs)·팀 공유 키(Keys)를 한 곳에 담아두고 검색·복사·결합하는 빠른 대처 리소스함입니다.
- 인스턴스 (SSH OS 인스턴스 CMDB)SSH 로 접근 가능한 OS 인스턴스(물리·VM·클라우드)를 infr_instance 대장으로 등록·검색·편집하고, alias 로 라이브 메트릭과 잇는 자산 CMDB 화면입니다.
- 인스턴스 SSH 터미널브라우저에서 등록 인스턴스에 진짜 PTY 대화형 SSH 셸을 열어 top·vi·sudo 를 그대로 실행합니다(xterm.js ⇄ WS 브리지 ⇄ ssh2).
- 인스턴스 버전 원장 [ver]인스턴스별 소프트웨어 버전을 수동 입력 또는 프로브 JSON import 로 관리하고 current/outdated/eol/vuln 상태로 추적합니다.
- 인스턴스 변수 ([env])인스턴스별 env 변수를 Crypt 로 암호화 저장하고, Tools 스크립트의 {{PLACEHOLDER}} 매시업에 쓸 내장 토큰 사전을 함께 제공하는 [env] 모달.
- 서버 파라미터 스냅샷인스턴스의 웹·DB·커널·애플리케이션·그외 5개 영역 설정값을 올려두고 AI 튜닝 질의의 근거로 쓰는 참조 스냅샷.
- 방화벽 규칙 대장 (인스턴스)인스턴스별 방화벽 규칙(iptables·firewalld·ufw)을 프로브로 수집·대장화하고 Security ▸ Firewall 공격면 지도에 공급.
- 원격 에뮬레이트 · 프로브 배포SSH 없이 tlx.php HTTP 릴레이로 원격 호스트에 프로브를 배포·실행하고 결과를 자산에 적용하는 서명 기반 방식.
- 하드웨어 자산 (CMDB)서버·네트워크·사무실 물리 하드웨어를 부품·포트·토폴로지·랙 배치까지 대장화하는 CMDB.
- 스토리지 & 파일스토리지 장비 자산 대장과 보관 자료의 의미 영역 트리를 두 탭으로 관리 — 자산 관점(실시간 status 아님).
- 수집기 (Collectors)접근 방식(web·database·agent)으로 추상화한 수집기 레지스트리 — 하드코딩 상수를 외부화하고 Health·Database 를 구동.
- 운영 정책 (Operations Policy)전역 의사결정을 infr_setting(group=ops)에 저장하고 OpsPolicy 로 읽는 곳 — 수집 모드·임계·화폐·감시 포트·내부망·자동 차단 스위치.
- API 발급 (API Keys)외부 앱·호스트가 오류(인시던트)와 보안 진단 결과를 자동 전송하도록 API 키를 발급하고 연동 코드를 안내.
- 규칙 임계 (Rules & Thresholds)탐지 수집기 srct_tx/kts_tx 의 하드코딩 상수를 infr_setting(group=rules)에 저장하고 RulesPolicy 로 읽어 Tools 코드 생성에 주입.
- 평판 API (Reputation API)AbuseIPDB API 키를 다중 등록해 라운드로빈으로 소비 — 무료 쿼터 풀링 + 장애 시 다음 키 대체.
- AI 어댑터 (AI Adapters)LLM 프로바이더를 다중 등록해 우선순위대로 선택 — Inventory 문서 AI 초안에 사용.
- 메일 어댑터 (Mail Adapters)메일 발송 프로바이더를 다중 등록 — 경보 발송의 메일 채널을 구동.
- SMS 어댑터 (SMS Adapters)본국 기준 SMS 프로바이더를 다중 등록 — 경보 발송의 SMS 채널을 구동.
- 다국어 (Localization)8개국어 카탈로그에서 표시 언어 부분집합을 선택하고 순서를 정해 사이트 기본 언어를 결정.
- 사용자 · 팀 (Users & Roles)InfraGuard 자체 인증 테이블(infr_user)의 사용자·팀 CRUD 와 등급(demo/staff/admin) 관리.
- 감사 로그 (Audit)파괴적·보안 작업을 전량 기록하는 불변 감사 추적(infr_audit_log)을 필터·패싯·KPI 로 조회.
- 개발 · 관측 (Development)super_admin 전용 관측 섹션 — Doctor, Pulse/Horizon, Leader/Runtime, Slow 쿼리/요청/잡, 예외·캐시.
보안
- 보안 개요 (방어 퍼널)위협 → 탐지 → 자동 대응 룰셋 → 차단을 하나의 퍼널로 관통해 자동 방어의 서사를 보여주는 보안 관제 센터피스 화면입니다.
- Threats — IDS 위협 트리아지Suricata IDS 경보를 출발지 IP 엔티티로 트리아지하고, 자동차단 연결 배지와 시그니처 해설로 위협의 의미를 서사화합니다.
- 탐지 + JA3 시퀀스 룰셋탐지 알고리즘(Kitsune·srct·nginx·JA3) 서사와 결정적 휴리스틱 JA3 시퀀스 분석으로 이상행동 룰셋(infr_sec_ruleset)을 도출·축적하는 플래그십 화면.
- 탐지 룰셋InfraGuard가 관측·판정하는 44개 탐지 룰셋을 11개 카테고리로 정규화해 개요·해설하고, 카드 클릭으로 그 룰셋에 걸린 최근 이벤트를 되짚는 읽기 전용 카탈로그.
- 방화벽 (공격 표면)함대가 열어둔 오픈 포트를 인스턴스 방화벽 룰 × 등록 서비스로 교차해 위험도로 채색한 노출 지도입니다.
- 차단 & 평판 (Blocklist)AI·IDS 자동 방어가 채운 blacklist_info(/24 대역 차단)를 서사화하고, 운영자가 직접 차단·해제·재차단하는 콘솔입니다.
- 화이트리스트 (차단 면책)자동 차단에서 제외할 IP·CIDR을 만료 개념(영구/임시)으로 관리하고, srct_tx가 차단 직전 참조하는 면책 목록을 제공합니다.
- 보안 진단여러 서버에 루트킷·하드닝 점검을 한 번에 실행해 서버별 보안 등급(A–F)을 매기고, 위급 항목은 자동으로 문제 해결 케이스로 승격합니다.
- 보안 문제 해결 (Problem Resolution)보안 인시던트·침해를 등록→분석→원인판명→해결→종료 워크플로우로 관리하고, 진단에서 승격된 위급 항목을 자동 케이스로 추적하는 케이스 보드입니다.
- IP 평판 조회 (AbuseIPDB)의심 IP를 클릭하면 AbuseIPDB 위협 인텔을 인앱 팝업으로 조회합니다 — 악용 신뢰도 게이지·신고·카테고리·Tor/화이트리스트, 1시간 캐시로 무료 쿼터를 보호합니다.
- 자동 차단 파이프라인트리거를 충족한 공격 IP 를 수집기와 스케줄러가 자동으로 차단 목록에 올리고 ipset 으로 집행하는 백그라운드 방어 흐름입니다.