기본 콘텐츠로 건너뛰기

냉장고 가계부 프로젝트 35

Spring security 프레임워크에서 form login 방식으로 인증할 경우 Remember-Me 서비스를 제공할 수 있다. Remember-Me 서비스를 이용하면 쿠키에 인증토큰을 저장해두고 일정기간동안(default: 2주) 쿠키에 토큰이 있다면 인증처리를 해준다.
기본적으로 별도의 설정이 없다면 세션은 30분 만료시간으로 정해져있다.(WAS 마다 틀리다.)
세션 시간이 만료되면 세션에 저장된 정보가 날라가므로 다시 로그인을 해야한다.
Remeber-Me 기능을 이용하면, form login에서 인증을 성공적으로 진행하는 경우 임의의 인증토큰을 생성해서 쿠키에 저장해두고 쿠키가 만료되기 전까지 쿠키값을 확인해서 인증을 진행한다.
별도의 설정을 하지 않으면 in-memory 기반의 쿠키저장소를 이용해서 쿠키 토큰인증을 하며, JDBC같은 저장소를 별도로 사용할 수도 있다.
WebSecurityConfig 클래스에 다음과 같이 간단한 설정만으로 remember-me 기능을 추가할 수 있다.
@Configuration
@EnableWebSecurity
@RequiredArgsConstructor
public class WebSecurityConfig extends WebSecurityConfigurerAdapter {
    private final MemberUserDetailsService userDetailsService;
    
    @Override
    protected void configure(HttpSecurity http) throws Exception {
        http
            .authorizeRequests()
                .antMatchers("/", "/signup").permitAll()
                .requestMatchers(PathRequest.toStaticResources().atCommonLocations()).permitAll()
                .anyRequest().authenticated()
                .and()
            .formLogin()
                .loginPage("/signin")
                .permitAll()
                .and()
            .logout()
                .logoutUrl("/signout")
                .permitAll()
                .and()
            .rememberMe()
                .and()
            .httpBasic();
    }
    
    ...
    
}

변경된 부분은 logout() 다음의 rememberMe() 메서드가 추가되었다는 점이다.
좀 더 디테일한 설정을 추가할 수 있지만, 일단 디폴트 설정으로 진행한다.
login Form 뷰에서 checkbox 태그를 작성하고 tag name값에 remember-me 를 입력한다.
<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml" 
    xmlns:th="http://www.thymeleaf.org">
<head>
    <!-- Required meta tags -->
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no" />

    <!-- Bootstrap CSS -->
    <link rel="stylesheet" href="https://stackpath.bootstrapcdn.com/bootstrap/4.1.3/css/bootstrap.min.css" integrity="sha384-MCw98/SFnGE8fJT3GXwEOngsV7Zt27NXFoaoApmYm81iuXoPkFOJwJ8ERdknLPMO" crossorigin="anonymous" />
    <!-- Font Awesome -->
    <link rel="stylesheet" href="https://use.fontawesome.com/releases/v5.3.1/css/all.css" integrity="sha384-mzrmE5qonljUremFsqc01SB46JvROS7bZs3IO2EmfFsd15uHvIt+Y8vEf7N7fWAU" crossorigin="anonymous" />
    <!-- Custom styles for this template -->
    <link th:href="@{/css/signin.css}" rel="stylesheet" />
    <title>Login</title>
</head>
<body class="text-center">
    <form class="form-signin" th:action="@{/signin}" th:method="POST">
      <h1 class="h3 mb-3 font-weight-normal">로그인</h1>
      <div class="alert alert-danger" role="alert" th:if="${param.error}">아이디 또는 비밀번호가 잘못되었습니다.</div>
      <div class="alert alert-danger" role="alert" th:if="${param.logout}">로그아웃되었습니다.</div>
      <label for="username" class="sr-only">이메일</label>
      <input type="email" id="username" name="username" class="form-control" placeholder="이메일를 입력하세요." required autofocus />
      <label for="password" class="sr-only">비밀번호</label>
      <input type="password" id="password" name="password" class="form-control" placeholder="비밀번호를 입력하세요." required />
      <div class="checkbox mb-3">
        <label>
          <input type="checkbox" name="remember-me" /> Remember me
        </label>
      </div>
      <button class="btn btn-lg btn-primary btn-block" type="submit">로그인</button>
      <p class="mt-5 mb-3 text-muted">&copy; 2018</p>
    </form>
