초기 셋팅 + 그라파나 로그인 수정

Author: saranf

README.md

@@ -12,6 +12,12 @@
 - Visualization: Grafana
 - Vulnerability Scan: Trivy
 
+## 참고 문서
+
+- `docs/FUNCTIONAL_SPEC.md`: 기능 정의서 원문
+- `docs/IMPLEMENTATION_ROADMAP.md`: 기능 정의서 기준 구현 로드맵
+- `docs/DEPLOYMENT.md`: 서버 배포/운영/트러블슈팅 가이드
+
 ## 1. 배포 목표
 
 - 공개 주소: `http://mori.rmstudio.co.kr:37854`
@@ -76,6 +82,10 @@ GitHub Actions가 아래 순서로 동작하도록 구성했습니다.
 
 `.env.example` 기준으로 실제 `.env`를 작성해야 합니다.
 
+현재 기본 Grafana 관리자 비밀번호는 요청값에 맞춰 `1234`로 설정되어 있습니다.
+단, Grafana 볼륨이 이미 생성된 뒤에는 `.env` 값을 바꿔도 기존 비밀번호가 유지될 수 있으므로,
+로그인이 안 되면 `docs/DEPLOYMENT.md`의 Grafana 트러블슈팅 절차를 먼저 확인하세요.
+
 반드시 변경해야 하는 값:
 
 - `GRAFANA_ADMIN_PASSWORD`
@@ -120,11 +130,14 @@ GitHub Actions가 아래 순서로 동작하도록 구성했습니다.
 
 또한 Wazuh Dashboard의 설정 마운트 충돌 가능성을 제거하도록 compose를 보정했습니다.
 Wazuh 인증서 마운트도 디렉터리 방식으로 보정해 파일/디렉터리 마운트 꼬임 가능성을 낮췄습니다.
+Grafana에는 Loki 데이터소스와 starter overview dashboard 프로비저닝을 추가했습니다.
 
 ## 10. 운영 메모
 
 - 현재 공개 서비스는 Grafana만 노출합니다.
 - Zabbix / FleetDM / Wazuh Dashboard는 localhost 바인딩으로 제한했습니다.
+- Grafana admin 기본값은 `admin / 1234`입니다.
+- Grafana 로그인 실패는 대부분 기존 `grafana-data` 볼륨에 남아 있는 초기 비밀번호 때문입니다.
 - Wazuh 기본 예제 계정은 공식 예시 기본값(`SecretPassword`)을 사용 중입니다.
 - Wazuh 비밀번호를 변경하려면 `config/wazuh_indexer/internal_users.yml`의 해시와 관련 설정을 함께 수정해야 합니다.
 - Trivy 스캔은 필요 시 profile로 실행합니다.

config/grafana/provisioning/dashboards/dashboards.yml

@@ -0,0 +1,12 @@
+apiVersion: 1
+
+providers:
+  - name: MORI Starter Dashboards
+    orgId: 1
+    folder: MORI SOC-lite
+    type: file
+    disableDeletion: false
+    editable: true
+    updateIntervalSeconds: 30
+    options:
+      path: /etc/grafana/provisioning/dashboards

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

@@ -0,0 +1,49 @@
+{
+  "annotations": {"list": []},
+  "editable": true,
+  "graphTooltip": 0,
+  "links": [],
+  "panels": [
+    {
+      "type": "text",
+      "title": "Security Overview",
+      "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 패널은 이후 단계에서 확장합니다."
+      }
+    },
+    {
+      "type": "logs",
+      "title": "Recent Host Logs",
+      "gridPos": {"h": 12, "w": 24, "x": 0, "y": 8},
+      "datasource": {"type": "loki", "uid": "loki"},
+      "targets": [
+        {
+          "expr": "{job=\"fluent-bit\"}",
+          "queryType": "range",
+          "refId": "A"
+        }
+      ],
+      "options": {
+        "dedupStrategy": "none",
+        "enableLogDetails": true,
+        "prettifyLogMessage": false,
+        "showCommonLabels": false,
+        "showLabels": true,
+        "showTime": true,
+        "sortOrder": "Descending",
+        "wrapLogMessage": true
+      }
+    }
+  ],
+  "refresh": "30s",
+  "schemaVersion": 39,
+  "style": "dark",
+  "tags": ["mori", "soc-lite", "starter"],
+  "templating": {"list": []},
+  "time": {"from": "now-6h", "to": "now"},
+  "timezone": "browser",
+  "title": "MORI Security Overview",
+  "version": 1
+}

