xss-stage는 이미 다양한 xss공격을 필터링하는 라이브러리가 있지만, 라이브러리 마다 �?�용방식이 �?�각각이며, 여러 xss 라이브러리를 함께 사용해야 하는 상황(예 : json을 필터링 해주지 못하는 lucy-xss 와 json을 필터링해주는 다른 xss 라이브러리를 함께 사용해야�?때)에서 다양한 라이브러리를 함께 �?�용하기 어�?�운 문�?�를 해결하�? 일관된 방식으로 �?�용하는것을 돕기 위해 탄생했습니다.

Press Star

xss-stage를 사용하면 다음과 같은 장�?�이 있습니다.

1. 일관�?�이�? 쉬운 �?�용 방식 - 각 상황에 효율�?�인 다양한 라이브러리를 일관된 �?�용방식으로 �?�용�? 수 있습니다.
2. 쉬운 확장과 커스텀 - XssFiltering 인터페이스를 구현하�? 스프링 빈으로 등록하면, 이 구현체를 이용해 대상을 필터링 �? 수 있습니다.
3. �?택�?�인 Xss filtering - 꼭 필요한 파라미터와 url만 Xss filtering 대상으로 지�?��? 수 있습니다.
4. 낮은 라이브러리 의존성 - Xss core에서 �?�공하는 인터페이스를 통해 의존성을 줄여, 언�?��?지 구체�?�인 필터링 라이브러리를 교체�? 수 있습니다.
5. 검증된 filtering 구현체들 - Xss stage 확장인 xss-extension-string, xss-extension-json는 각각 navercorp-lucy, jackson을 사용해 구현되어 있습니다.
6. 요청에서 진행되는 xss filtering - Xss stage는 요청시에 xss filtering이 진행되기 때문에 응답이 더 많은 상황에서 더 효율�?�일 수 있습니다.
7. 한곳에서 관리하는 xss filtering �?�책 - �?�책 관리 파트에서 구현한 XssFiltering구현체를 등록하�?, 다른 파트에서 @Xss 어노테이션을 통해 구현체를 �?택하는 방식으로 한 곳에서 �?플리케이션 �?�체�?�인 Xss filtering �?�책을 관리�? 수 있습니다.

core : xss-core
string-extension : xss-extension-string - naver의 lucy-xss 라이브러리를 사용해 구현되어 있습니다.
json-extension : xss-extension-json - jackson의 databind를 사용해 구현되어 있습니다.

xss-stage에서 사용�? 수 있는 인터페이스와 확장법은 모두 xss-core 라이브러리에 작성되어 있습니다.
Custom Xss Filter가 필요한 상황이 아니라면, 다음 인터페이스로 Xss-filtering을 진행�? 수 있습니다.
만약 Custom Xss Filter가 필요하다면, xss-core-extension를 참조하세요.

@XssFiltering : 메소드에 마킹가능하며, 마킹된 메소드는 XssFiltering의 대상이 됩니다.
@Xss : @XssFiltering이 마킹된 메소드의 파라미터에 마킹가능하며, 마킹된 파라미터를 대상으로 Xss filtering이 진행됩니다. @Xss는 String filterName() 메소드를 갖�?있으며, 이 메소드에 값을 설�?�하는것으로 파라미터를 필터링�?때 사용�? XssFilter를 결�?��? 수 있습니다. filterName()은 value()와 동일하며, 이 둘 모두 생략된다면, 파라미터의 클래스명을 모두 소문자로 변경한 값으로 XssFilter를 결�?�합니다.

다음은 실�?� 사용예시 입니다.

@RestController
public class Example{
  
    @XssFiltering // 이 어노테이션이 마킹된 메소드는 XssFiltering의 대상이 됩니다.
    @GetMapping("/example")
    public Object helloworld(@Xss String param1, @Xss("json") SomeObject param2, @Xss("string") String param3, String param4){
        // @XssFiltering 어노테이션이 마킹된 메소드의 파라미터에 @Xss 어노테이션을 마킹함으로써 Xss safe한 객체를 얻을 수 있습니다.
        // @Xss의 value()에 어�?한 값도 들어가지 않는다면, 마킹된 파라미터의 클래스 이름을 모두 소문자로 변경한 값이 됩니다.
        // @Xss의 value()에 값을 넣음으로써, 이 파라미터를 필터링 하는데 사용�? XssFilter 구현체를 �?택�? 수 있습니다.
        // @Xss에 들어갈 수 있는 값은 xss-extension �?�포지�?리를 참�?하세요.
        ...
    }
  
}

plugins {
    id 'org.springframework.boot' version '2.7.1'
    id 'io.spring.dependency-management' version '1.1.0'
    id 'java'
}

repositories {
    mavenCentral()
    maven {url 'https://jitpack.io'} // xss-stage는 jitpack을 이용해 배포되�? 있습니다. 따라서, 이 �?�장소를 등록해줘야 다운로드 가능합니다.
}

dependencies {
    implementation 'org.springframework.boot:spring-boot-starter' 
    implementation 'org.springframework.boot:spring-boot-starter-aop' // xss-core는 Spring-aop를 이용해 구현되어있습니다.
}

• xss-stage 라이브러리를 사용하기 위해 xss-core 라이브러리를 다운로드 합니다. xss-core는 xss-extension들을 통합하�? XssFilter구현체들을 요청 파라미터에 �?�용하는 역�?을 합니다.

dependencies {
    implementation 'com.github.xss-stage:xss-core:1.2'
}

• String 형태의 파라미터를 필터링�? 필요가 있다면, xss-extension-string 라이브러리를 다운로드 합니다.

dependnecies {
    implementation 'com.github.xss-stage:xss-extension-string:1.2'
}

• Json 형태의 파라미터(Json -> 객체)를 필터링�? 필요가 있다면, xss-extension-json 라이브러리를 다운로드 합니다.

dependencies {
    implementation 'com.github.xss-stage:xss-extension-json:1.2.1'
}

• 모�? 의존성을 다운로드 받는다면 gradle파일은 다음과 같이 됩니다.

plugins {
    id 'org.springframework.boot' version '2.7.1'
    id 'io.spring.dependency-management' version '1.1.0'
    id 'java'
}

repositories {
    mavenCentral()
    maven {url 'https://jitpack.io'}
}

dependencies {
   implementation 'com.github.xss-stage:xss-core:1.2'
   implementation 'com.github.xss-stage:xss-extension-string:1.2'
   implementation 'com.github.xss-stage:xss-extension-json:1.2.1'
   
   implementation 'org.springframework.boot:spring-boot-starter'
   implementation 'org.springframework.boot:spring-boot-starter-aop'
}