</body>
</html>

checkbox 태그만 추가해주면 remember-me 폼파라미터 값으로 true가 전달될 경우 remember-me 서비스를 제공한다.

Remember me 체크박스를 체크한 후에 쿠키값을 확인하면 다음과 같이 remember-me 쿠키가 생성된것을 확인할 수 있다.

쿠키이름은 remember-me, value는 임의의 문자열해시값이다. 이 해쉬값은 아이디, 쿠키 만료시간을 문자열로 합쳐서 Base64로 인코딩한 문자열이다. 별도의 토큰 Key값을 주면 md5 해쉬로 아이디, 쿠키만료시간, 비밀번호, 키값으로 생성한다.
디폴트 설정이므로 쿠키 만료시간은 14Days(2주) 이다. 만료시간은 별도로 설정가능하다.

지금까지 fridge-web 프로젝트는 UI서버의 역할을 하며 fridge-service, fridge-member 서버와 Eureka 서비스를 이용해서 RestTemplate으로 통신했다.
RestTemplate 통신을 위해서는 RestTemplate 객체를 Application.class 파일에서 빌드해주고, restTemplate API를 이용해서 통신함으로 단순하지가 않다.

그렇다고 API클라이언트를 위한 RPC 모듈을 만드는것은 간단한 API통신을 위한 복잡성이 커지게 되기에 적합하지 않다.

