메인 페이지 수정

Author: saranf

.env.example

@@ -1,6 +1,7 @@
 PUBLIC_DOMAIN=mori.rmstudio.co.kr
 PUBLIC_PORT=37854
-PUBLIC_URL=http://mori.rmstudio.co.kr:37854
+GRAFANA_PORT=13000
+GRAFANA_URL=http://mori.rmstudio.co.kr:13000
 TIMEZONE=Asia/Seoul
 
 GRAFANA_ADMIN_USER=admin

README.md

@@ -21,16 +21,21 @@
 ## 1. 배포 목표
 
 - 공개 주소: `http://mori.rmstudio.co.kr:37854`
+- Grafana 주소: `http://mori.rmstudio.co.kr:13000`
+- Zabbix 주소: `http://mori.rmstudio.co.kr:18081`
 - 배포 경로: `/backup/rmstudio/mori`
 - 배포 방식: GitHub Actions + SSH
 - 실행 방식: `docker compose`
 
-현재 외부 공개 진입점은 **Grafana**입니다.
+현재 외부 공개 진입점은 **메인 포털**이며,
+포털에서 Grafana와 Zabbix 운영 UI로 이동하는 구조입니다.
 
 ## 2. 현재 구성된 서비스
 
 ### Public Entry
-- `Grafana` (`37854`)
+- `Main Portal` (`37854`)
+- `Grafana` (`13000`)
+- `Zabbix Web` (`18081`, 기본값)
 
 ### Internal Services
 - `Loki`: 중앙 로그 저장소
@@ -43,11 +48,12 @@
 ## 3. 포트 구성
 
 - Public
-  - `37854` → Grafana
+  - `37854` → Main Portal
+  - `13000` → Grafana
+  - `18081` → Zabbix Web
 
 - Internal / localhost only
-- `127.0.0.1:18081` → Zabbix Web
-  - `127.0.0.1:1337` → FleetDM
+- `127.0.0.1:1337` → FleetDM
   - `127.0.0.1:8443` → Wazuh Dashboard
 
 - Service ports
@@ -64,6 +70,7 @@
 - `generate-indexer-certs.yml`: Wazuh 인증서 생성용 compose 파일
 - `.github/workflows/deploy.yml`: GitHub Actions 배포 워크플로우
 - `docs/DEPLOYMENT.md`: 서버 준비 및 운영 가이드
+- `config/portal/index.html`: 메인 포털 페이지
 - `config/*`: 각 서비스별 설정 파일
 
 ## 5. 배포 방식
@@ -86,6 +93,8 @@ GitHub Actions가 아래 순서로 동작하도록 구성했습니다.
 단, Grafana 볼륨이 이미 생성된 뒤에는 `.env` 값을 바꿔도 기존 비밀번호가 유지될 수 있으므로,
 로그인이 안 되면 `docs/DEPLOYMENT.md`의 Grafana 트러블슈팅 절차를 먼저 확인하세요.
 
+메인 포털은 `PUBLIC_PORT`, Grafana는 `GRAFANA_PORT`, Grafana URL 표시는 `GRAFANA_URL`을 사용합니다.
+
 반드시 변경해야 하는 값:
 
 - `GRAFANA_ADMIN_PASSWORD`
@@ -131,20 +140,97 @@ GitHub Actions가 아래 순서로 동작하도록 구성했습니다.
 또한 Wazuh Dashboard의 설정 마운트 충돌 가능성을 제거하도록 compose를 보정했습니다.
 Wazuh 인증서 마운트도 디렉터리 방식으로 보정해 파일/디렉터리 마운트 꼬임 가능성을 낮췄습니다.
 Grafana에는 Loki 데이터소스와 starter overview dashboard 프로비저닝을 추가했습니다.
+메인 포털 페이지도 추가해 37854 포트에서 운영 UI 동선을 제공하도록 구성했습니다.
 
 ## 10. 운영 메모
 
