HeuJung
1124fad027
허용목록이 플러그인 코드 상수라, 새 확장이 저장 키를 도입할 때마다 이 플러그인을 고쳐야 했다. 고치지 않으면 그 키는 방문마다 파기되는데 예외도 로그도 남지 않아 운영자에게는 "설정이 저장되지 않는다" 는 증상만 보인다. 허용목록을 운영자 설정(necessary_storage_allowlist)으로 옮기고, 관리자 환경설정에 브라우저 저장소·세션 저장소·쿠키 세 카드를 두어 직접 편집하게 했다. 확장은 GDPR 을 알 필요가 없고 GDPR 도 확장을 알 필요가 없다 — 연결은 운영자가 화면에서 한다. 저장 키를 플러그인이 관측·수집하지 않는 것도 같은 이유다: 관측 자체가 추적이다. 판정은 서버(미들웨어)와 클라이언트 셋(인터셉터 둘 + 정리기)이 같은 설정을 같은 매칭 규칙으로 읽는다. 잠금 항목(로그인 토큰·CSRF·세션 쿠키·동의 기록)만 설정 밖에 두고 판정 시점에 합집합으로 얹는다 — 설정에 담기면 저장 요청 한 번으로 지워져 잠금이 아니게 된다. 기설치본은 업그레이드 스텝이 현재 카탈로그를 설정 파일에 못박되, 운영자가 이미 편집했으면 그대로 둔다. 함께 고친 선재 결함 셋: - 차단 도메인 추천 목록이 응답에 실리지 않아 자동완성이 동작하지 않던 문제 - 세션 쿠키 이름을 기본값에서 바꾼 사이트에서 브라우저 측 목록의 그 항목이 죽던 문제 - 쿠키 목록에만 앞부분 매칭(`이름_*`)이 적용되지 않던 문제
375 lines
18 KiB
PHP
375 lines
18 KiB
PHP
<?php
|
|
|
|
namespace Plugins\Sirsoft\Gdpr\Http\Requests;
|
|
|
|
use Illuminate\Foundation\Http\FormRequest;
|
|
use Illuminate\Validation\Validator;
|
|
|
|
/**
|
|
* 관리자 GDPR 설정 저장 요청 검증
|
|
*
|
|
* PUT /api/plugins/sirsoft-gdpr/admin/settings
|
|
*
|
|
* 운영자가 설정 화면에서 정책 메타데이터·쿠키 배너·마이페이지 카드 토글을
|
|
* 저장할 때 사용. plugin.php::getSettingsSchema() 와 키 일치를 보장합니다.
|
|
*/
|
|
class UpdateAdminSettingsRequest extends FormRequest
|
|
{
|
|
/**
|
|
* 배너 위치 허용 값
|
|
*/
|
|
private const BANNER_POSITIONS = [
|
|
'bottom_bar',
|
|
'bottom_left_popup',
|
|
'bottom_right_popup',
|
|
'centered_modal',
|
|
];
|
|
|
|
/**
|
|
* 차단 도메인 정규식
|
|
*
|
|
* - FQDN 만 허용 (점 1개 이상 — RFC 1035 기반)
|
|
* - 와일드카드 prefix `*.` 허용 (예: *.hotjar.com)
|
|
* - 하이픈은 라벨 시작/끝 금지 (RFC 1035)
|
|
* - 대소문자 무관
|
|
* - 숫자만으로 구성된 라벨 허용 (예: 1.2.3.4 는 IPv4 처럼 보이지만 정규식상 통과 — 실제 DNS 동작은 CDN/PaaS 에 의존)
|
|
* - punycode·localhost·단일 라벨 도메인 미지원 (운영자 안내 박스 hint 명시)
|
|
*/
|
|
private const DOMAIN_REGEX = '/^(\*\.)?[a-z0-9]([a-z0-9-]*[a-z0-9])?(\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)+$/i';
|
|
|
|
/**
|
|
* 필수 저장 항목(저장소 키 / 쿠키 이름) 정규식
|
|
*
|
|
* - 이름 문자: 영숫자와 `_ . : @ + -` (코어·확장이 실제로 쓰는 키 형태)
|
|
* - 와일드카드 `*` 는 **끝에만** 1개 허용 (`g7_filters_*`)
|
|
* - `*` 단독 표기는 허용하지 않는다 — 접두사가 비면 전체 개방이 되어 게이트가 무력화된다
|
|
*/
|
|
private const STORAGE_KEY_REGEX = '/^[A-Za-z0-9_.:@+\-]+\*?$/';
|
|
|
|
/**
|
|
* 필수 저장 항목 허용목록의 스코프 화이트리스트
|
|
*
|
|
* blocked_domains 는 카테고리 키를 검사하지 않고 남긴 빈틈이 있는데, 여기서는 남기지
|
|
* 않는다 — 스코프가 오타나면 그 항목은 어떤 판정에도 쓰이지 않은 채 저장되고,
|
|
* 운영자에게는 "등록했는데 안 되는" 상태로만 보인다.
|
|
*
|
|
* @var array<int, string>
|
|
*/
|
|
private const ALLOWLIST_SCOPES = ['localStorage', 'sessionStorage', 'cookie'];
|
|
|
|
/**
|
|
* 권한 확인 (permission 미들웨어에서 처리)
|
|
*
|
|
* @return bool
|
|
*/
|
|
public function authorize(): bool
|
|
{
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* 검증 규칙 정의
|
|
*
|
|
* @return array<string, mixed>
|
|
*/
|
|
public function rules(): array
|
|
{
|
|
return [
|
|
// 정책 메타데이터 — cookie_policy_version 은 gdpr_policy_versions 테이블이 SSoT.
|
|
// 운영자가 직접 입력하지 않으므로 본 FormRequest 에서 검증하지 않음 (전달되어도 stripped).
|
|
'privacy_policy_slug' => ['nullable', 'string', 'max:100', 'regex:/^[a-z0-9\-]*$/'],
|
|
'legal_entity_name' => ['nullable', 'string', 'max:200'],
|
|
// 데이터 저장 위치 — GDPR Art.13(1)(f) / PIPA 28조의8 은 "국가 단위" 표기를 요구.
|
|
// 운영자가 실수로 보안 민감 식별자 (IP / CIDR / AWS 리전 코드) 를 입력하지 않도록
|
|
// not_regex 3종으로 차단. 통과한 일반 텍스트는 운영자 자유 입력 허용.
|
|
'data_storage_location' => [
|
|
'nullable',
|
|
'string',
|
|
'max:200',
|
|
'not_regex:/\b\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3}(\/\d{1,2})?\b/', // IPv4 / CIDR
|
|
'not_regex:/\b[a-z]{2,}-[a-z]+(-\d+[a-z]?|\d+)\b/i', // 리전 코드: AWS ap-northeast-2, GCP asia-northeast3, Azure eastus2 패턴
|
|
'not_regex:/\b(us|eu|ap|me|af|sa|ca)-(east|west|north|south|central|northeast|southeast|northwest|southwest)\b/i', // 리전 prefix 만 입력해도 차단 (예: us-east, ap-northeast)
|
|
],
|
|
|
|
// 쿠키 배너 + 자동 차단 (F-01 / F-02) — banner_enabled 단일 토글로 통합 제어.
|
|
// auto_blocking_enabled 별도 검증 규칙 없음: 운영자가 PUT 으로 키를 보내도 stripped.
|
|
'banner_enabled' => ['nullable', 'boolean'],
|
|
'banner_position' => ['nullable', 'string', 'in:'.implode(',', self::BANNER_POSITIONS)],
|
|
// cookie_categories.*.required 는 운영자 입력 경로가 없으므로 검증하지 않음 (CookieCategory enum 이 SSoT).
|
|
'cookie_categories' => ['nullable'],
|
|
'cookie_categories.*.key' => ['required_with:cookie_categories', 'string', 'in:necessary,functional,analytics,marketing'],
|
|
'cookie_categories.*.label' => ['required_with:cookie_categories', 'array'],
|
|
'cookie_categories.*.label.ko' => ['required_with:cookie_categories', 'string', 'max:50'],
|
|
'cookie_categories.*.label.en' => ['required_with:cookie_categories', 'string', 'max:50'],
|
|
'cookie_categories.*.description' => ['nullable', 'array'],
|
|
|
|
// F-02 도메인 기반 차단
|
|
'blocked_domains' => ['nullable', 'array'],
|
|
'blocked_domains.*' => ['array'],
|
|
'blocked_domains.*.*' => ['string', 'max:253', 'regex:'.self::DOMAIN_REGEX],
|
|
|
|
// 필수 저장 항목 허용목록 — 스코프(localStorage/sessionStorage/cookie) 별 문자열 배열.
|
|
// 스코프 키 화이트리스트는 withValidator() 에서 검사한다 (규칙 문법으로는 키를 못 건다).
|
|
// necessary_storage_locked 는 규칙에 넣지 않는다 → validated() 에서 자동 배제되어
|
|
// 운영자가 그 키를 보내도 저장되지 않는다 (잠금 항목은 코드가 정한다).
|
|
'necessary_storage_allowlist' => ['nullable', 'array'],
|
|
'necessary_storage_allowlist.*' => ['array'],
|
|
'necessary_storage_allowlist.*.*' => ['string', 'max:128', 'regex:'.self::STORAGE_KEY_REGEX],
|
|
];
|
|
}
|
|
|
|
/**
|
|
* 검증 메시지 정의
|
|
*
|
|
* @return array<string, string>
|
|
*/
|
|
public function messages(): array
|
|
{
|
|
return [
|
|
'data_storage_location.not_regex' => __('sirsoft-gdpr::messages.settings.fields.data_storage_location.sensitive_format'),
|
|
'cookie_categories.*.key.in' => __('sirsoft-gdpr::messages.consent.invalid_key'),
|
|
// 카테고리별 메시지 — 운영자가 어떤 카테고리의 어느 도메인이 잘못됐는지 즉시 식별 가능.
|
|
// GDPR 4카테고리 중 necessary 는 차단 대상 아님 → functional / analytics / marketing 만 정의.
|
|
'blocked_domains.functional.*.regex' => __('sirsoft-gdpr::messages.blocked_domains.invalid_format_functional'),
|
|
'blocked_domains.functional.*.max' => __('sirsoft-gdpr::messages.blocked_domains.too_long_functional'),
|
|
'blocked_domains.analytics.*.regex' => __('sirsoft-gdpr::messages.blocked_domains.invalid_format_analytics'),
|
|
'blocked_domains.analytics.*.max' => __('sirsoft-gdpr::messages.blocked_domains.too_long_analytics'),
|
|
'blocked_domains.marketing.*.regex' => __('sirsoft-gdpr::messages.blocked_domains.invalid_format_marketing'),
|
|
'blocked_domains.marketing.*.max' => __('sirsoft-gdpr::messages.blocked_domains.too_long_marketing'),
|
|
'blocked_domains.*.array' => __('sirsoft-gdpr::messages.blocked_domains.must_be_array'),
|
|
// 스코프별 메시지 — 운영자가 어느 카드의 어느 항목이 잘못됐는지 즉시 식별 가능.
|
|
'necessary_storage_allowlist.localStorage.*.regex' => __('sirsoft-gdpr::messages.necessary_storage_allowlist.invalid_format_local_storage'),
|
|
'necessary_storage_allowlist.localStorage.*.max' => __('sirsoft-gdpr::messages.necessary_storage_allowlist.too_long_local_storage'),
|
|
'necessary_storage_allowlist.sessionStorage.*.regex' => __('sirsoft-gdpr::messages.necessary_storage_allowlist.invalid_format_session_storage'),
|
|
'necessary_storage_allowlist.sessionStorage.*.max' => __('sirsoft-gdpr::messages.necessary_storage_allowlist.too_long_session_storage'),
|
|
'necessary_storage_allowlist.cookie.*.regex' => __('sirsoft-gdpr::messages.necessary_storage_allowlist.invalid_format_cookie'),
|
|
'necessary_storage_allowlist.cookie.*.max' => __('sirsoft-gdpr::messages.necessary_storage_allowlist.too_long_cookie'),
|
|
'necessary_storage_allowlist.*.array' => __('sirsoft-gdpr::messages.necessary_storage_allowlist.must_be_array'),
|
|
];
|
|
}
|
|
|
|
/**
|
|
* 검증 메시지의 :attribute placeholder 를 사용자 친화 한국어/영어 라벨로 치환.
|
|
*
|
|
* Laravel 기본 :attribute 는 underscore 만 공백으로 치환한 영문 표현 (예: "privacy policy slug")
|
|
* 노출 → 사용자 친화도 낮음. 본 메서드로 각 필드에 한국어/영어 라벨 매핑.
|
|
*
|
|
* 라벨 출처는 lang/{locale}/messages.php 의 settings.fields.{field}.label 키.
|
|
*
|
|
* @return array<string, string>
|
|
*/
|
|
public function attributes(): array
|
|
{
|
|
return [
|
|
// cookie_policy_version 은 자동 발행이므로 FormRequest 가 검증하지 않음 (attributes 도 불필요).
|
|
'privacy_policy_slug' => __('sirsoft-gdpr::messages.settings.fields.privacy_policy_slug.label'),
|
|
'legal_entity_name' => __('sirsoft-gdpr::messages.settings.fields.legal_entity_name.label'),
|
|
'data_storage_location' => __('sirsoft-gdpr::messages.settings.fields.data_storage_location.label'),
|
|
'banner_enabled' => __('sirsoft-gdpr::messages.settings.fields.banner_enabled.label'),
|
|
'banner_position' => __('sirsoft-gdpr::messages.settings.fields.banner_position.label'),
|
|
'cookie_categories' => __('sirsoft-gdpr::messages.settings.section.cookie_categories'),
|
|
'blocked_domains' => __('sirsoft-gdpr::messages.settings.section.auto_blocking'),
|
|
'necessary_storage_allowlist' => __('sirsoft-gdpr::messages.settings.section.necessary_storage'),
|
|
];
|
|
}
|
|
|
|
/**
|
|
* 사전 정규화:
|
|
* 1. cookie_categories 가 JSON 문자열로 들어와도 array 로 변환
|
|
* 2. blocked_domains 의 카테고리별 값이 textarea 줄바꿈 문자열이면 배열로 변환
|
|
* (한 줄당 도메인 하나, 빈 줄 제거, trim)
|
|
* 3. cookie_categories 의 키 중 necessary 제외한 모든 키가 blocked_domains 에
|
|
* 존재하도록 빈 배열로 자동 보충 (운영자가 새 카테고리 추가 시 UI iteration
|
|
* 미렌더·검증 실패 방지)
|
|
* 4. necessary_storage_allowlist 도 같은 방식으로 정규화 (줄바꿈 문자열 분해 · trim ·
|
|
* 빈 항목 제거 · 세 스코프 빈 배열 보충)
|
|
*
|
|
* @return void
|
|
*/
|
|
protected function prepareForValidation(): void
|
|
{
|
|
$cookieCategories = $this->normalizeJsonArray($this->input('cookie_categories'));
|
|
|
|
$blockedDomains = $this->normalizeBlockedDomains(
|
|
$this->input('blocked_domains'),
|
|
is_array($cookieCategories) ? $cookieCategories : [],
|
|
);
|
|
|
|
$merge = ['cookie_categories' => $cookieCategories];
|
|
if ($blockedDomains !== null) {
|
|
$merge['blocked_domains'] = $blockedDomains;
|
|
}
|
|
|
|
$necessaryAllowlist = $this->normalizeNecessaryAllowlist($this->input('necessary_storage_allowlist'));
|
|
if ($necessaryAllowlist !== null) {
|
|
$merge['necessary_storage_allowlist'] = $necessaryAllowlist;
|
|
}
|
|
|
|
$this->merge($merge);
|
|
}
|
|
|
|
/**
|
|
* necessary_storage_allowlist 입력을 정규화합니다.
|
|
*
|
|
* 스코프별 값이 string 이면 줄바꿈으로 split → trim → 빈 항목 제거. 이미 array 면 항목만
|
|
* trim 합니다. 세 스코프 중 없는 것은 빈 배열로 보충해 UI 가 항상 세 카드를 그리도록
|
|
* 합니다. **키를 아예 보내지 않았으면 null 을 돌려** 기존 저장값을 보존합니다 — 빈 배열로
|
|
* 보충해 버리면 이 화면을 모르는 클라이언트의 저장 한 번이 허용목록을 통째로 비운다.
|
|
*
|
|
* 스코프 키 자체는 여기서 거르지 않습니다 — 오타 스코프를 조용히 버리면 운영자에게는
|
|
* "저장했는데 사라지는" 상태가 되므로, withValidator() 가 422 로 알립니다.
|
|
*
|
|
* @param mixed $input necessary_storage_allowlist 입력값
|
|
* @return array<string, array<int, string>>|null
|
|
*/
|
|
private function normalizeNecessaryAllowlist(mixed $input): ?array
|
|
{
|
|
if (! is_array($input)) {
|
|
return null;
|
|
}
|
|
|
|
$normalized = [];
|
|
foreach ($input as $scope => $value) {
|
|
if (is_string($value)) {
|
|
$normalized[$scope] = collect(preg_split('/\R/', $value))
|
|
->map(fn ($line) => is_string($line) ? trim($line) : '')
|
|
->filter(fn ($line) => $line !== '')
|
|
->values()
|
|
->all();
|
|
} elseif (is_array($value)) {
|
|
$normalized[$scope] = array_values(array_filter(
|
|
array_map(fn ($line) => is_string($line) ? trim($line) : '', $value),
|
|
fn ($line) => $line !== '',
|
|
));
|
|
} else {
|
|
$normalized[$scope] = [];
|
|
}
|
|
}
|
|
|
|
foreach (self::ALLOWLIST_SCOPES as $scope) {
|
|
if (! array_key_exists($scope, $normalized)) {
|
|
$normalized[$scope] = [];
|
|
}
|
|
}
|
|
|
|
return $normalized;
|
|
}
|
|
|
|
/**
|
|
* blocked_domains 입력을 정규화합니다.
|
|
*
|
|
* 카테고리별 값이 string 이면 줄바꿈으로 split → trim → 빈 항목 제거.
|
|
* 이미 array 면 그대로 보존. cookie_categories 의 키 (necessary 제외) 가
|
|
* blocked_domains 에 없으면 빈 배열로 보충하여 UI iteration·검증 실패를 방지합니다.
|
|
*
|
|
* @param mixed $input blocked_domains 입력값
|
|
* @param array $cookieCategories cookie_categories 정규화된 배열
|
|
* @return array<string, array<int, string>>|null
|
|
*/
|
|
private function normalizeBlockedDomains(mixed $input, array $cookieCategories): ?array
|
|
{
|
|
if ($input === null) {
|
|
return null;
|
|
}
|
|
|
|
if (! is_array($input)) {
|
|
return null;
|
|
}
|
|
|
|
$normalized = [];
|
|
foreach ($input as $category => $value) {
|
|
if (is_string($value)) {
|
|
$normalized[$category] = collect(preg_split('/\R/', $value))
|
|
->map(fn ($line) => is_string($line) ? trim($line) : '')
|
|
->filter(fn ($line) => $line !== '')
|
|
->values()
|
|
->all();
|
|
} elseif (is_array($value)) {
|
|
$normalized[$category] = array_values(array_filter(
|
|
array_map(fn ($line) => is_string($line) ? trim($line) : '', $value),
|
|
fn ($line) => $line !== '',
|
|
));
|
|
} else {
|
|
$normalized[$category] = [];
|
|
}
|
|
}
|
|
|
|
// cookie_categories 의 키 (necessary 제외) 가 blocked_domains 에 없으면 빈 배열로 보충
|
|
foreach ($cookieCategories as $category) {
|
|
$key = is_array($category) ? ($category['key'] ?? null) : null;
|
|
if (! is_string($key) || $key === '' || $key === 'necessary') {
|
|
continue;
|
|
}
|
|
if (! array_key_exists($key, $normalized)) {
|
|
$normalized[$key] = [];
|
|
}
|
|
}
|
|
|
|
return $normalized;
|
|
}
|
|
|
|
/**
|
|
* 검증 후 추가 검사:
|
|
* 1. cookie_categories 내 key 중복 차단
|
|
* 2. necessary_storage_allowlist 의 스코프 키가 화이트리스트에 있는지 검사
|
|
*
|
|
* @param Validator $validator
|
|
* @return void
|
|
*/
|
|
public function withValidator(Validator $validator): void
|
|
{
|
|
$validator->after(function (Validator $validator) {
|
|
$categories = (array) $this->input('cookie_categories', []);
|
|
$keys = array_column($categories, 'key');
|
|
if (count($keys) !== count(array_unique($keys))) {
|
|
$validator->errors()->add(
|
|
'cookie_categories',
|
|
__('sirsoft-gdpr::messages.consent.invalid_key')
|
|
);
|
|
}
|
|
|
|
$allowlist = $this->input('necessary_storage_allowlist');
|
|
if (is_array($allowlist)) {
|
|
foreach (array_keys($allowlist) as $scope) {
|
|
if (in_array($scope, self::ALLOWLIST_SCOPES, true)) {
|
|
continue;
|
|
}
|
|
|
|
$validator->errors()->add(
|
|
'necessary_storage_allowlist.'.$scope,
|
|
__('sirsoft-gdpr::messages.necessary_storage_allowlist.invalid_scope', [
|
|
'scope' => is_scalar($scope) ? (string) $scope : '',
|
|
])
|
|
);
|
|
}
|
|
}
|
|
});
|
|
}
|
|
|
|
/**
|
|
* JSON 문자열 또는 배열을 array 로 정규화합니다.
|
|
*
|
|
* @param mixed $value 입력 값
|
|
* @return array|null
|
|
*/
|
|
private function normalizeJsonArray(mixed $value): ?array
|
|
{
|
|
if ($value === null) {
|
|
return null;
|
|
}
|
|
|
|
if (is_array($value)) {
|
|
return $value;
|
|
}
|
|
|
|
if (is_string($value)) {
|
|
$decoded = json_decode($value, true);
|
|
if (is_array($decoded)) {
|
|
return $decoded;
|
|
}
|
|
}
|
|
|
|
return null;
|
|
}
|
|
}
|