HeuJung
ea58c606a2
공개 제보 — 파일 스토리지에서 S3 를 선택해 저장해도 실제 파일 저장이 동작하지 않던 결함의 전면 수정. - S3 어댑터(league/flysystem-aws-s3-v3)·predis 를 코어 기본 의존성으로 포함 — 어댑터 부재 즉사, phpredis 확장 없는 서버의 redis 선택 전면 다운 차단 (부트 시 확장 부재 감지 → predis 자동 폴백) - storage_driver=s3 저장 시 코어 첨부 업로드 디스크를 s3 로 전환 (ATTACHMENT_DISK env 명시가 항상 우선, 기존 행은 저장 당시 disk 로 서빙) - 첨부·템플릿 레이아웃 첨부 서빙을 행 disk 를 따르는 스토리지 스트림으로 교체 — 로컬 절대 경로 전제 fileResponse 는 S3 행에서 filemtime stat 500 (streamedFileResponse: 행 메타 기반 ETag/304/Cache-Control) - S3 호환 스토리지(R2/MinIO/NCP) 연결 지원: 엔드포인트 URL·path-style 설정 신설, 리전 목록 선택 → 자유 입력 전환, 연결 테스트를 실제 저장 경로와 동일 설정(endpoint/path-style)으로 정렬 - 사용 불능 드라이버(어댑터·PHP 확장 부재)의 저장/테스트 요청을 사유와 함께 422 로 차단하는 서버 게이트 신설 (DriverRegistryService 능력 판정) - 웹소켓 연결 테스트에 서버(백엔드 발송용) endpoint 검사 추가 — 클라이언트만 검사해 테스트 성공 + 실제 발송 실패가 가능하던 비대칭 해소 - env 빈 값(`KEY=`) 함정 정규화: AWS_URL/AWS_ENDPOINT/ATTACHMENT_DISK 빈 문자열을 미설정으로 취급 (config 정규화 + 예시 파일 주석 처리) - 플러그인 드라이버 폴백의 log 카테고리 죽은 키(logging.default) 정정 및 websocket 유령 설정 키 제거 - 실 AWS S3 종단 검증 완료 (설정 저장 → 업로드 S3 실저장 → 서빙 200/304)
357 lines
18 KiB
JSON
357 lines
18 KiB
JSON
{
|
|
"_meta": {
|
|
"version": "1.0.0",
|
|
"description": "그누보드7 환경설정 기본값 및 프론트엔드 스키마",
|
|
"categories": ["general", "security", "mail", "upload", "seo", "cache", "debug", "drivers", "core_update", "geoip", "notifications", "identity", "pagination"]
|
|
},
|
|
"defaults": {
|
|
"general": {
|
|
"site_name": "그누보드7",
|
|
"site_url": "",
|
|
"site_description": "",
|
|
"admin_email": "",
|
|
"timezone": "Asia/Seoul",
|
|
"language": "ko",
|
|
"currency": "KRW",
|
|
"maintenance_mode": false,
|
|
"site_logo": [],
|
|
"asset_url_mode": "extension"
|
|
},
|
|
"security": {
|
|
"force_https": false,
|
|
"login_attempt_enabled": true,
|
|
"auth_token_lifetime": 30,
|
|
"max_login_attempts": 5,
|
|
"login_lockout_time": 5,
|
|
"two_factor_auth": false,
|
|
"password_min_length": 8,
|
|
"require_password_special_char": false,
|
|
"allow_internal_outbound_urls": false
|
|
},
|
|
"mail": {
|
|
"mailer": "smtp",
|
|
"host": "",
|
|
"port": 587,
|
|
"username": "",
|
|
"password": "",
|
|
"encryption": "tls",
|
|
"mailgun_domain": "",
|
|
"mailgun_secret": "",
|
|
"mailgun_endpoint": "api.mailgun.net",
|
|
"ses_key": "",
|
|
"ses_secret": "",
|
|
"ses_region": "ap-northeast-2",
|
|
"from_address": "noreply@example.com",
|
|
"from_name": "그누보드7"
|
|
},
|
|
"upload": {
|
|
"max_file_size": 10,
|
|
"allowed_extensions": ["jpg", "jpeg", "png", "gif", "webp", "pdf", "doc", "docx", "xls", "xlsx", "zip"],
|
|
"image_max_width": 2000,
|
|
"image_max_height": 2000,
|
|
"image_quality": 85
|
|
},
|
|
"seo": {
|
|
"meta_title_suffix": "",
|
|
"meta_description": "",
|
|
"meta_keywords": "",
|
|
"google_analytics_id": "",
|
|
"google_site_verification": "",
|
|
"naver_site_verification": "",
|
|
"bot_user_agents": ["kakaotalk-scrap", "Meta-ExternalAgent", "ChatGPT-User"],
|
|
"bot_detection_enabled": true,
|
|
"bot_detection_library_enabled": true,
|
|
"og_default_site_name": "",
|
|
"og_image_default_width": 1200,
|
|
"og_image_default_height": 630,
|
|
"twitter_default_card": "summary_large_image",
|
|
"twitter_default_site": "",
|
|
"cache_enabled": null,
|
|
"cache_ttl": null,
|
|
"sitemap_enabled": true,
|
|
"sitemap_cache_ttl": null,
|
|
"sitemap_urls_per_file": 50000,
|
|
"sitemap_gzip": false,
|
|
"sitemap_serve_stale_on_miss": true,
|
|
"sitemap_max_urls_per_contributor": 0,
|
|
"sitemap_hreflang_enabled": true,
|
|
"sitemap_schedule": "daily",
|
|
"sitemap_schedule_time": "02:00",
|
|
"sitemap_last_updated_at": "",
|
|
"generator_enabled": true,
|
|
"generator_content": ""
|
|
},
|
|
"cache": {
|
|
"enabled": true,
|
|
"default_ttl": 86400,
|
|
"layout_enabled": true,
|
|
"layout_ttl": 3600,
|
|
"seo_enabled": true,
|
|
"seo_ttl": 7200,
|
|
"seo_sitemap_ttl": 86400,
|
|
"stats_enabled": true,
|
|
"stats_ttl": 1800,
|
|
"notification_ttl": 3600,
|
|
"extension_status_ttl": 86400,
|
|
"geoip_enabled": true,
|
|
"geoip_ttl": 86400,
|
|
"version_check_ttl": 3600
|
|
},
|
|
"debug": {
|
|
"mode": false,
|
|
"sql_query_log": false,
|
|
"log_level": "error"
|
|
},
|
|
"core_update": {
|
|
"github_url": "",
|
|
"github_token": ""
|
|
},
|
|
"geoip": {
|
|
"feature_enabled": false,
|
|
"license_key": "",
|
|
"auto_update_enabled": true,
|
|
"last_updated_at": ""
|
|
},
|
|
"pagination": {
|
|
"result_cap": 10000,
|
|
"max_page": 1000
|
|
},
|
|
"drivers": {
|
|
"storage_driver": "local",
|
|
"s3_bucket": "",
|
|
"s3_region": "ap-northeast-2",
|
|
"s3_access_key": "",
|
|
"s3_secret_key": "",
|
|
"s3_url": "",
|
|
"s3_endpoint": "",
|
|
"s3_use_path_style": false,
|
|
"cache_driver": "file",
|
|
"redis_host": "127.0.0.1",
|
|
"redis_port": 6379,
|
|
"redis_password": "",
|
|
"redis_database": 0,
|
|
"memcached_host": "127.0.0.1",
|
|
"memcached_port": 11211,
|
|
"session_driver": "file",
|
|
"session_lifetime": 120,
|
|
"queue_driver": "sync",
|
|
"log_driver": "daily",
|
|
"log_level": "error",
|
|
"log_days": 14,
|
|
"websocket_enabled": false,
|
|
"websocket_app_id": "",
|
|
"websocket_app_key": "",
|
|
"websocket_app_secret": "",
|
|
"websocket_host": "localhost",
|
|
"websocket_port": 8080,
|
|
"websocket_scheme": "https",
|
|
"websocket_verify_ssl": true,
|
|
"websocket_server_host": "127.0.0.1",
|
|
"websocket_server_port": 8080,
|
|
"websocket_server_scheme": "http",
|
|
"search_engine_driver": "mysql-fulltext"
|
|
},
|
|
"notifications": {
|
|
"channels": [
|
|
{ "id": "mail", "is_active": true, "sort_order": 1 },
|
|
{ "id": "database", "is_active": true, "sort_order": 2 }
|
|
]
|
|
},
|
|
"identity": {
|
|
"default_provider": "g7:core.mail",
|
|
"purpose_providers": {
|
|
"password_reset": null,
|
|
"self_update": null,
|
|
"sensitive_action": null
|
|
},
|
|
"challenge_ttl_minutes": 15,
|
|
"max_attempts": 5
|
|
}
|
|
},
|
|
"frontend_schema": {
|
|
"_description": "프론트엔드에 노출할 설정 필드 정의. 각 카테고리별로 노출할 필드와 타입 캐스팅, 민감 정보 여부를 정의합니다.",
|
|
"general": {
|
|
"expose": true,
|
|
"_comment": "site_url, admin_email, language, timezone는 프론트엔드에서 미참조하므로 expose: false",
|
|
"fields": {
|
|
"site_name": { "type": "string", "sensitive": false },
|
|
"site_url": { "type": "string", "sensitive": false, "expose": false },
|
|
"site_description": { "type": "string", "sensitive": false },
|
|
"admin_email": { "type": "string", "sensitive": false, "expose": false },
|
|
"language": { "type": "string", "sensitive": false, "expose": false },
|
|
"timezone": { "type": "string", "sensitive": false, "expose": false },
|
|
"site_logo": { "type": "array", "sensitive": false, "transform": "attachments" },
|
|
"site_logo_url": { "type": "string", "sensitive": false, "computed": true, "source": "site_logo", "transform": "first_image_url" },
|
|
"asset_url_mode": { "type": "string", "sensitive": false }
|
|
}
|
|
},
|
|
"security": {
|
|
"expose": false,
|
|
"_comment": "보안 정책은 프론트엔드에서 미참조 — 노출 시 공격자에게 정보 제공 위험"
|
|
},
|
|
"mail": {
|
|
"expose": false,
|
|
"_comment": "mail 설정은 password 포함으로 프론트엔드에 노출하지 않음"
|
|
},
|
|
"upload": {
|
|
"expose": true,
|
|
"fields": {
|
|
"max_file_size": { "type": "integer", "sensitive": false },
|
|
"allowed_extensions": { "type": "string", "sensitive": false, "transform": "join_comma", "expose": false },
|
|
"allowed_extensions_formatted": { "type": "string", "sensitive": false, "computed": true, "source": "allowed_extensions", "transform": "format_extensions" },
|
|
"image_max_width": { "type": "integer", "sensitive": false },
|
|
"image_max_height": { "type": "integer", "sensitive": false },
|
|
"image_quality": { "type": "integer", "sensitive": false, "expose": false }
|
|
}
|
|
},
|
|
"seo": {
|
|
"expose": false,
|
|
"_comment": "SEO 설정 전체 — 프론트엔드 미참조 (admin 환경설정 폼은 API 데이터 기반)",
|
|
"fields": {
|
|
"meta_title_suffix": { "type": "string", "sensitive": false },
|
|
"meta_description": { "type": "string", "sensitive": false },
|
|
"meta_keywords": { "type": "string", "sensitive": false },
|
|
"google_analytics_id": { "type": "string", "sensitive": false },
|
|
"google_site_verification": { "type": "string", "sensitive": false },
|
|
"naver_site_verification": { "type": "string", "sensitive": false },
|
|
"bot_user_agents": { "type": "array", "sensitive": false },
|
|
"bot_detection_enabled": { "type": "boolean", "sensitive": false },
|
|
"bot_detection_library_enabled": { "type": "boolean", "sensitive": false },
|
|
"og_default_site_name": { "type": "string", "sensitive": false },
|
|
"og_image_default_width": { "type": "integer", "sensitive": false },
|
|
"og_image_default_height": { "type": "integer", "sensitive": false },
|
|
"twitter_default_card": { "type": "string", "sensitive": false },
|
|
"twitter_default_site": { "type": "string", "sensitive": false },
|
|
"cache_enabled": { "type": "boolean", "sensitive": false },
|
|
"cache_ttl": { "type": "integer", "sensitive": false },
|
|
"sitemap_enabled": { "type": "boolean", "sensitive": false },
|
|
"sitemap_cache_ttl": { "type": "integer", "sensitive": false },
|
|
"sitemap_urls_per_file": { "type": "integer", "sensitive": false },
|
|
"sitemap_gzip": { "type": "boolean", "sensitive": false },
|
|
"sitemap_serve_stale_on_miss": { "type": "boolean", "sensitive": false },
|
|
"sitemap_max_urls_per_contributor": { "type": "integer", "sensitive": false },
|
|
"sitemap_hreflang_enabled": { "type": "boolean", "sensitive": false },
|
|
"sitemap_schedule": { "type": "string", "sensitive": false },
|
|
"sitemap_schedule_time": { "type": "string", "sensitive": false },
|
|
"sitemap_last_updated_at": { "type": "string", "sensitive": false },
|
|
"generator_enabled": { "type": "boolean", "sensitive": false },
|
|
"generator_content": { "type": "string", "sensitive": false }
|
|
}
|
|
},
|
|
"cache": {
|
|
"expose": true,
|
|
"frontend_name": "advanced",
|
|
"_comment": "cache와 debug를 합쳐서 advanced로 노출",
|
|
"fields": {
|
|
"enabled": { "type": "boolean", "sensitive": false, "frontend_key": "cache_enabled", "expose": false },
|
|
"default_ttl": { "type": "integer", "sensitive": false, "frontend_key": "cache_default_ttl", "expose": false },
|
|
"layout_enabled": { "type": "boolean", "sensitive": false, "frontend_key": "layout_cache_enabled", "expose": false },
|
|
"layout_ttl": { "type": "integer", "sensitive": false, "frontend_key": "layout_cache_ttl", "expose": false },
|
|
"seo_enabled": { "type": "boolean", "sensitive": false, "frontend_key": "seo_cache_enabled", "expose": false },
|
|
"seo_ttl": { "type": "integer", "sensitive": false, "frontend_key": "seo_cache_ttl", "expose": false },
|
|
"seo_sitemap_ttl": { "type": "integer", "sensitive": false, "frontend_key": "seo_sitemap_cache_ttl", "expose": false },
|
|
"stats_enabled": { "type": "boolean", "sensitive": false, "frontend_key": "stats_cache_enabled", "expose": false },
|
|
"stats_ttl": { "type": "integer", "sensitive": false, "frontend_key": "stats_cache_ttl", "expose": false },
|
|
"notification_ttl": { "type": "integer", "sensitive": false, "frontend_key": "notification_cache_ttl", "expose": false },
|
|
"extension_status_ttl": { "type": "integer", "sensitive": false, "frontend_key": "extension_status_cache_ttl", "expose": false },
|
|
"geoip_enabled": { "type": "boolean", "sensitive": false, "frontend_key": "geoip_cache_enabled", "expose": false },
|
|
"geoip_ttl": { "type": "integer", "sensitive": false, "frontend_key": "geoip_cache_ttl", "expose": false },
|
|
"version_check_ttl": { "type": "integer", "sensitive": false, "frontend_key": "version_check_cache_ttl", "expose": false }
|
|
}
|
|
},
|
|
"debug": {
|
|
"expose": true,
|
|
"merge_into": "advanced",
|
|
"_comment": "debug 설정은 advanced 카테고리에 병합",
|
|
"fields": {
|
|
"mode": { "type": "boolean", "sensitive": false, "frontend_key": "debug_mode" },
|
|
"sql_query_log": { "type": "boolean", "sensitive": false, "expose": false }
|
|
}
|
|
},
|
|
"core_update": {
|
|
"expose": true,
|
|
"merge_into": "advanced",
|
|
"_comment": "core_update 설정은 advanced 카테고리에 병합",
|
|
"fields": {
|
|
"github_url": { "type": "string", "sensitive": false, "frontend_key": "core_update_github_url", "expose": false },
|
|
"github_token": { "type": "string", "sensitive": true, "frontend_key": "core_update_github_token" }
|
|
}
|
|
},
|
|
"geoip": {
|
|
"expose": true,
|
|
"merge_into": "advanced",
|
|
"_comment": "GeoIP 기능 설정은 advanced 카테고리에 병합",
|
|
"fields": {
|
|
"feature_enabled": { "type": "boolean", "sensitive": false, "frontend_key": "geoip_enabled" },
|
|
"license_key": { "type": "string", "sensitive": true, "frontend_key": "geoip_license_key" },
|
|
"auto_update_enabled": { "type": "boolean", "sensitive": false, "frontend_key": "geoip_auto_update_enabled" },
|
|
"last_updated_at": { "type": "string", "sensitive": false, "frontend_key": "geoip_last_updated_at" }
|
|
}
|
|
},
|
|
"pagination": {
|
|
"expose": true,
|
|
"merge_into": "advanced",
|
|
"_comment": "목록 한계값 — advanced 카테고리에 병합",
|
|
"fields": {
|
|
"result_cap": { "type": "integer", "sensitive": false, "frontend_key": "pagination_result_cap" },
|
|
"max_page": { "type": "integer", "sensitive": false, "frontend_key": "pagination_max_page" }
|
|
}
|
|
},
|
|
"drivers": {
|
|
"expose": false,
|
|
"_comment": "드라이버 설정 — 프론트엔드 미노출 (admin_settings에서 API 원본값 기반 비교로 변경)",
|
|
"fields": {
|
|
"storage_driver": { "type": "string", "sensitive": false },
|
|
"s3_bucket": { "type": "string", "sensitive": false },
|
|
"s3_region": { "type": "string", "sensitive": false },
|
|
"s3_access_key": { "type": "string", "sensitive": true },
|
|
"s3_secret_key": { "type": "string", "sensitive": true },
|
|
"s3_url": { "type": "string", "sensitive": false },
|
|
"s3_endpoint": { "type": "string", "sensitive": false },
|
|
"s3_use_path_style": { "type": "boolean", "sensitive": false },
|
|
"cache_driver": { "type": "string", "sensitive": false },
|
|
"redis_host": { "type": "string", "sensitive": false },
|
|
"redis_port": { "type": "integer", "sensitive": false },
|
|
"redis_password": { "type": "string", "sensitive": true },
|
|
"redis_database": { "type": "integer", "sensitive": false },
|
|
"memcached_host": { "type": "string", "sensitive": false },
|
|
"memcached_port": { "type": "integer", "sensitive": false },
|
|
"session_driver": { "type": "string", "sensitive": false },
|
|
"session_lifetime": { "type": "integer", "sensitive": false },
|
|
"queue_driver": { "type": "string", "sensitive": false },
|
|
"log_driver": { "type": "string", "sensitive": false },
|
|
"log_level": { "type": "string", "sensitive": false },
|
|
"log_days": { "type": "integer", "sensitive": false },
|
|
"websocket_enabled": { "type": "boolean", "sensitive": false },
|
|
"websocket_app_id": { "type": "string", "sensitive": false },
|
|
"websocket_app_key": { "type": "string", "sensitive": false },
|
|
"websocket_app_secret": { "type": "string", "sensitive": true },
|
|
"websocket_host": { "type": "string", "sensitive": false },
|
|
"websocket_port": { "type": "integer", "sensitive": false },
|
|
"websocket_scheme": { "type": "string", "sensitive": false },
|
|
"websocket_verify_ssl": { "type": "boolean", "sensitive": false },
|
|
"websocket_server_host": { "type": "string", "sensitive": false },
|
|
"websocket_server_port": { "type": "integer", "sensitive": false },
|
|
"websocket_server_scheme": { "type": "string", "sensitive": false },
|
|
"search_engine_driver": { "type": "string", "sensitive": false }
|
|
}
|
|
},
|
|
"notifications": {
|
|
"expose": true,
|
|
"fields": {
|
|
"channels": { "type": "array", "sensitive": false }
|
|
}
|
|
},
|
|
"identity": {
|
|
"expose": true,
|
|
"_comment": "본인인증 인프라 provider 기술 파라미터 — signup/enabled 등 정책 분기 키는 IdentityPolicy 로 흡수됨",
|
|
"fields": {
|
|
"default_provider": { "type": "string", "sensitive": false },
|
|
"purpose_providers": { "type": "array", "sensitive": false, "expose": false },
|
|
"challenge_ttl_minutes": { "type": "integer", "sensitive": false, "expose": false },
|
|
"max_attempts": { "type": "integer", "sensitive": false, "expose": false }
|
|
}
|
|
}
|
|
}
|
|
}
|