-- 현재 공개 서비스는 Grafana만 노출합니다.
-- Zabbix / FleetDM / Wazuh Dashboard는 localhost 바인딩으로 제한했습니다.
+- 현재 공개 서비스는 Main Portal, Grafana, Zabbix Web입니다.
+- FleetDM / Wazuh Dashboard는 localhost 바인딩으로 제한했습니다.
+- 메인 포털(`37854`)에서 Grafana(`13000`)와 Zabbix(`18081`)로 이동할 수 있습니다.
+- Zabbix 알람/트리거 조정은 Web UI를 통해 운영할 수 있습니다.
 - Grafana admin 기본값은 `admin / 1234`입니다.
 - Grafana 로그인 실패는 대부분 기존 `grafana-data` 볼륨에 남아 있는 초기 비밀번호 때문입니다.
 - Wazuh 기본 예제 계정은 공식 예시 기본값(`SecretPassword`)을 사용 중입니다.
 - Wazuh 비밀번호를 변경하려면 `config/wazuh_indexer/internal_users.yml`의 해시와 관련 설정을 함께 수정해야 합니다.
 - Trivy 스캔은 필요 시 profile로 실행합니다.
 
-## 11. 다음 작업 후보
+## 11. 어떻게 테스트하면 되는지
+
+배포 후 아래 순서로 최소 기능 테스트를 진행하면 됩니다.
+
+### 1) 컨테이너 상태 확인
+
+- `docker compose ps`
+- `docker compose logs grafana --tail=50`
+- `docker compose logs zabbix-web --tail=50`
+
+정상 기준:
+
+- 주요 컨테이너가 `Up` 상태
+- Grafana / Zabbix Web 로그에 치명 오류가 없음
+
+### 2) Grafana 로그인 테스트
+
+- 메인 포털 접속: `http://mori.rmstudio.co.kr:37854`
+- Grafana 접속: `http://mori.rmstudio.co.kr:13000`
+- 계정: `admin / 1234`
+- 확인 항목:
+  - 메인 포털에서 Grafana 링크 이동 가능
+  - 로그인 성공
+  - `MORI Security Overview` 대시보드 표시
+  - Explore에서 Loki 데이터소스 선택 가능
+
+로그인이 안 되면 `docs/DEPLOYMENT.md`의 Grafana 비밀번호 리셋 절차를 수행합니다.
+
+### 3) Zabbix Web UI 테스트
+
+- 메인 포털 접속: `http://mori.rmstudio.co.kr:37854`
+- 접속: `http://mori.rmstudio.co.kr:18081`
+- 확인 항목:
+  - 메인 포털에서 Zabbix 링크 이동 가능
+  - 로그인 화면 노출
+  - Zabbix 서버 연결 오류가 없는지 확인
+  - 향후 트리거/알람 조정용 UI로 접근 가능한지 확인
+
+### 4) Loki 로그 수집 테스트
+
+Grafana Explore에서 Loki로 아래 쿼리를 실행합니다.
+
+- `{job="fluent-bit"}`
+
+정상 기준:
+
+- 호스트 로그가 조회됨
+- 새 로그가 시간 흐름에 따라 계속 유입됨
+
+### 5) Wazuh / Fleet 접속 테스트
+
+- FleetDM: 서버에서 `http://127.0.0.1:1337`
+- Wazuh Dashboard: 서버에서 `https://127.0.0.1:8443`
+
+현재 두 서비스는 외부 공개하지 않고 내부 운영용으로 유지합니다.
+
+### 6) 취약점 스캔 테스트
+
+- `docker compose --profile scanner run --rm trivy`
+
+정상 기준:
+
+- Trivy가 실행되고 결과 테이블이 출력됨
+
+### 7) 운영 테스트 체크리스트
+
+- 메인 포털 접속 가능
+- Grafana 로그인 가능
+- Zabbix Web UI 접속 가능
+- Loki 로그 조회 가능
+- Trivy 실행 가능
+- Wazuh/Fleet 내부 포트 접속 가능
+
+## 12. 다음 작업 후보
 
 - Grafana 대시보드/프로비저닝 고도화
+- Zabbix 템플릿/API 자동화 또는 통합 운영 UI 설계
 - HTTPS 리버스 프록시(Nginx/Caddy) 추가
 - Wazuh/Fleet 초기 운영 설정 보강
 - 실제 서버 기동 후 헬스체크 및 초기 로그인 검증

config/grafana/provisioning/dashboards/mori-overview.json

