표준프레임워크 공통컴포넌트

공통컴포넌트 정의

• 공통컴포넌트는 전자정부 사업에서 응용SW 개발 시 공통적으로 활용하기 위하여, 재사용이 가능하도록 개발한 어플리케이션의 집합임
• 공통컴포넌트는 표준프레임워크 실행환경을 기반으로 MVC 아키텍처를 준수하여 설계 및 개발함
• 전자정부 사업에서 쉽게 커스터마이징하여 재사용할 수 있도록 전자정부 표준프레임워크 포털을 통해 소스코드와 가이드를 제공

공통컴포넌트 구성

egovframe-common-components
  ├─script
  └─src
     ├─main
     │  ├─java/egovframework/com
     │  │  ├─cmm
     │  │  ├─cop
     │  │  ├─dam
     │  │  ├─ext
     │  │  ├─sec
     │  │  ├─ssi/syi
     │  │  ├─sts
     │  │  ├─sym
     │  │  ├─uat
     │  │  ├─uss
     │  │  └─utl
     │  ├─resources
     │  └─webapp
     └─script

공통컴포넌트 구성 설명

• script : 공통컴포넌트에서 지원하는 데이터베이스(mysql, oracle, altibase, tibero, cubrid, mariadb, postgres, goldilocks 8종)에 대한 전체 DDL, DML, Comment 제공
• src/main/java/egovframework/com/cmm : 공통으로 사용하는 클래스들로 구성
• src/main/java/egovframework/com/cop : 게시판, 커뮤니티, 일정관리 같은 협업 업무에서 사용하는 클래스들로 구성
• src/main/java/egovframework/com/dam : 개인지식관리, 지식맵 관리 같은 디지털 자산관리 업무에서 사용하는 클래스들로 구성
• src/main/java/egovframework/com/ext : LDAP, Oauth 연동 같은 외부 추가 컴포넌트 클래스들로 구성
• src/main/java/egovframework/com/sec : 권한관리, 그룹관리, 롤관리와 같은 보안 업무에서 사용하는 클래스들로 구성
• src/main/java/egovframework/com/ssi/syi : 시스템연계, 연계현황관리 서비스 연계 업무에서 사용하는 클래스들로 구성
• src/main/java/egovframework/com/sts : 게시물통계, 사용자통계 같은 통계관리 업무에서 사용하는 클래스들로 구성
• src/main/java/egovframework/com/sym : 공통코드관리, 로그관리, 메뉴관리 같은 시스템관리 업무에서 사용하는 클래스들로 구성
• src/main/java/egovframework/com/uat : 로그인, 인증서관리 같은 통합인증 업무에서 사용하는 클래스들로 구성
• src/main/java/egovframework/com/uss : 회원관리, 약관관리, 정보제공/알림 같은 사용자 지원 업무에서 사용하는 클래스들로 구성
• src/main/java/egovframework/com/utl : 달력, 포맷/계산/변환, 유효성검증 같은 유틸리티 클래스들로 구성
• src/main/resources : 공통컴포넌트 코드에서 사용하는 리소스 폴더
• src/main/webapp : 공통컴포넌트 웹페이지 루트 폴더
• src/script : 공통컴포넌트에서 지원하는 데이터베이스에 대한 업무 분류별 DDL, DML 제공

공통컴포넌트 구동 방법

1. 개발환경 Eclipse IDE를 실행함
2. Eclipse IDE 메뉴에서 File>Import… 를 클릭하여 프로젝트를 가져옴
3. 프로젝트명을 마우스 우클릭하여 Maven > Update Project… > Force Update of Snapshots/Releases 체크 후 Update를 실행함
4. 공통컴포넌트를 설치한 프로젝트 내에 위치한 globals.properties(src/main/resources/egovframework/egovProps/globals.properties) 파일의 데이터베이스 정보를 설정함
5. globals.properties 파일의 인증/권한방식 정보를 설정함
6. 프로젝트명을 마우스 우클릭하여 Run As > Run on Server를 실행함
7. 브라우저를 통해 공통컴포넌트 서비스를 확인함

⚠️ 보안 주의사항 (개발 적용 전 필수 변경)

공통컴포넌트가 기본으로 제공하는 암호화 키와 사용자 계정 정보는 공개된 값입니다. 개발 환경에 적용하기 전 아래 두 가지를 반드시 변경하시기 바랍니다.

1. Crypto 암호화 키 변경 (algorithmKey / algorithmKeyHash)

표준프레임워크 Crypto 암호화 서비스는 국정원 ARIA 암호화 알고리즘 기반입니다.

• 아래 파일의 algorithmKey, algorithmKeyHash 기본값 egovframe 을 반드시 다른 값으로 변경해야 합니다.
  • src/main/resources/egovframework/egovProps/conf/egov-crypto-config.properties
  • src/main/resources/egovframework/egovProps/globals.properties 의 Globals.File.algorithmKey
• 변경하지 않는 것은 우리집 도어락 비밀번호를 1234 초기값 그대로 사용하는 것과 동일합니다.
• 참고 자료
  • Crypto 위키 가이드
  • 해시키 생성 소스 샘플 (MakeHashedPassword.java)

2. 기본 사용자 계정 비밀번호 변경

script/dml 의 초기 데이터에는 아래 테스트용 사용자 정보가 포함되어 있습니다. (ID 대소문자 유의)

구분	ID	초기 PW
일반사용자	USER	rhdxhd12
기업사용자	ENTERPRISE	rhdxhd12
업무사용자1	TEST1	rhdxhd12
업무사용자2	webmaster	rhdxhd12

초기 비밀번호 rhdxhd12 는 "공통12" 를 영문 자판으로 입력한 값입니다.

• 위 계정의 비밀번호를 반드시 변경하고, 사용하지 않는 계정은 삭제한 후 운영하시기 바랍니다.
• 개발시 초기값을 그대로 사용할 경우, 그대로 배포까지 이어져서 누구나 알고 있는 계정정보로 시스템에 접근할 수 있어 심각한 보안 위험이 발생합니다.

5.0.1 패치 내용

• 인증인가 처리 경로 공개로 검증 절차 우회 오류 수정

참조

1. 공통컴포넌트 위키가이드
2. 개발환경 다운로드
3. 공통컴포넌트 다운로드
4. 공통컴포넌트 로그인정보