¶ 권한설정관리 기능
권한설정관리 기능은 권한그룹별 시스템 권한과 메뉴 권한 적용 상태를 조회하고 저장하기 위해 사용한다. 시스템에 노출할 권한코드 설정과 권한그룹별 권한 매핑을 함께 관리한다.
¶ 관련화면 및 수행메뉴얼
¶ 권한설정 목록조회
| Action URL | Controller method | QueryID |
|---|---|---|
조회 /ias/sysMenuAuthrt/sysMenuAuthrtList.do |
SysMenuAuthrtPageController.sysMenuAuthrtList |
selectSysMenuAuthrtList, selectSysMenuAuthrtListCnt |
조회 /api/v1/sysMenuAuthrt/list |
SysMenuAuthrtApiController.getList |
selectSysMenuAuthrtList, selectSysMenuAuthrtListCnt |
상세이동 /ias/sysMenuAuthrt/sysMenuAuthrtDetail.do?roleCd={roleCd}&sysCd={sysCd} |
SysMenuAuthrtPageController.sysMenuAuthrtDetail |
selectRoleById |
수정이동 /ias/sysMenuAuthrt/sysMenuAuthrtModify.do?roleCd={roleCd}&sysCd={sysCd} |
SysMenuAuthrtPageController.sysMenuAuthrtModify |
selectRoleById |
권한설정 목록은 시스템별 권한그룹 트리를 기준으로 조회한다. 목록에는 권한그룹명, 권한그룹유형, 적용 사용자 수, 시스템 권한과 메뉴 권한 매핑 합계가 함께 표시된다.
조회 : 시스템, 권한그룹명, 권한그룹유형, 사용여부를 입력한 뒤 조회 버튼을 클릭한다.
초기화 : 검색조건을 초기 상태로 되돌린다.
상세 : 목록의 상세 버튼을 클릭하여 권한설정 상세조회 화면으로 이동한다.
수정 : 목록의 수정 버튼을 클릭하여 권한설정 수정 화면으로 이동한다.
¶ 권한설정 상세조회
| Action URL | Controller method | QueryID |
|---|---|---|
상세조회 /ias/sysMenuAuthrt/sysMenuAuthrtDetail.do?roleCd={roleCd}&sysCd={sysCd} |
SysMenuAuthrtPageController.sysMenuAuthrtDetail |
selectRoleById, selectMenuListFromSysCd, selectMenuRoleAuthrtMappings, selectSysRoleAuthrtMappings, selectMenuAuthrtSettings, selectSystemAuthrtSettings, selectAuthrtCatalog |
수정이동 /ias/sysMenuAuthrt/sysMenuAuthrtModify.do?roleCd={roleCd}&sysCd={sysCd} |
SysMenuAuthrtPageController.sysMenuAuthrtModify |
selectRoleById, selectMenuListFromSysCd |
권한설정 상세조회 화면은 선택한 권한그룹의 메뉴 트리 권한 현황과 시스템 권한, 메뉴 권한 코드를 함께 보여준다. 메뉴에 권한 매핑이 있으면 트리에서 적용 상태 배지가 표시된다.
목록 : 권한설정 목록조회 화면으로 이동한다.
수정 : 권한설정 수정 화면으로 이동한다.
¶ 시스템 권한 설정 수정
| Action URL | Controller method | QueryID |
|---|---|---|
수정화면 /ias/sysMenuAuthrt/sysMenuAuthrtModify.do?roleCd={roleCd}&sysCd={sysCd} |
SysMenuAuthrtPageController.sysMenuAuthrtModify |
selectRoleById, selectSystemAuthrtSettings, selectAuthrtCatalog, selectSysRoleAuthrtMappings |
권한코드설정 저장 /api/v1/sysMenuAuthrt/settings |
SysMenuAuthrtApiController.updateAuthrtSettings |
selectAuthrtCatalog, selectAuthrtSettingsByTarget, deleteAuthrtSettingsByTarget, insertAuthrtSetting, deleteSysRoleAuthrtMappingsByTarget |
시스템 권한 저장 /api/v1/sysMenuAuthrt/sys |
SysMenuAuthrtApiController.createSysMapping, updateSysMapping, deleteSysMapping |
insertSysRoleAuthrtMapping, deleteSysRoleAuthrtMapping |
시스템 권한 설정 수정 화면의 상단 영역에서는 시스템에 노출할 권한코드와 현재 권한그룹의 체크 상태를 함께 관리한다. 권한 코드 설정 버튼으로 선택 창을 열어 시스템 노출 권한코드를 저장하고, 시스템 권한 저장 버튼으로 현재 체크 상태를 기준으로 시스템 권한 매핑을 등록 또는 제거한다.
sysCd,authrtStngTypeCd,authrtStngTrgtCd는 필수다.- 권한설정유형은
SYS또는MENU만 허용한다. - 시스템 권한 설정 대상은 시스템코드와 같아야 한다.
- 권한카탈로그에 없는 권한코드는 저장할 수 없다.
권한 코드 설정 : 시스템 권한코드 선택 팝업을 열어 노출 대상을 저장한다.
시스템 권한 저장 : 체크 상태를 기준으로 현재 권한그룹의 시스템 권한을 저장한다.
목록 : 권한설정 목록조회 화면으로 이동한다.
¶ 메뉴 권한 설정 수정
| Action URL | Controller method | QueryID |
|---|---|---|
수정화면 /ias/sysMenuAuthrt/sysMenuAuthrtModify.do?roleCd={roleCd}&sysCd={sysCd} |
SysMenuAuthrtPageController.sysMenuAuthrtModify |
selectMenuListFromSysCd, selectMenuAuthrtSettings, selectMenuRoleAuthrtMappings, selectAuthrtCatalog |
권한코드설정 저장 /api/v1/sysMenuAuthrt/settings |
SysMenuAuthrtApiController.updateAuthrtSettings |
selectAuthrtCatalog, selectAuthrtSettingsByTarget, deleteAuthrtSettingsByTarget, insertAuthrtSetting, deleteMenuRoleAuthrtMappingsByTarget |
메뉴 권한 저장 /api/v1/sysMenuAuthrt/menu |
SysMenuAuthrtApiController.createMenuMapping, updateMenuMapping, deleteMenuMapping |
insertMenuRoleAuthrtMapping, deleteMenuRoleAuthrtMapping |
메뉴 권한 설정 수정 화면의 하단 영역에서는 메뉴 트리에서 대상을 선택한 뒤 메뉴 접근 권한과 개별 권한코드 적용 여부를 저장한다. 메뉴 체크는 PERM_MENU_ACCESS 적용 여부를 의미하며, 권한 코드 설정 버튼은 해당 메뉴에 노출할 권한코드를 저장한다.
- 메뉴 권한 저장은 선택한 메뉴가 있어야 수행할 수 있다.
PERM_MENU_ACCESS는 권한코드설정 저장 대상이 아니며 메뉴 체크로만 적용한다.- 메뉴 체크를 해제하면 해당 메뉴의 메뉴 접근 권한과 권한코드 매핑이 함께 정리된다.
- 메뉴 권한 저장은 현재 체크 상태와 기존 매핑을 비교해 등록 또는 삭제한다.
메뉴 선택 : 좌측 메뉴 트리에서 저장 대상을 선택한다.
권한 코드 설정 : 선택한 메뉴의 권한코드 선택 팝업을 열어 노출 대상을 저장한다.
메뉴 권한 저장 : 체크 상태를 기준으로 현재 권한그룹의 메뉴 권한을 저장한다.
목록 : 권한설정 목록조회 화면으로 이동한다.
¶ 관련 리소스
¶ 클래스
| 유형 | 대상소스명 | 비고 |
|---|---|---|
| Controller | src/main/java/allforland/ias/sysmenuauthrt/web/SysMenuAuthrtPageController.java |
권한설정관리 화면 요청을 처리하는 컨트롤러 클래스 |
| API Controller | src/main/java/allforland/ias/sysmenuauthrt/web/SysMenuAuthrtApiController.java |
권한설정관리 API 요청을 처리하는 컨트롤러 클래스 |
| Service | src/main/java/allforland/ias/sysmenuauthrt/service/SysMenuAuthrtService.java |
권한설정관리 서비스 인터페이스 |
| ServiceImpl | src/main/java/allforland/ias/sysmenuauthrt/service/impl/SysMenuAuthrtServiceImpl.java |
권한설정관리 서비스 구현 클래스 |
| Mapper | src/main/java/allforland/ias/sysmenuauthrt/mapper/SysMenuAuthrtMapper.java |
권한설정관리 데이터 처리 Mapper 인터페이스 |
| VO | src/main/java/allforland/ias/sysmenuauthrt/vo/SysMenuAuthrtVO.java |
권한설정관리 VO 클래스 |
| DTO | src/main/java/allforland/ias/sysmenuauthrt/web/dto/SysMenuAuthrtMappingRequestDTO.java |
시스템·메뉴 권한 매핑 요청 DTO 클래스 |
| DTO | src/main/java/allforland/ias/sysmenuauthrt/web/dto/SysMenuAuthrtSettingRequestDTO.java |
권한코드설정 저장 요청 DTO 클래스 |
| JSP | src/main/webapp/WEB-INF/jsp/ias/sysMenuAuthrt/sysMenuAuthrtList.jsp |
권한설정 목록조회 페이지 |
| JSP | src/main/webapp/WEB-INF/jsp/ias/sysMenuAuthrt/sysMenuAuthrtDetail.jsp |
권한설정 상세조회 페이지 |
| JSP | src/main/webapp/WEB-INF/jsp/ias/sysMenuAuthrt/sysMenuAuthrtModify.jsp |
권한설정 수정 페이지 |
| Query XML | src/main/resources/mapper/sysmenuauthrt/SysMenuAuthrtMapper.xml |
권한설정 조회 및 저장 Query XML |
| SQL | docker/postgres/init/01-schema.sql |
권한설정 관련 테이블 생성을 위한 스키마 SQL |
| SQL | docker/postgres/init/02-data.sql |
권한설정 기본데이터 적재 SQL |
¶ 클래스 다이어그램
¶ 테이블
| 테이블명 | 테이블명(영문) | 비고 |
|---|---|---|
| 권한 설정 | afias.authrt_stng |
시스템 또는 메뉴에 노출할 권한코드 설정을 관리하는 테이블 |
| 시스템 권한 매핑 | afias.sys_role_authrt_mpng |
권한그룹별 시스템 권한 매핑을 관리하는 테이블 |
| 메뉴 권한 매핑 | afias.menu_role_authrt_mpng |
권한그룹별 메뉴 권한 매핑을 관리하는 테이블 |