config/grafana/provisioning/datasources/datasources.yml

@@ -2,6 +2,7 @@ apiVersion: 1
 
 datasources:
   - name: Loki
+    uid: loki
     type: loki
     access: proxy
     url: http://loki:3100

docs/DEPLOYMENT.md

@@ -25,6 +25,10 @@ sudo sysctl -w vm.max_map_count=262144
 
 `.env.example`을 기준으로 `.env`를 작성합니다.
 
+현재 Grafana 기본 로그인 값은 `admin / 1234`입니다.
+다만 첫 기동 시 생성된 `grafana-data` 볼륨에 이전 비밀번호가 남아 있으면,
+`.env` 값을 변경해도 바로 로그인 비밀번호가 바뀌지 않습니다.
+
 필수 변경값:
 
 - `GRAFANA_ADMIN_PASSWORD`
@@ -53,7 +57,38 @@ docker compose ps
 기존에 인증서 생성 전에 `docker compose up`을 먼저 실행했다면,
 `config/wazuh_indexer_ssl_certs` 내부 경로가 디렉터리로 잘못 생성될 수 있으므로 위처럼 초기화 후 다시 생성하는 것을 권장합니다.
 
-### 5. GitHub Actions 시크릿
+### 5. Grafana 로그인 안 될 때
+
+가장 흔한 원인은 아래 3가지입니다.
+
+- 서버 `.env`의 `GRAFANA_ADMIN_PASSWORD`가 기대값과 다름
+- GitHub Secret `DEPLOY_ENV_FILE`에 이전 값이 남아 있음
+- 기존 `grafana-data` 볼륨에 예전 admin 비밀번호가 저장되어 있음
+
+먼저 실제 적용값을 확인합니다.
+
+```bash
+cd /backup/rmstudio/mori
+grep '^GRAFANA_ADMIN_' .env
+docker compose ps grafana
+```
+
+비밀번호를 안전하게 현재 컨테이너 기준으로 재설정하려면:
+
+```bash
+cd /backup/rmstudio/mori
+docker compose exec grafana grafana cli admin reset-admin-password 1234
+docker compose restart grafana
+```
+
+이후 아래 계정으로 다시 로그인합니다.
+
+- ID: `admin`
+- PW: `1234`
+
+그래도 안 되면 GitHub Actions에 등록한 `DEPLOY_ENV_FILE` 내용도 같이 확인해야 합니다.
+
+### 6. GitHub Actions 시크릿
 
 다음 시크릿을 저장소에 추가하세요.
 
@@ -66,7 +101,7 @@ docker compose ps
 
 `DEPLOY_ENV_FILE`에는 서버에서 사용할 `.env` 전체 내용을 멀티라인 그대로 넣으면 됩니다.
 
-### 6. GitHub Actions 배포 동작
+### 7. GitHub Actions 배포 동작
 
 워크플로우는 다음 순서로 동작합니다.
 
@@ -77,9 +112,10 @@ docker compose ps
 5. `docker compose pull`
 6. `docker compose up -d --remove-orphans`
 
-### 7. 운영 메모
+### 8. 운영 메모
 
 - 현재 공개 포트는 Grafana만 사용합니다.
+- 수동 실행 시에는 `docker-compose` 대신 `docker compose` 사용을 권장합니다.
 - Wazuh 기본 계정 해시는 공식 예제 기본값(`SecretPassword`) 기준입니다.
 - Wazuh 기본 비밀번호를 변경하려면 `config/wazuh_indexer/internal_users.yml` 해시와 관련 설정을 함께 수정해야 합니다.
 - Trivy 점검은 필요 시 아래처럼 실행합니다.