CSRF Token Regenerate 문제 해결을 통한 AJAX 요청 안정성 확보

Context

CodeIgniter 4의 CSRF 보호 기법은 매 요청마다 Token을 갱신하는 $regenerate = true 설정을 기본으로 채택함. 이로 인해 AJAX 기반의 비동기 요청 시 이전 Token이 무효화되어 419 Error 및 Page Expired 현상이 발생하는 아키텍처적 한계 존재.

Technical Solution

• Security Config의 $redirect 설정을 false로 변경하여 Redirect 대신 JSON 에러 응답을 통한 클라이언트 제어권 확보
• Controller 응답 시 최신 CSRF Token과 Token Name을 JSON Payload에 포함하여 서버-클라이언트 간 상태 동기화 구현
• jQuery $.ajaxSetup을 통한 POST, PUT, DELETE 요청의 Request Header(X-CSRF-TOKEN) 및 Data Body 자동 주입 구조 설계
• ajaxComplete 콜백을 활용해 매 응답마다 클라이언트 메모리 내의 Token 값을 최신화하는 동적 갱신 루프 구축
• 특정 API 및 Webhook 엔드포인트를 Filters.php의 except 리스트에 등록하여 불필요한 CSRF 검증 제외 처리