Netflix Feign은 인터페이스와 간단한 설정만으로 다운스트림 서비스 클라이언트를 쉽게 생성할 수 있다.
(출처: O'REILLY - 클라우드 네이티브 자바[책만])

spring cloud 의 feign 의존성을 추가하기 위해 pom.xml 파일을 수정한다.
<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-openfeign</artifactId>
</dependency>

Application.class 파일에서 FeignClient를 사용하기 위한 @EnableFeignClients 애너테이션을 추가한다.
@SpringBootApplication
@EnableDiscoveryClient
@EnableFeignClients
public class Application {
    
   ...

}

FeignClient는 Eureka를 통한 서비스 ID를 사용할 수 있고, 내부적으로 Netflix Ribbon 라이브러리로 로드밸런싱을 한다.
FeignClient를 작성하기위해서 다운스트림 서비스의 API 인터페이스를 작성한다. 먼저, fridge-member API부터 FeignClient로 작성한다.
@FeignClient(name="fridge-member")
@RequestMapping("/members")
public interface MemberClient {
    
    @GetMapping("/{username}")
    MemberRequest loadByUsername(@PathVariable("username") String username) throws MemberNotFoundException;
    
    @PostMapping
    MemberRequest register(MemberRequest memberRequest);
    
    @PutMapping("/{id}")
    MemberRequest changePassword(@PathVariable("id") long id, MemberRequest memberRequest);
    
    @DeleteMapping("/{id}")
    void withdraw(@PathVariable("id") long id);
    
}

MemberClient 이름의 자바 인터페이스를 생성하고, 클래스 선언부에 @FeignClient 애너테이션을 선언한다. name 값으로 fridge-member 서비스 ID를 대입한다.
나머지는 마치 fridge-member 프로젝트의 MemberController 클래스와 같이 컨트롤러 메서드의 시그니쳐들만 작성한다. 클래스 선언부에 @RequestMapping("/members") 애너테이션은 MemberClient 인터페이스 내부의 메서드들의 매핑 URL이 /members 로 동작함을 나타낸다.

loadByUsername 메서드는 MemberRequest 객체를 리턴타입으로 가지며, Get방식으로 통신하며 /members/{username} URL에 매핑되는 메서드이다. 메서드 파라미터로 PathVariable 문자열 username이 있다. 예외 MemberNotFoundException 을 던지는데, Member API 서비스에서 404 NotFound Exception 이 발생할 경우 MemberNotFoundException 이 발생하도록 설정한다.

나머지 메서드들도 MemberRestService 에서 RestTemplate으로 통신하던 것과 비교하면 매우 간단함을 알 수 있다.

FeignClient를 통해서 통신할 경우 에러 핸들링을 위해서 별도의 설정이 조금 필요하다.
우선 MemberNotFoundException 클래스는 다음과 같이 간단하게 구현한다.
public class MemberNotFoundException extends RuntimeException {
    private static final long serialVersionUID = 1L;

    public MemberNotFoundException(int status, String reason) {
        super(String.format("status %s reason %s", status, reason));
    }
    
}

RuntimeException 을 상속받고, 생성자로 int status, String reason 파라미터를 전달받는다.
status 변수는 HttpStatus 정수값을 나타내며, reason 변수는 에러 reason이 있는 경우 문자열로 전달받는다. 두 변수를 사용해서 간단한 에러 메시지를 부모 생성자에 전달한다.

Feign Client의 에러 핸들링을 위해서 feign.codec.ErrorDecoder 인터페이스를 구현한 구현클래스를 작성한다.
public class MemberFeignErrorDecoder implements ErrorDecoder {

    @Override
    public Exception decode(String methodKey, Response response) {
        if(response.status() == 404) {
            return new MemberNotFoundException(response.status(), response.reason());
        }
        return errorStatus(methodKey, response);
    }

}

MemberFeignErrorDecoder 클래스는 ErrorDecoder 인터페이스를 구현한다. 추상메서드 decode 메서드는 response.status 메서드를 이용해서 ResponseStatus HttpStatus 정수값을 바탕으로 error를 핸들링한다.
디폴트 설정으로 FeignException이 던져지는데, 여기서는 404에러일 경우에만 MemberNotFoundException 예외를 리턴하도록 한다.

Feign 에러 핸들링 클래스를 작성한 후 해당 설정을 위해서 application.yml 파일에 설정을 추가한다.
feign:
  client:
    config:
      fridge-member:
        errorDecoder: com.poseidon.config.MemberFeignErrorDecoder

fridge-member 부분은 각각의 FeignClient의 서비스 ID를 대입한다. ErrorDecoder 인터페이스를 구현한 구현클래스의 패키지 전체와 클래스명을 입력하면 된다.

이제 MemberRestService 를 사용하던 클래스들을 MemberClient를 이용하도록 모든 클래스에서 수정한다. MemberUserDetailsService 클래스는 다음과 같이 수정한다.
@Component
@RequiredArgsConstructor
public class MemberUserDetailsService implements UserDetailsService {
    private final MemberClient client;

    @Override
    public UserDetails loadUserByUsername(String username) throws UsernameNotFoundException {
        try {
            return client.loadByUsername(username).toMember();
        } catch(MemberNotFoundException ex) {
            throw new UsernameNotFoundException("could not found user by username: " + username);
        }
    }

}

기존의 MemberRestService 의존성은 MemberClient로 대체되고, client.loadByUsername 메서드가 호출되고 toMember메서드로 Member 객체로 반환한다.
client.loadByUsername 메서드는 MemberNotFoundException 예외가 발생할 수 있으므로, try-catch구문으로 감싸서 익셉션 발생시 UsernameNotFoundException 예외를 던지도록 처리한다.

MemberController 도 마찬가지로 MemberRestService 를 사용해서 통신하던것을 MemberClient로 대체한다.
@Controller
@RequiredArgsConstructor
@Slf4j
public class MemberController {
    private final PasswordEncoder passwordEncoder;
    private final MemberClient client;
    
    @GetMapping("/signup")
    public String signupForm(MemberRequest memberRequest, Model model) {
        model.addAttribute("memberRequest", memberRequest);
        return "members/signup";
    }
    
    ...
    
}

MemberClient를 의존성을 추가한뒤에 모든 MemberRestService 메서드 호출 부분을 FeignClient 인터페이스 메서드를 호출하도록 수정한다. 나머지 컨트롤러 메서드들도 전부 수정한다.

이런 방식으로 FridgeRestService, FoodRestService 클래스도 FeignClient를 이용하도록 인터페이스를 작성하고 수정한다.
전부 수정하고 나면 Application.class 파일에 RestTemplate Bean 설정부분은 사라진다.
@SpringBootApplication
@EnableDiscoveryClient
@EnableFeignClients
public class Application {
    
    @Bean
    public LayoutDialect layoutDialect() {
        return new LayoutDialect();
    }
    
    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }

}

기존의 RestTemplate 을 사용하던것보다 코드의 양도 줄고 직관적으로 다운스트림 서비스를 호출할 수 있도록 변경되었다.

