sam-manage/config/api-explorer.php

<?php

return [
    /*
    |--------------------------------------------------------------------------
    | OpenAPI Spec File Path
    |--------------------------------------------------------------------------
    |
    | api-docs.json 파일 경로
    |
    */
    'openapi_path' => env('API_EXPLORER_OPENAPI_PATH', storage_path('api-docs/api-docs-v1.json')),

    /*
    |--------------------------------------------------------------------------
    | Default Environments
    |--------------------------------------------------------------------------
    |
    | 기본 환경 설정 (사용자가 커스텀 환경을 추가하기 전 기본값)
    |
    */
    'default_environments' => [
        [
            'name' => '로컬',
            'base_url' => env('API_EXPLORER_LOCAL_URL', 'http://sam-api-1'),
            'api_key' => env('FLOW_TESTER_API_KEY', ''),
        ],
        [
            'name' => '개발',
            'base_url' => 'https://api.codebridge-x.com',
            'api_key' => env('FLOW_TESTER_API_KEY', ''),
        ],
    ],

    /*
    |--------------------------------------------------------------------------
    | Proxy Settings
    |--------------------------------------------------------------------------
    |
    | API 프록시 설정
    |
    */
    'proxy' => [
        'timeout' => 30,                    // 초
        'max_body_size' => 1024 * 1024,     // 1MB
        'allowed_hosts' => [                // 화이트리스트
            'api.sam.kr',
            'api.codebridge-x.com',
            'sam-api-1',                    // Docker 컨테이너
            'localhost',
            '127.0.0.1',
        ],
    ],

    /*
    |--------------------------------------------------------------------------
    | History Settings
    |--------------------------------------------------------------------------
    |
    | 히스토리 설정
    |
    */
    'history' => [
        'max_entries' => 100,               // 사용자당 최대
        'retention_days' => 30,             // 보관 기간
    ],

    /*
    |--------------------------------------------------------------------------
    | Security Settings
    |--------------------------------------------------------------------------
    |
    | 보안 설정
    |
    */
    'security' => [
        'encrypt_tokens' => true,           // API Key/Token 암호화
        'mask_sensitive_headers' => [       // 히스토리에서 마스킹
            'Authorization',
            'X-API-KEY',
            'Cookie',
        ],
    ],

    /*
    |--------------------------------------------------------------------------
    | Cache Settings
    |--------------------------------------------------------------------------
    |
    | OpenAPI 스펙 캐싱 설정
    |
    */
    'cache' => [
        'enabled' => true,
        'ttl' => 3600,                      // 1시간
        'key' => 'api_explorer_openapi_spec',
    ],
];