82번 라인의 configure(AuthenticationManagerBuilder auth) 메소드는 로그인 처리를 위한 구성을 수행한다. 자세한 내용은 아래서 설명할 것이다.

package com.example.demo.config; import java.util.ArrayList; import java.util.Collection; import java.util.Collections; import java.util.List; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.context.annotation.Bean; import org.springframework.security.config.annotation.authentication.builders.AuthenticationManagerBuilder; import org.springframework.security.config.annotation.web.builders.HttpSecurity; import org.springframework.security.config.annotation.web.builders.WebSecurity; import org.springframework.security.config.annotation.web.configuration.EnableWebSecurity; import org.springframework.security.config.annotation.web.configuration.WebSecurityConfigurerAdapter; import org.springframework.security.crypto.password.NoOpPasswordEncoder; import org.springframework.security.crypto.password.PasswordEncoder; import org.springframework.security.web.util.matcher.AntPathRequestMatcher; import com.example.demo.entity.com.ComAuthGrpMenuMap; import com.example.demo.entity.com.ComMenuMngt; import com.example.demo.security.SecurityAccessDeniedHandler; import com.example.demo.security.SecurityAuthenticationFailureHandler; import com.example.demo.security.SecurityAuthenticationProvider; import com.example.demo.security.SecurityAuthenticationSuccessHandler; import com.example.demo.security.SecurityLogoutSuccessHandler; import com.example.demo.security.SecuritySessionExpiredStrategy; import com.example.demo.security.SecurityUserDetailsService; import com.example.demo.service.UserService; @EnableWebSecurity public class SpringSecurityConfig extends WebSecurityConfigurerAdapter { @Autowired private SecurityAuthenticationSuccessHandler securityAuthenticationSuccessHandler; @Autowired private SecurityAuthenticationFailureHandler securityAuthenticationFailureHandler; @Autowired private SecurityLogoutSuccessHandler securityLogoutSuccessHandler; @Autowired private SecurityAccessDeniedHandler securityAccessDeniedHandler; @Autowired private SecuritySessionExpiredStrategy securitySessionExpiredStrategy; @Autowired private SecurityUserDetailsService securityUserDetailsService; @Autowired private SecurityAuthenticationProvider securityAuthenticationProvider; @Autowired private UserService userService; @Override public void configure(WebSecurity web) throws Exception { web.ignoring().antMatchers("/", "/index.html", "/resources/**", "/caution/**"); } @Override protected void configure(HttpSecurity http) throws Exception { http.formLogin() .loginPage("/login_form.html").permitAll() // 로그인 페이지 .loginProcessingUrl("/auth") // 로그인 처리 URL .usernameParameter("loginid").passwordParameter("passwd") .successHandler(securityAuthenticationSuccessHandler.setDefaultUrl("/dashboard/main.html")) .failureHandler(securityAuthenticationFailureHandler) .and(); http.logout() .logoutRequestMatcher(new AntPathRequestMatcher("/common/logout.html"))// 로그아웃 URL .logoutSuccessHandler(securityLogoutSuccessHandler.setDefTargetUrl(("/login_form.html"))) .clearAuthentication(true) .invalidateHttpSession(true).and(); http.exceptionHandling() .accessDeniedHandler(securityAccessDeniedHandler.setDefaultTargetUrl("/caution/access_denied.html")).and(); // 불량 접근 처리 Collection<Matcher> matchers = getAuthUrlAndRols(); for(Matcher matcher : matchers){ http.authorizeRequests().antMatchers(matcher.url).access(matcher.roles); } http.authorizeRequests().anyRequest().authenticated().and(); http.sessionManagement() .maximumSessions(1) // 같은 아이디로 1명만 로그인 할 수 있음 .maxSessionsPreventsLogin(false) // 신규 로그인 사용자의 로그인이 허용되고, 기존 사용자는 세션아웃 됨 .expiredSessionStrategy(securitySessionExpiredStrategy.setDefaultUrl("/caution/session_out.html")) .and(); } @Override protected void configure(AuthenticationManagerBuilder auth) throws Exception { securityAuthenticationProvider.setSecurityUserDetailsService(securityUserDetailsService); securityAuthenticationProvider.setPasswordEncoder(passwordEncoder()); auth.authenticationProvider(securityAuthenticationProvider); } @Bean public PasswordEncoder passwordEncoder() { return NoOpPasswordEncoder.getInstance(); // 개발용 패스워드 암호화 모듈(비 암호화)로써 실제 사용시 변경해 주어야 한다... } /** * 권한 URL와 그룹 맵핑 * * @return * @author "fishingday" * @see */ private Collection<Matcher> getAuthUrlAndRols(){ Collection <Matcher> matchers = new ArrayList<>(); List<ComMenuMngt> comMenuMngtList = userService.findAllComMenuMngtAndAuthGrpMngt(); for(ComMenuMngt comMenuMgt : comMenuMngtList){ Matcher matcher = new Matcher(); String menuUrl = comMenuMgt.getMenuUrl(); matcher.url = menuUrl.substring(0, menuUrl.lastIndexOf("/")) + "/**"; StringBuilder sb = null; if(comMenuMgt.getComAuthGrpMenuMaps() == null) continue; if(comMenuMgt.getComAuthGrpMenuMaps().size() > 1){ for(ComAuthGrpMenuMap comAuthGrpMenuMap : comMenuMgt.getComAuthGrpMenuMaps()){ if(sb == null){ sb = new StringBuilder("hasAnyRole('ROLE_G").append(comAuthGrpMenuMap.getComAuthGrpMngt().getAuthGrpMngtSeq()).append("'"); }else{ sb.append(" ,'ROLE_G").append(comAuthGrpMenuMap.getComAuthGrpMngt().getAuthGrpMngtSeq()).append("'"); } } sb.append(")"); }else{ sb = new StringBuilder("hasRole('ROLE_G").append(comMenuMgt.getComAuthGrpMenuMaps().get(0).getComAuthGrpMngt().getAuthGrpMngtSeq()).append("')"); } matcher.roles = sb.toString(); matchers.add(matcher); } return Collections.unmodifiableCollection(matchers); } class Matcher { String url; String roles; } }

2. configure(AuthenticationManagerBuilder auth)

configure(AuthenticationManagerBuilder auth)에서는 인증 처리를 위한 AuthenticationProvider를 구현한 구현체와 UserDetailsService를 구현한 구현체를 조합한다. AuthenticationProvider의 구현체의 주요 역할은 사용자 정보를 조회하고, 로그인시 입력 받은 패스워드를 확인하고, 사용자의 권한을 확인하여 인증토큰을 발행하는 역할을 한다. UserDetailsService의 구현체는 사용자 정보를 조회하는 역할을 하며, UserDetails 구현체를 반환 한다.

여기서는 AuthenticationProvider의 구현체로 SecurityAuthenticationProvider를 만들어 사용한다. 아래는 SecurityAuthenticationProvider의 소스이다. 25번 라인과 같이 AuthenticationProvider를 implements 하면서 시작한다. 44번 라인에서는 사용자 정보를 조회한다. 여기서는 UserDetails 구현체를 받는데 본인 나름대로 편리하다고 생각되는 방향으로 수정해서 사용했다. 46번 라인은 패스워드를 비교하는 부분으로 현재의 passwordEncoder는 사실상 패스워드를 암호화 하거나 하지는 않는다. 이것을 암호화 모듈로 바꿔주려면 SpringSecurityConfig.java의 90번 라인의 NoOpPasswordEncoder.getInstance() 수정하면 된다. 51번 라인은 본인이 추가한 부분으로 사용자에게 지정된 IP에서 접속했는가를 확인하는 부분이다. 사용가능 IP 목록이 없으면 이 부분은 그냥 넘어가도록 했다. 사용가능 IP 목록은 관리자와 같은 특수한 사용자 위한 것으로 특정한 PC에서만 접속할 권한을 부여할 경우 사용한다. 68번 라인은 사용자가 사용할 수 있는 권한(ROLE)을 부여하는 부분으로 사용자 정보에서 가져왔다. 마지막으로 80번 라인에서는 스프링에서 사용할 수 있도록 사용자 정보와 권한 정보 등으로 Authentication 구현체를 반한다.

package com.example.demo.security; import java.util.Collection; import java.util.List; import org.springframework.security.authentication.AuthenticationProvider; import org.springframework.security.authentication.BadCredentialsException; import org.springframework.security.authentication.UsernamePasswordAuthenticationToken; import org.springframework.security.core.Authentication; import org.springframework.security.core.AuthenticationException; import org.springframework.security.core.GrantedAuthority; import org.springframework.security.core.userdetails.UserDetails; import org.springframework.security.core.userdetails.UsernameNotFoundException; import org.springframework.security.crypto.password.PasswordEncoder; import org.springframework.security.web.authentication.WebAuthenticationDetails; import org.springframework.stereotype.Component; import org.springframework.util.AntPathMatcher; import com.example.demo.entity.com.ComUserAlowIp; import lombok.extern.java.Log; @Component @Log public class SecurityAuthenticationProvider implements AuthenticationProvider { private SecurityUserDetailsService securityUserDetailsService; private PasswordEncoder passwordEncoder; AntPathMatcher pathMatcher = new AntPathMatcher(); @Override public Authentication authenticate(Authentication authentication) throws AuthenticationException { String loginId = authentication.getName(); String passwd = (String) authentication.getCredentials(); UserDetails user = null; Collection<? extends GrantedAuthority> authorities = null; try { // 사용자를 조회한다. user = securityUserDetailsService.loadUserByUsername(loginId); if (user == null || !passwordEncoder.matches(passwd, user.getPassword())){ throw new BadCredentialsException("Bad credentials"); } // IP 접속이 제한 되어 있다면....? List<ComUserAlowIp> comUserAlowIpList = securityUserDetailsService.findComUserAlowIpByUserMngtSeq(((SecurityUser)user).getComUserMngt()); if(comUserAlowIpList != null && !comUserAlowIpList.isEmpty()){ // 없으면 통과 pathMatcher.setPathSeparator("."); boolean isAlowIp = false; String remoteAddress = ((WebAuthenticationDetails) authentication.getDetails()).getRemoteAddress(); for(ComUserAlowIp comUserAlowIp: comUserAlowIpList){ if(pathMatcher.match(comUserAlowIp.getAlowIp(), remoteAddress)){ isAlowIp = true; break; } } if(!isAlowIp){ throw new BadCredentialsException("is Not Allow IP Address : " + remoteAddress); } } // 권한 목록 반환 authorities = user.getAuthorities(); } catch(UsernameNotFoundException e) { log.info(e.toString()); throw new UsernameNotFoundException(e.getMessage()); } catch(BadCredentialsException e) { log.info(e.toString()); throw new BadCredentialsException(e.getMessage()); } catch(Exception e) { log.info(e.toString()); throw new RuntimeException(e.getMessage()); } return new UsernamePasswordAuthenticationToken(user, passwd, authorities); } public SecurityUserDetailsService getSecurityUserDetailsService() { return securityUserDetailsService; } public void setSecurityUserDetailsService(SecurityUserDetailsService securityUserDetailsService) { this.securityUserDetailsService = securityUserDetailsService; } public PasswordEncoder getPasswordEncoder() { return passwordEncoder; } public void setPasswordEncoder(PasswordEncoder passwordEncoder) { this.passwordEncoder = passwordEncoder; } @Override public boolean supports(Class<?> auth) { return auth.equals(UsernamePasswordAuthenticationToken.class); } }

사용자 정보는 UserDetailsService를 구현한 SecurityUserDetailsService로 하였다. UserDetailsService의 필수 조건은 사용자의 권한 정보를 포함한 사용자 정보이다. 하지만 SecurityUserDetailsService는 메뉴 정보까지 포함하여 받을 수 있도록 수정했다.

20번 라인과 21번 라인은 UserDetailsService 기능을 수행할 수 있도록 @Service 추가와 UserDetailsService 인터페이스를 추가하였다. 26번 라인의 loadUserByUserName() 메소드는 AuthenticationProvider 구현체에서 호출하는 부분으로 반드시 구현되어야 하는 부분이다. 이곳에서 사용자 정보 조회와, 사용자의 권한 그룹 조회, 사용자에게 할당된 메뉴 정보를 조회한다. 이 부분은 28번 라인, 35번 라인, 38번 라인에서 구현되어 있으며, 특히 38번 라인의 사용자 메뉴 목록 조회 부분에서는 내부에서 메소드(56번 라인)를 구현하여 각 메뉴의 부모와 자식 관계를 연결하였다. 

이렇게 한 이유는 나중에 화면을 구현할 때 각 화면별 화면 정보 조회와 화면 경로 표현을 위해 미리 만들어 둔 것이다.

40번 라인은 SecurityUser Object를 생성하는 부분으로 우리의 필요 용도에 맞게 UserDetails를 수정하여 구현 하였다.

package com.example.demo.security; import java.util.ArrayList; import java.util.HashMap; import java.util.List; import java.util.Map; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.security.core.userdetails.UserDetails; import org.springframework.security.core.userdetails.UserDetailsService; import org.springframework.security.core.userdetails.UsernameNotFoundException; import org.springframework.stereotype.Service; import com.example.demo.entity.com.ComAuthGrpMngt; import com.example.demo.entity.com.ComMenuMngt; import com.example.demo.entity.com.ComUserAlowIp; import com.example.demo.entity.com.ComUserMngt; import com.example.demo.service.UserService; @Service public class SecurityUserDetailsService implements UserDetailsService{ @Autowired private UserService userService; @Override public UserDetails loadUserByUsername(String loginId) throws UsernameNotFoundException { ComUserMngt comUserMngt = userService.findComUserMngtByLoginId(loginId); if(comUserMngt == null){ throw new UsernameNotFoundException("LoginId '" + loginId + "' has not found"); } // 사용자에게 할당된 권한 그룹 목록 List <ComAuthGrpMngt> comAuthGrpMngts = userService.findComAuthGrpMngtByComUserMngt(comUserMngt); // 사용자에게 할당된 권한별 메뉴 목록 List <ComMenuMngt> comMenuMngtList = findComMenuMngtByComUserMngtAndComAuthGrpMngt(comUserMngt); UserDetails userDetails = new SecurityUser(comUserMngt, comAuthGrpMngts, comMenuMngtList); return userDetails; } /** * 접근이 허용된 메뉴 목록 조회 * - 부모 메뉴와 자식메뉴에 대한 구성을 완성한 뒤 반환 * * @param comUserMngt * @param comAuthGrpMngt * @return * @author "fishingday" * @see */ private List<ComMenuMngt> findComMenuMngtByComUserMngtAndComAuthGrpMngt(ComUserMngt comUserMngt) { List <ComMenuMngt> comMenuMngtList = userService.findComMenuMngtByComUserMngtAndComAuthGrpMngt(comUserMngt); // 사명이 하나 있다. 부모를 찾아 줘야 한다. ㅜㅜ;; // 이 자식들이 고아가 되지 않도록 하여 주시옵소서~ Map <Long, ComMenuMngt> comMenuMngtMap = new HashMap<Long, ComMenuMngt>(); for(ComMenuMngt comMenuMngt: comMenuMngtList){ // 이산 가족을 등록한다. comMenuMngtMap.put(comMenuMngt.getMenuMngtSeq(), comMenuMngt); } // 살아있지 않은 부모가 있다면... for(ComMenuMngt comMenuMngt: comMenuMngtList){ if(comMenuMngt.getUpMenuMngtSeq() != null){ ComMenuMngt upMenuMngt = comMenuMngtMap.get(comMenuMngt.getUpMenuMngtSeq()); if(upMenuMngt == null){ upMenuMngt = userService.findComMenuMngtOne(comMenuMngt.getUpMenuMngtSeq()); comMenuMngtMap.put(upMenuMngt.getMenuMngtSeq(), upMenuMngt); } comMenuMngt.setUpMenuMngt(upMenuMngt); // 일단 족보는 정리 된 것으로 본다. } } // 이제 자식을 찾아 보자... List <ComMenuMngt> userMenuMngtList = new ArrayList<ComMenuMngt>(comMenuMngtMap.values()); for(ComMenuMngt comMenuMngt: userMenuMngtList){ // 중분류에서는 부모를 찾지 못한 녀석들이 있다. 여기서 마지막으로 찾아준다. if(comMenuMngt.getUpMenuMngtSeq() != null && comMenuMngt.getUpMenuMngtSeq() > 0L && comMenuMngt.getUpMenuMngt() == null){ ComMenuMngt upMenuMngt = comMenuMngtMap.get(comMenuMngt.getUpMenuMngtSeq()); if(upMenuMngt == null){ upMenuMngt = userService.findComMenuMngtOne(comMenuMngt.getUpMenuMngtSeq()); comMenuMngtMap.put(upMenuMngt.getMenuMngtSeq(), upMenuMngt); } comMenuMngt.setUpMenuMngt(upMenuMngt); // 더이상의 이산가족이 있으면 안된다...ㅜ.ㅜ } ComMenuMngt upMenuMngt = comMenuMngt.getUpMenuMngt(); if(upMenuMngt != null){ // 부모에게 자식을 찾아 주어야 한다. 자식은 부모를 아니까... upMenuMngt.addChildMenuMngt(comMenuMngt); // 족보 정리 끝 } } return new ArrayList<ComMenuMngt>(comMenuMngtMap.values()); } /** * 사용자에게 접근이 허용된 IP 목록 * * @param comUserMngt * @return * @author "fishingday" * @see */ public List<ComUserAlowIp> findComUserAlowIpByUserMngtSeq(ComUserMngt comUserMngt) { return userService.findComUserAlowIpByComUserMngt(comUserMngt); } }

마지막은 UserDetails를 구현한 SecurityUser다. SecurityUsers는 Spring Security에 사용자 정보를 제공하는 용도와 더불어 개인화된 화면을 제공하기 위한 부가 정보로 구성했다.

SecurityUser는 UserDetails의 구현체이므로 29라인 처럼 UserDetails을 추가해야 하며, Serializable도 추가해야 한다. 41번 라인은 생성자로써 사용자 정보과 권한 정보, 메뉴 목록 등을 받아 인스턴스 내에 저장하는 역할을 한다. 특히 50번 라인에서는 최상위 메뉴를 topMenuMaps에서 저장하며, 54번 라인에서는 사용자에게 할당된 메뉴를 authMenuUrlMap라는 인스턴스 변수에 url + menu 정보로 저장하여 둔다. 71번 라인과 84번 라인은 메뉴 목록을 출력하는 용도와 화면 정보를 표시하는 용도로 사용된다. 자세한 것은 interceptor(Logging 파트)를 다룰 때 설명할 것이다. 89번 라인과 103번 라인, 112번 라인은 UserDetails 인터페이스가 요구하는 항목으로 각각 사용자의 권한 정보와 패스워드, 로그인 아이디를 반환한다.

117번 라인, 126번 라인, 131번 라인, 149번 라인은 UserDetails 인터페이스가 요구하는 구현 항목으로 각각 계정의 만료 여부, (일정 수의 로그인 처리 오류의 경우 등으로)계정 잠김, 패스워드 만료, 유효 계정 여부 등을 묻는 기능으로 원칙적으로는 구현하는 것이 올바르지만, 이런 기능들을 사용하지 않을 true를 반환해도 된다. 

package com.example.demo.security; import java.io.Serializable; import java.util.ArrayList; import java.util.Collection; import java.util.Collections; import java.util.Comparator; import java.util.Date; import java.util.HashMap; import java.util.LinkedList; import java.util.List; import java.util.Map; import java.util.SortedSet; import java.util.TreeMap; import java.util.TreeSet; import org.springframework.security.authentication.BadCredentialsException; import org.springframework.security.core.GrantedAuthority; import org.springframework.security.core.SpringSecurityCoreVersion; import org.springframework.security.core.authority.SimpleGrantedAuthority; import org.springframework.security.core.userdetails.UserDetails; import org.springframework.util.Assert; import com.example.demo.entity.com.ComAuthGrpMngt; import com.example.demo.entity.com.ComMenuMngt; import com.example.demo.entity.com.ComUserMngt; import com.example.demo.entity.domain.UserStatCd; import lombok.Data; @Data public class SecurityUser implements UserDetails, Serializable{ private static final long serialVersionUID = -4170558396811564309L; private ComUserMngt comUserMngt; private List<ComAuthGrpMngt> comAuthGrpMngts; private Map <String, ComMenuMngt> topMenuMaps = new TreeMap<>(); private Map <String, ComMenuMngt> authMenuUrlMap = new HashMap<>(); public SecurityUser(ComUserMngt comUserMngt, List<ComAuthGrpMngt> comAuthGrpMngts, List<ComMenuMngt> comMenuMngts) { this.comUserMngt = comUserMngt; // 사용자 정보 this.comAuthGrpMngts = comAuthGrpMngts; // 권한 정보 if(comMenuMngts != null && !comMenuMngts.isEmpty()){ // 할당 메뉴 for(ComMenuMngt comMenuMngt:comMenuMngts){ if(comMenuMngt.getUpMenuMngt() == null){ topMenuMaps.put(comMenuMngt.getPrntOrd() + "-" + comMenuMngt.getMenuMngtSeq(), comMenuMngt); } if(comMenuMngt.getMenuUrl() != null && !"".equals(comMenuMngt.getMenuUrl())){ authMenuUrlMap.put(comMenuMngt.getMenuUrl(), comMenuMngt); } } }else{ throw new BadCredentialsException("There is no menu available."); } } /** * 권한이 있는 메뉴 URL을 식별하고 메뉴 객체를 반환 한다. * * @param menuUrl 접근 URL * @return 메뉴 정보 객체 * * @version 2016. 2. 3. * @see */ public ComMenuMngt getAuthMenuMngt(String menuUrl){ return authMenuUrlMap.get(menuUrl); } /** * 최상위 메뉴를 반환한다. * * @return 최상위 메뉴 목록 * * @author claude@lsware.co.kr * @version 2016. 1. 28. * @see */ public List<ComMenuMngt> getTopMenuList(){ return new ArrayList<>(topMenuMaps.values()); } @Override public Collection<? extends GrantedAuthority> getAuthorities() { Collection <GrantedAuthority> authorities = new LinkedList<>(); if(comAuthGrpMngts != null){ for(ComAuthGrpMngt comAuthGrpMngt: comAuthGrpMngts){ GrantedAuthority grantedAuthority = new SimpleGrantedAuthority("ROLE_G" + comAuthGrpMngt.getAuthGrpMngtSeq()); authorities.add(grantedAuthority); } } return Collections.unmodifiableSet(sortAuthorities(authorities)); } @Override public String getPassword() { String pwd = null; if(comUserMngt.getComUserPwds() != null && !comUserMngt.getComUserPwds().isEmpty()){ pwd = comUserMngt.getComUserPwds().get(0).getUserPwd(); } return pwd; } @Override public String getUsername() { return comUserMngt.getLoginId(); } @Override public boolean isAccountNonExpired() { if(comUserMngt.getAcuntExpDt() != null){ return comUserMngt.getAcuntExpDt().getTime() > System.currentTimeMillis(); }else{ return true; } } @Override public boolean isAccountNonLocked() { return comUserMngt.getUserStatCd() != UserStatCd.LOCKOUT; } @Override public boolean isCredentialsNonExpired() { if(comUserMngt.getComUserPwds() != null && !comUserMngt.getComUserPwds().isEmpty()){ Date expiredDate = comUserMngt.getComUserPwds().get(0).getPwdExpDay(); if(expiredDate != null){ if(expiredDate.getTime() > System.currentTimeMillis()){ return true; // 진짜 만료 되지 않았다. }else{ return false; // 안녕 만료되었어...ㅜ.ㅜ } }else{ return true; // 기간이 설정되지 않으면 만료되지 않은 것으로 간주 } }else{ return true; // 패스워드가 없으면 만료 되지 않은 것으로 간주 } } @Override public boolean isEnabled() { return comUserMngt.getUserStatCd() == UserStatCd.ENABLED; } private static SortedSet<GrantedAuthority> sortAuthorities(Collection<? extends GrantedAuthority> authorities) { Assert.notNull(authorities, "Cannot pass a null GrantedAuthority collection"); SortedSet<GrantedAuthority> sortedAuthorities = new TreeSet<>(new AuthorityComparator()); for (GrantedAuthority grantedAuthority : authorities) { Assert.notNull(grantedAuthority, "GrantedAuthority list cannot contain any null elements"); sortedAuthorities.add(grantedAuthority); } return sortedAuthorities; } private static class AuthorityComparator implements Comparator<GrantedAuthority>, Serializable { private static final long serialVersionUID = SpringSecurityCoreVersion.SERIAL_VERSION_UID; @Override public int compare(GrantedAuthority g1, GrantedAuthority g2) { if (g2.getAuthority() == null) { return -1; } if (g1.getAuthority() == null) { return 1; } return g1.getAuthority().compareTo(g2.getAuthority()); } } }

3. 인증과 처리에 대한 각종 핸들러

SpringSecurityConfig 설정에는 총 6종의 핸들러가 선언되어 있다. 이중에 SecurityAuthenticationSuccessHandler만 설명하고 나머지는 Logging 파트에서 설명할 것이다. SecurityAuthenticationSuccessHandler의 역할은 로그인 처리가 완료되었을 경우 로그인한 사용자가 보게될 첫번째 화면으로 안내하는 것이다.

67번 라인의 onAuthenticationSuccess() 메소드에서 사용자에게 보여질 첫번째 화면을 지정해 준다. 그러나 우선적으로 처리해 주어야할 일이 있다. 70번 라인에 호출된 clearAuthenticationAttributes() 메소드는 로그인 시 발생했던 세션에 저장된 오류를 지워주는 역할을 수행한다. 그리고 72번 라인의 decideRedirectStrategy() 메소드를 통해 어떤 화면으로 이동할 것인지를 지정한다. 판단 기준은 targetUrlParameter 값이 있을 경우 그것을 1순위로 하여  리다이렉션하며, 1순위 URL이 없을 경우 Spring Security가 세션에 저장한 URL을 2순위로 한다. 2순위 URL이 없을 경우 Request의 REFERER을 3순위로 하여 그 REFERER URL로 이동하며,  3순위도 없을 경우 Default URL을 4순위로 한다. (SecurityAuthenticationSuccessHandler의 소스 내용은 [http://zgundam.tistory.com/52]를 차용하였다. 보다 상세한 내용도 이곳에서 확인할 수 있다.)

package com.example.demo.security; import java.io.IOException; import javax.servlet.ServletException; import javax.servlet.http.HttpServletRequest; import javax.servlet.http.HttpServletResponse; import javax.servlet.http.HttpSession; import org.springframework.security.core.Authentication; import org.springframework.security.web.DefaultRedirectStrategy; import org.springframework.security.web.RedirectStrategy; import org.springframework.security.web.WebAttributes; import org.springframework.security.web.authentication.AuthenticationSuccessHandler; import org.springframework.security.web.savedrequest.HttpSessionRequestCache; import org.springframework.security.web.savedrequest.RequestCache; import org.springframework.security.web.savedrequest.SavedRequest; import org.springframework.stereotype.Component; import org.springframework.util.StringUtils; @Component public class SecurityAuthenticationSuccessHandler implements AuthenticationSuccessHandler { private RequestCache requestCache = new HttpSessionRequestCache(); private String targetUrlParameter; private String defaultUrl; private boolean useReferer; private RedirectStrategy redirectStrategy = new DefaultRedirectStrategy(); public SecurityAuthenticationSuccessHandler() { targetUrlParameter = ""; defaultUrl = "/"; useReferer = false; } public String getTargetUrlParameter() { return targetUrlParameter; } public SecurityAuthenticationSuccessHandler setTargetUrlParameter(String targetUrlParameter) { this.targetUrlParameter = targetUrlParameter; return this; } public String getDefaultUrl() { return defaultUrl; } public SecurityAuthenticationSuccessHandler setDefaultUrl(String defaultUrl) { this.defaultUrl = defaultUrl; return this; } public boolean isUseReferer() { return useReferer; } public void setUseReferer(boolean useReferer) { this.useReferer = useReferer; } @Override public void onAuthenticationSuccess(HttpServletRequest request, HttpServletResponse response, Authentication authentication) throws IOException, ServletException { clearAuthenticationAttributes(request); int intRedirectStrategy = decideRedirectStrategy(request, response); switch (intRedirectStrategy) { case 1: useTargetUrl(request, response); break; case 2: useSessionUrl(request, response); break; case 3: useRefererUrl(request, response); break; default: useDefaultUrl(request, response); } } private void clearAuthenticationAttributes(HttpServletRequest request) { HttpSession session = request.getSession(false); if (session == null) { return; } session.removeAttribute(WebAttributes.AUTHENTICATION_EXCEPTION); } private void useTargetUrl(HttpServletRequest request, HttpServletResponse response) throws IOException { SavedRequest savedRequest = requestCache.getRequest(request, response); if (savedRequest != null) { requestCache.removeRequest(request, response); } String targetUrl = request.getParameter(targetUrlParameter); redirectStrategy.sendRedirect(request, response, targetUrl); } private void useSessionUrl(HttpServletRequest request, HttpServletResponse response) throws IOException { SavedRequest savedRequest = requestCache.getRequest(request, response); String targetUrl = savedRequest.getRedirectUrl(); redirectStrategy.sendRedirect(request, response, targetUrl); } private void useRefererUrl(HttpServletRequest request, HttpServletResponse response) throws IOException { String targetUrl = request.getHeader("REFERER"); redirectStrategy.sendRedirect(request, response, targetUrl); } private void useDefaultUrl(HttpServletRequest request, HttpServletResponse response) throws IOException { redirectStrategy.sendRedirect(request, response, defaultUrl); } /** * 인증 성공후 어떤 URL로 redirect 할지를 결정한다 판단 기준은 targetUrlParameter 값을 읽은 URL이 존재할 * 경우 그것을 1순위 1순위 URL이 없을 경우 Spring Security가 세션에 저장한 URL을 2순위 2순위 URL이 없을 * 경우 Request의 REFERER를 사용하고 그 REFERER URL이 존재할 경우 그 URL을 3순위 3순위 URL이 없을 경우 * Default URL을 4순위로 한다 * * @param request * @param response * @return 1 : targetUrlParameter 값을 읽은 URL * 2 : Session에 저장되어 있는 URL * 3 : referer 헤더에 있는 url * 0 : default url */ private int decideRedirectStrategy(HttpServletRequest request, HttpServletResponse response) { int result = 0; SavedRequest savedRequest = requestCache.getRequest(request, response); if (!"".equals(targetUrlParameter)) { String targetUrl = request.getParameter(targetUrlParameter); if (StringUtils.hasText(targetUrl)) { result = 1; } else { if (savedRequest != null) { result = 2; } else { String refererUrl = request.getHeader("REFERER"); if (useReferer && StringUtils.hasText(refererUrl)) { result = 3; } else { result = 0; } } } return result; } if (savedRequest != null) { result = 2; return result; } String refererUrl = request.getHeader("REFERER"); if (useReferer && StringUtils.hasText(refererUrl)) { result = 3; } else { result = 0; } return result; } }

지금까지의 코드로는 결과를 확인하기는 좀 어렵다. 다음 포스트에서 Apache Tiles의 사용과 더불어 결과를 확인해 보도록 하겠다.

demo.zip

본인은 Dao에 대한 테스트 코드를 만드는 것에 부정적이다. Dao 레벨의 테스트는 의미를 찾기가 어렵기 때문이다. 어떤 기능을 한다는 것은 Dao 레벨에서 만들어지는 단순한 기능이 아니라 여러가지 단순한 기능들을 엮어 하나의 의미있는 동작을 만들어야 하기 때문이다. 따라서 테스트의 단위는 의미있는 기능이 만들어지는 서비스 레벨에서 부터 이루어져야 하지 않을까? 더구나 Spring Data가 만들어내는 자동화 코드를 테스트할 의미가 있을까 싶다. 그러나 여기서는 Dao를 테스트 하므로써 Spring Data가 만들어내는 코드와 QueryDSL이 실제 동작하는지 살펴보고, flyway가 어떻게 개발환경 구축에 도움을 주는지 살펴볼 것이다.

1. flyway 설정과 테스트 데이터 입력

flyway는 기초 데이터를 넣어주는 유틸리티라고 생각하면 된다. 프로그램의 구동이 시작될 때 주어진 스크립트 파일을 하나씩 순서대로 실행해 준다. 여기서는 첫번째 파일에 DDL 스크립트를 넣고, 두번째 파일에는 기초데이터를 넣었다. 이 기능을 위해 대상 DB에 스크립트의 버전을 관리하는 테이블을 flyway가 스스로 만들어 둔다. 아래는 실행 스크립트를 만드는 방법이다.

2.DAO 테스트

아래 테스트하는 코드는 SpringSecurity에 사용할 메소드들이다. 더 추가되거나 변경될 수 있지만, 일단 생각나는 대로 작성했다. 테스트 코드를 보면 매우 엉성해 보일지도 모르겠다. 그러나 테스트 코드는 이정도 수준으로 작성하는 것이 옳다는 생각을 한다. 더 정교하고 완벽한 테스트 코드는 많은 시간과 노력이 들어가기 때문에 잘못하면 배보다 배꼽이 더 커지는 현상이 있다. 테스트에서 해야할 것은 원하는 동작을 오류 없이 수행 가능한 것인지를 확인하는 것 뿐이다.

테스트 코드를 작성할 때 주의할 점이 있다. 테스트 메소드는 다른 메소드와 연동되어 수행되면 안되고, 반드시 그 자체로 완결되어야 한다. 그렇지 않으면 작업이 진행되면서 계속 변화하고 추가되면 기능들로 인하여 빈번히 테스트를 수정해야 하는 상황이 발생한다. 그런 상황들은 테스트 코드를 만드는 것을 지치게 한다.

24번/25번 라인은 SpringBoot 환경에서 테스트할 환경을 조성해 주는 어노테이션이다. 26번 라인은 Lombok에서 제공하는 어노테이션으로 간편하게 로그를 찍을 수 있게 도와준다. 27번 라인의 @Transactional 어노테이션은 테스트를 수행하면서 더러워진(?) 데이터를 처음 상태로 만들어준다. 즉, 수행된 쿼리를 롤백 시켜준다. @Transactional 어노테이션을 지우면 테스트로 인해 변경된 데이터가 그대로 남게 된다. 28번 라인의 @FixMethodOrder 어노테이션은 테스트 메소드를 이름 순서대로 실행 시켜준다. 이것이 없을 경우는 어떤 테스트가 먼저 실행될 것인지 알 수 없다. 37번 라인의 @Test 어노테이션은 테스트 대상 메소드라는 것을 알린다. 

38번 라인에 선언된 메소드를 주의깊게 봐줬으면 한다. 앞 부분은 테스트 번호를 붙인 것이지만 뒤에는 한글로 테스트 명을 입력하였다. 이렇게 한글로 메소드명을 입력하면 따로 주석을 달지 않아도 직관적으로 무슨 테스트인지 확인할 수 있기 때문에 편리하다. 

40번과 65번 라인은 수행된 결과를 확인하는 문장이다. 이런 Assert 메소드는 여러가지 종류가 있지만, 본인을 이 두 메소드 외에는 별로 사용하지 않는다. 이유는 앞에서도 설명 했듯이 테스트 코드에 많은 시간과 노력을 들이고 싶지 않기 때문이다. 처한 여건이나 상황에 따라 다르겠지만, 적당한 테스트 수준을 유지하는 것이 테스트 코드의 진짜 핵심이지 않을까 싶다.

package com.example.demo.dao.jpa.com; import java.util.List; import org.junit.Assert; import org.junit.FixMethodOrder; import org.junit.Test; import org.junit.runner.RunWith; import org.junit.runners.MethodSorters; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.boot.test.context.SpringBootTest; import org.springframework.test.context.junit4.SpringRunner; import org.springframework.transaction.annotation.Transactional; import com.example.demo.entity.com.ComAuthGrpMngt; import com.example.demo.entity.com.ComMenuMngt; import com.example.demo.entity.com.ComUserAlowIp; import com.example.demo.entity.com.ComUserMngt; import com.example.demo.entity.com.ComUserPwd; import com.example.demo.entity.domain.Yn; import lombok.extern.java.Log; @RunWith(SpringRunner.class) @SpringBootTest @Log @Transactional @FixMethodOrder(MethodSorters.NAME_ASCENDING) public class TestComUserMngtRepository { @Autowired ComUserMngtRepository comUserMngtRepository; @Autowired ComUserPwdRepository comUserPwdRepository; @Autowired ComUserAlowIpRepository comUserAlowIpRepository; @Autowired ComAuthGrpMngtRepository comAuthGrpMngtRepository; @Autowired ComMenuMngtRepository comMenuMngtRepository; @Test public void T010_사용자조회(){ ComUserMngt comUserMngt = comUserMngtRepository.findOne(997L); Assert.assertNotNull(comUserMngt); log.info("###### ComUserMngt : " + comUserMngt); } @Test public void T020_사용자정보로_패스워드조회(){ ComUserMngt comUserMngt = comUserMngtRepository.findOne(997L); ComUserPwd comUserPwd = comUserPwdRepository.findByComUserMngtAndDelYn(comUserMngt, Yn.N); Assert.assertTrue("1111".equals(comUserPwd.getUserPwd())); } @Test public void T030_사용자정보로_허용IP조회하기(){ ComUserMngt comUserMngt = comUserMngtRepository.findOne(997L); List<ComUserAlowIp> comUserAlowIpList = comUserAlowIpRepository.findByComUserMngtAndDelYn(comUserMngt, Yn.N); if(!comUserAlowIpList.isEmpty()){ boolean isEqualsIP = false; for(ComUserAlowIp comUserAlowIp : comUserAlowIpList){ if("127.0.0.1".equals(comUserAlowIp.getAlowIp())){ isEqualsIP = true; break; } } Assert.assertTrue(isEqualsIP); } } @Test public void T040_사용자정보로_권한그룹조회하기(){ ComUserMngt comUserMngt = comUserMngtRepository.findOne(997L); List <ComAuthGrpMngt> comAuthGrpMngtList = comAuthGrpMngtRepository.findByComUserMngt(comUserMngt); Assert.assertTrue(!comAuthGrpMngtList.isEmpty()); for(ComAuthGrpMngt comAuthGrpMngt : comAuthGrpMngtList){ log.info(comAuthGrpMngt.toString()); } } @Test public void T050_사용자정보로_권한에_할당된_메뉴조회하기(){ ComUserMngt comUserMngt = comUserMngtRepository.findOne(997L); List<ComMenuMngt> comMenuMngtList = comMenuMngtRepository.findComUserMngtAndComAuthGrpMngt(comUserMngt); Assert.assertTrue(!comMenuMngtList.isEmpty()); for(ComMenuMngt comMenuMngt : comMenuMngtList){ log.info(comMenuMngt.toString()); } } @Test public void T060_모든_메뉴정보와_권한그룹조회하기(){ List<ComMenuMngt> comMenuMngtList = comMenuMngtRepository.findAllComMenuMngtAndAuthGrpMngt(); Assert.assertTrue(!comMenuMngtList.isEmpty()); for(ComMenuMngt comMenuMngt : comMenuMngtList){ log.info( comMenuMngt + "|" + comMenuMngt.getComAuthGrpMenuMaps().get(0).getComAuthGrpMngt()); } } }

첨부파일은 본 페이지를 만들기 위한 소스다.

demo.zip