이전글: 냉장고 가계부 프로젝트 34
다음글: 냉장고 가계부 프로젝트 36
라벨:

이 블로그의 인기 게시물

냉장고 가계부 프로젝트 14

fridge-web 프로젝트에서 api 서버와 통신할때 URL을 매번 중복해서 입력하는 부분을 제거하기 위해 RestTemplate 빈 등록메서드를 수정한다. @Bean public RestTemplate restTemplate(RestTemplateBuilder builder) { return builder.rootUri("http://localhost:8081").build(); } builder에 rootUri 메서드를 호출해서 api 서버 url을 미리 설정하고 build해서 RestTemplate 객체를 반환하면 RestTemplate을 사용하는 부분에서는 root 다음 경로만 넘겨주면 된다. WebFoodController 클래스의 restTemplate 사용부분을 전부 수정한다. @GetMapping public String foods(Model model) { ResponseEntity<Resources<FoodCommand>> response = restTemplate.exchange("/foods", HttpMethod.GET, null, new ParameterizedTypeReference<Resources<FoodCommand>>() {}, Collections.emptyMap()); .... 다른 메서드들도 동일하게 수정한다. Food 클래스에서도 이제 더이상 사용하지 않는 Cloneable과 hashCode, equals 메서드를 정리한다. Guava 의존라이브러리도 다른곳에서는 사용하지 않으므로 정리한다. 식품에 대한 최소한의 기능은 구현하였다. 이번에는 냉장고 라는 개념을 모델링한다. 식품들이 들어가고 나가는 곳은 냉장고이기 때문에 냉장고라는...
자세한 내용 보기

냉장고 가계부 프로젝트 10

API 가 어느정도 준비되었으므로, UI를 만든다. 별도의 프로젝트로 구성해서 API를 호출하는 방식으로 구성한다. 프로젝트명은 fridge-web이라고 정한다. 냉장고 가계부 프로젝트 1 을 참고한다. 새 프로젝트에서는 Dependencies를 Web, Thymeleaf, DevTools 세개를 체크한다. 프로젝트가 준비되면, pom.xml 파일을 연다. <dependencies> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-thymeleaf</artifactId> </dependency> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-devtools</artifactId> <scope>runtime</scope> </dependency> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-test</artifactId> <scope>test</scope> </dependency> <dependency> <gro...
자세한 내용 보기

냉장고 가계부 프로젝트 27

스프링 Data 에서 제공하는 @CreatedDate, @LastModifedDate 애너테이션을 이용해서 작성일자, 수정일자를 도메인객체가 생성되고, 수정될 때 관리될 수 있도록 한다. Spring Data를 쓰기 전에는 DB컬럼에 Date 타입의 등록일 컬럼을 추가하고 DEFAULT 값으로 SYSDATE 를 줘서 DB에 Insert 되는 시간에 등록일자 컬럼이 채워지는 방식을 사용했었고, Update 쿼리가 실행될때 수정일자 컬럼에 SYSDATE를 직접 Update 해주는 방식을 자주 썼다. 그 뿐만아니라, 등록일자와 더불어 등록한 사용자(ex: registerUser)를 식별하는 식별키(ex: userId, username ...) 를 Insert 쿼리가 실행될때 등록해주고, 수정한 사용자(ex: modifedUser)를 Update 쿼리에 설정하는 방식은 차후에 있을지도 모를 일에 대비해서 늘 반복해서 작업했다. 스프링 Data 에서 제공하는 JPA Audit 기능은 이런 코드의 반복을 줄여준다. 사용자 같은 경우 객체로 넘기면 객체의 식별자가 담긴다. 등록시간은 날짜형 타입이다. public class Blog { @CreatedBy private User user; @CreatedDate private LocalDateTime creadtedDate; } Blog 클래스의 User 객체는 @CreatedBy 애너테이션으로 선언되서 등록한 사용자를 나타내는 컬럼에 값을 입력할것이다. createdDate 필드는 도메인객체가 영속성 저장소에 반영되는 시간을 나타낸다. Fridge, Food 클래스에 등록일, 수정일만 먼저 적용한다. 두 클래스에 createdDate, lastModifedDate 멤버변수를 선언한다. @Data @NoArgsConstructor @Entity @EntityListeners(AuditingEntityListener.class) public class Fridge { ...
자세한 내용 보기