Documentation
¶
Overview ¶
Package validation 애플리케이션 전반에서 사용되는 입력 데이터의 유효성을 검사하는 기능을 제공합니다.
이 패키지는 외부 입력값(설정 파일, API 요청 등)에 대한 신뢰성을 보장하기 위해 설계되었으며, 가능한 한 표준(Standard)과 보안 권장 사항을 엄격하게 준수하는 것을 목표로 합니다.
주요 기능:
- CORS (Cross-Origin Resource Sharing) Origin 검증
- 파일 및 디렉터리 경로 유효성 검증 (존재 여부, 타입, 권한)
사용 시 주의사항:
- 모든 검증 함수는 유효하지 않은 입력에 대해 명확한 error를 반환합니다.
- 패키지 내 함수들은 스레드 안전(Thread-Safe)하도록 설계되었습니다.
Index ¶
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func ValidateCORSOrigin ¶
ValidateCORSOrigin 주어진 문자열이 유효한 CORS(Cross-Origin Resource Sharing) Origin 표준을 준수하는지 검증합니다.
이 함수는 'Scheme://Host[:Port]' 형식을 엄격하게 요구하며, 와일드카드('*')를 지원합니다.
검증 규칙:
- 특수 값: '*' (모든 출처 허용)는 유효합니다.
- 스키마: 'http' 또는 'https'만 허용됩니다.
- 호스트: 도메인명, 로컬호스트(localhost), IPv4 또는 IPv6 주소여야 합니다.
제약 사항 (다음 요소 포함 시 유효하지 않음):
- 경로 (Path) 및 후행 슬래시 ('/')
- 쿼리 스트링 (Query String)
- URL 프래그먼트/해시 (Fragment)
func ValidateDir ¶ added in v1.1.0
ValidateDir 지정된 경로가 유효한 디렉터리인지 검증합니다.
func ValidateFile ¶ added in v1.1.0
ValidateFile 지정된 경로가 유효한 파일인지 검증합니다.
func ValidateHostname ¶ added in v1.1.0
ValidateHostname 호스트명이 RFC 1123 표준을 준수하는지, 또는 IP 주소/로컬호스트인지 검증합니다.
규칙:
- localhost 허용
- 유효한 IPv4 및 IPv6 주소 허용
- 도메인명은 RFC 1123 규칙을 따름 (최대 253자, 레이블당 63자, 영문/숫자/하이픈)
func ValidatePort ¶
ValidatePort 포트 번호가 유효한 범위(1-65535) 내에 있는지 검증합니다.
Types ¶
This section is empty.
Source Files
Click to show internal directories.
Click to hide internal directories.