@@ -10,7 +10,7 @@
       "gridPos": {"h": 8, "w": 24, "x": 0, "y": 0},
       "options": {
         "mode": "markdown",
-        "content": "# MORI SOC-lite\n\n- Public entry: `http://mori.rmstudio.co.kr:37854`\n- Infrastructure Monitoring: Zabbix\n- Endpoint Security: FleetDM\n- Log Management: Loki + Fluent Bit\n- Security Event Detection: Wazuh\n- Vulnerability Scan: Trivy\n\n이 대시보드는 starter dashboard이며, 기능 정의서 기준 KPI 패널은 이후 단계에서 확장합니다."
+        "content": "# MORI SOC-lite\n\n- Main Portal: `http://mori.rmstudio.co.kr:37854`\n- Grafana: `http://mori.rmstudio.co.kr:13000`\n- Zabbix Web: `http://mori.rmstudio.co.kr:18081`\n- Endpoint Security: FleetDM\n- Log Management: Loki + Fluent Bit\n- Security Event Detection: Wazuh\n- Vulnerability Scan: Trivy\n\n이 대시보드는 starter dashboard이며, 기능 정의서 기준 KPI 패널은 이후 단계에서 확장합니다."
       }
     },
     {

config/portal/index.html

@@ -0,0 +1,55 @@
+<!doctype html>
+<html lang="ko">
+<head>
+  <meta charset="utf-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1" />
+  <title>MORI SOC-lite Portal</title>
+  <style>
+    body { margin: 0; font-family: -apple-system, BlinkMacSystemFont, sans-serif; background: #0b1220; color: #e5e7eb; }
+    .wrap { max-width: 980px; margin: 0 auto; padding: 48px 20px; }
+    h1 { margin-bottom: 8px; }
+    p { color: #cbd5e1; line-height: 1.6; }
+    .grid { display: grid; gap: 16px; grid-template-columns: repeat(auto-fit, minmax(240px, 1fr)); margin-top: 28px; }
+    .card { background: #111827; border: 1px solid #334155; border-radius: 14px; padding: 20px; }
+    .card h2 { margin-top: 0; font-size: 20px; }
+    .button { display: inline-block; margin-top: 12px; padding: 10px 14px; border-radius: 10px; background: #2563eb; color: white; text-decoration: none; font-weight: 600; }
+    .muted { font-size: 14px; color: #94a3b8; }
+    code { background: #1e293b; padding: 2px 6px; border-radius: 6px; }
+  </style>
+</head>
+<body>
+  <div class="wrap">
+    <h1>MORI SOC-lite Main Portal</h1>
+    <p>보안 가시성 운영 포털입니다. 여기서 Grafana 대시보드와 Zabbix 관리 UI로 이동할 수 있습니다.</p>
+
+    <div class="grid">
+      <div class="card">
+        <h2>Grafana</h2>
+        <p>로그 조회, Loki Explore, 보안 현황 대시보드 확인.</p>
+        <a id="grafana-link" class="button" href="#">Grafana 열기</a>
+        <div class="muted">기본 포트: <code>13000</code></div>
+      </div>
+
+      <div class="card">
+        <h2>Zabbix Web</h2>
+        <p>호스트, 트리거, 알람, 템플릿을 세밀하게 조정하는 운영 UI.</p>
+        <a id="zabbix-link" class="button" href="#">Zabbix 열기</a>
+        <div class="muted">기본 포트: <code>18081</code></div>
+      </div>
+
+      <div class="card">
+        <h2>Internal Services</h2>
+        <p>FleetDM과 Wazuh Dashboard는 현재 외부에 공개하지 않고 서버 내부 포트로만 운영합니다.</p>
+        <div class="muted">FleetDM: <code>127.0.0.1:1337</code></div>
+        <div class="muted">Wazuh: <code>127.0.0.1:8443</code></div>
+      </div>
+    </div>
+  </div>
+
+  <script>
+    const base = `${window.location.protocol}//${window.location.hostname}`;
+    document.getElementById('grafana-link').href = `${base}:13000`;
+    document.getElementById('zabbix-link').href = `${base}:18081`;
+  </script>
+</body>
+</html>

docker-compose.yml

@@ -1,17 +1,26 @@
 services:
+  portal:
+    image: nginx:alpine
+    restart: unless-stopped
+    ports:
+      - "${PUBLIC_PORT:-37854}:80"
+    volumes:
+      - ./config/portal:/usr/share/nginx/html:ro
+    networks: [soc]
+
   grafana:
     image: grafana/grafana-oss:11.5.2
     restart: unless-stopped
     depends_on:
       - loki
     environment:
       GF_SERVER_DOMAIN: ${PUBLIC_DOMAIN:-mori.rmstudio.co.kr}
-      GF_SERVER_ROOT_URL: ${PUBLIC_URL:-http://mori.rmstudio.co.kr:37854}
+      GF_SERVER_ROOT_URL: ${GRAFANA_URL:-http://mori.rmstudio.co.kr:13000}
       GF_SECURITY_ADMIN_USER: ${GRAFANA_ADMIN_USER:-admin}
       GF_SECURITY_ADMIN_PASSWORD: ${GRAFANA_ADMIN_PASSWORD:-1234}
       GF_USERS_ALLOW_SIGN_UP: "false"
     ports:
-      - "${PUBLIC_PORT:-37854}:3000"
+      - "${GRAFANA_PORT:-13000}:3000"
     volumes:
       - grafana-data:/var/lib/grafana
       - ./config/grafana/provisioning:/etc/grafana/provisioning:ro
@@ -85,7 +94,7 @@ services:
       PHP_TZ: ${TIMEZONE:-Asia/Seoul}
       ZBX_SERVER_NAME: MORI SOC-lite
     ports:
-      - "127.0.0.1:${ZABBIX_WEB_PORT:-18081}:8080"
+      - "${ZABBIX_WEB_PORT:-18081}:8080"
     networks: [soc]
 
   mysql:

docs/DEPLOYMENT.md

@@ -3,10 +3,11 @@
 ### 1. 공개 진입점
 
 - 메인 URL: `http://mori.rmstudio.co.kr:37854`
-- 공개 서비스: `Grafana`
+- 메인 포털: `http://mori.rmstudio.co.kr:37854`
+- Grafana: `http://mori.rmstudio.co.kr:13000`
+- 공개 관리 UI: `http://mori.rmstudio.co.kr:18081` (`Zabbix Web`)
 - 내부/로컬 관리 포트
-- `127.0.0.1:18081` → Zabbix Web
-  - `127.0.0.1:1337` → FleetDM
+- `127.0.0.1:1337` → FleetDM
   - `127.0.0.1:8443` → Wazuh Dashboard
 
 ### 2. 서버 사전 준비
@@ -29,6 +30,12 @@ sudo sysctl -w vm.max_map_count=262144
 다만 첫 기동 시 생성된 `grafana-data` 볼륨에 이전 비밀번호가 남아 있으면,
 `.env` 값을 변경해도 바로 로그인 비밀번호가 바뀌지 않습니다.
 
+포트 구성은 아래 기준입니다.
+
+- `PUBLIC_PORT=37854` → 메인 포털
+- `GRAFANA_PORT=13000` → Grafana
+- `ZABBIX_WEB_PORT=18081` → Zabbix Web
+
 필수 변경값:
 
 - `GRAFANA_ADMIN_PASSWORD`
@@ -114,7 +121,9 @@ docker compose restart grafana
 
 ### 8. 운영 메모
 
-- 현재 공개 포트는 Grafana만 사용합니다.
+- 현재 공개 포트는 Main Portal, Grafana, Zabbix Web입니다.
+- 메인 포털에서 운영자가 Grafana/Zabbix로 이동하는 구조입니다.
+- Zabbix 알람/트리거 운영은 Web UI를 통해 직접 조정할 수 있습니다.
 - 수동 실행 시에는 `docker-compose` 대신 `docker compose` 사용을 권장합니다.
 - Wazuh 기본 계정 해시는 공식 예제 기본값(`SecretPassword`) 기준입니다.
 - Wazuh 기본 비밀번호를 변경하려면 `config/wazuh_indexer/internal_users.yml` 해시와 관련 설정을 함께 수정해야 합니다.