API 보안 테스트 job 문제 해결

API 보안 테스트 job에서 발생하는 타임아웃, 연결 오류, 인증 실패 등 다양한 문제와 해결 방법을 설명합니다.

API 보안 테스트 job 이 N시간 후 타임아웃됨 # 리포지터리 규모가 큰 경우 기본값으로 지정된 Linux 용 small 호스티드 러너 에서 API 보안 테스트 job 이 타임아웃될 수 있습니다. job에서 이런 현상이 발생하면 더 큰 러너 로 확장합니다. 다음 문서 절을 참고합니다. 성능 튜닝 및 테스트 속도 더 큰 러너 사용 경로별 operation 제외 느린 operation 제외 API 보안 테스트 job 완료에 너무 오랜 시간이 걸림 # 성능 튜닝 및 테스트 속도 를 참고합니다. 오류: Error waiting for DAST API 'http://127.0.0.1:5000' to become available # v1.6.196 이전 버전의 API 보안 테스트 분석기에는 특정 조건에서 백그라운드 프로세스가 실패할 수 있는 버그가 있습니다. 해결 방법은 API 보안 테스트 분석기를 최신 버전으로 업데이트하는 것입니다. 버전 정보는 dast_api job의 job 세부 정보에서 확인할 수 있습니다. v1.6.196 이상에서 이 문제가 발생하면 Support에 문의해 다음 정보를 제공합니다. 이 문제 해결 절을 언급하고 Dynamic Analysis 팀으로 이슈를 에스컬레이션해 달라고 요청합니다. job의 전체 콘솔 출력입니다. job 아티팩트로 제공되는 gl-api-security-scanner.log 파일입니다. job 세부 정보 페이지의 오른쪽 패널에서 Browse 를 선택합니다. .gitlab-ci.yml 파일의 dast_api job 정의입니다. Failed to start scanner session (version header not found) # API 보안 테스트 엔진은 스캐너 애플리케이션 컴포넌트와 연결을 맺지 못하면 오류 메시지를 출력합니다. 이 오류 메시지는 dast_api job의 job 출력 창에 표시됩니다. 이 문제의 흔한 원인은 APISEC_API 변수를 기본값에서 변경한 것입니다. 오류 메시지 Failed to start scanner session (version header not found). 해결 방법 .gitlab-ci.yml 파일에서 APISEC_API 변수를 제거합니다. 값은 API 보안 테스트 CI/CD 템플릿에서 상속됩니다. 값을 직접 지정하는 대신 이 방법을 사용합니다. 변수를 제거할 수 없다면 API 보안 테스트 CI/CD 템플릿 의 최신 버전에서 이 값이 변경되었는지 확인합니다. 변경되었다면 .gitlab-ci.yml 파일의 값을 업데이트합니다. Failed to start session with scanner. Please retry, and if the problem persists reach out to support. # API 보안 테스트 엔진은 스캐너 애플리케이션 컴포넌트와 연결을 맺지 못하면 오류 메시지를 출력합니다. 이 오류 메시지는 dast_api job의 job 출력 창에 표시됩니다. 이 문제의 흔한 원인은 백그라운드 컴포넌트가 선택한 포트를 이미 다른 프로