웹 브라우저 샌드박스를 넘어 물리 OS를 지휘하다: ZeliDesk.Core WebMessagePayload & LauncherItem의 WinUI 3 ↔ WebView2 양방향 JSON IPC 프로토콜 및 화이트리스트 거버넌스 아키텍처

namespace ZeliDesk.Core.Models
{
    /// <summary>
    /// WebView2와 WinUI 3 간의 양방향 IPC 메시징을 위한 단일 진실 공급원(SSOT) 페이로드 DTO
    /// </summary>
    public class WebMessagePayload
    {
        public string Command { get; set; } // 수행할 네이티브 액션 (예: open_tab, launch_native, serial_open)
        public string Target { get; set; }  // 실행 대상 식별자 또는 포트 번호 (예: Chrome, COM3)
        public string Data { get; set; }    // 명령에 수반되는 추가 직렬화 파라미터 (선택)
    }
}

case "launch_native":
    // 1. 공백 제거 및 소문자 변환으로 비교 키 정규화
    string normalizedTarget = payload.Target?.Replace(" ", "").ToLowerInvariant();

    // 2. 사전에 등록된 공식 LauncherItemRegistry 화이트리스트 카탈로그에서만 검색
    var nativeItem = _allItems.FirstOrDefault(i =>
        string.Equals(i.Name, payload.Target, StringComparison.OrdinalIgnoreCase) ||
        string.Equals(GetCleanName(i), payload.Target, StringComparison.OrdinalIgnoreCase) ||
        string.Equals(i.Target, payload.Target, StringComparison.OrdinalIgnoreCase) ||
        (GetCleanName(i).Replace(" ", "").ToLowerInvariant() == normalizedTarget) ||
        (i.Target?.Replace(" ", "").ToLowerInvariant() == normalizedTarget)
    );

    // 3. 화이트리스트에 등록되지 않은 임의의 실행 파일이나 명령은 100% 무시
    if (nativeItem != null)
    {
        // 선언적 실행 로직 디스패치...
    }
    break;

// ── ZeliDesk.Core.Models.LauncherItem.cs ──
namespace ZeliDesk.Core.Models
{
    public enum LauncherItemType
    {
        Web,        // WebView2 내부 탭으로 열기
        NativeApp,  // 로컬 설치 프로그램 실행
        SystemCmd,  // Windows 시스템 설정/명령
        InternalApp // ZeliDesk 자체 내장 유틸리티
    }

    public class LauncherItem
    {
        public string Name { get; set; }
        public string Target { get; set; }   // URL 또는 실행파일 경로/명령
        public string Icon { get; set; }     // 이모지 또는 글리프 아이콘
        public LauncherItemType Type { get; set; }
        public string Category { get; set; } // 그룹 분류 (교육, 업무, 시스템, AI)
        public string Args { get; set; }     // 실행 인자 (선택)
    }
}

// ── MainWindow.xaml.cs (WebView2 수신 디스패처) ──
private void MyWebView_WebMessageReceived(WebView2 sender, CoreWebView2WebMessageReceivedEventArgs args)
{
    try
    {
        // 1. 웹 메시지 문자열 추출
        var json = args.TryGetWebMessageAsString();
        if (string.IsNullOrEmpty(json)) return;

        // 2. 단일 진실 공급원 WebMessagePayload로 안전 역직렬화
        var payload = JsonSerializer.Deserialize<WebMessagePayload>(
            json,
            new JsonSerializerOptions { PropertyNameCaseInsensitive = true }
        );

        if (payload == null || string.IsNullOrEmpty(payload.Command)) return;

        // 3. 명령별 안전 분기 처리
        switch (payload.Command.ToLowerInvariant())
        {
            case "open_tab":
                var targetWebItem = _allItems.FirstOrDefault(i => 
                    string.Equals(i.Name, payload.Target, StringComparison.OrdinalIgnoreCase) ||
                    string.Equals(GetCleanName(i), payload.Target, StringComparison.OrdinalIgnoreCase));
                if (targetWebItem != null && targetWebItem.Type == LauncherItemType.Web)
                {
                    SelectOrCreateTab(targetWebItem);
                }
                break;

            case "launch_native":
                string normalizedTarget = payload.Target?.Replace(" ", "").ToLowerInvariant();
                var nativeItem = _allItems.FirstOrDefault(i =>
                    string.Equals(i.Name, payload.Target, StringComparison.OrdinalIgnoreCase) ||
                    string.Equals(GetCleanName(i), payload.Target, StringComparison.OrdinalIgnoreCase) ||
                    string.Equals(i.Target, payload.Target, StringComparison.OrdinalIgnoreCase) ||
                    (GetCleanName(i).Replace(" ", "").ToLowerInvariant() == normalizedTarget) ||
                    (i.Target?.Replace(" ", "").ToLowerInvariant() == normalizedTarget)
                );

                if (nativeItem != null)
                {
                    if (nativeItem.Type == LauncherItemType.NativeApp || nativeItem.Type == LauncherItemType.SystemCmd)
                        NativeLauncher.Launch(nativeItem.Target, nativeItem.Args);
                    else if (nativeItem.Type == LauncherItemType.InternalApp)
                        LaunchInternalApp(nativeItem.Target);
                }
                break;

            case "serial_open":
                EnsureSerialManager();
                var openData = ParseSerialOptions(payload.Data);
                bool opened = _serialManager.Open(payload.Target, openData.baud, openData.parity, openData.dataBits, openData.stopBits);
                SendMessageToWeb("serial_opened", new { port = payload.Target, success = opened });
                break;
        }
    }
    catch (Exception ex)
    {
        Debug.WriteLine($"[WebBridge Error] {ex.Message}");
    }
}