라이브러리 적용

라이브러리를 업무시스템에 적용하는 방법은 다양한 방식이 있지만 크게 두가지로 분류할 수 있습니다.

업무 시스템 유형에 맞게 적용하시기 바랍니다.

1. (추천) 제공된 샘플 파일을 이용해 새로운 로그인/로그아웃 URL과 페이지를 추가하는 방식

기존 업무시스템 동작에 영향을 미치지 않고, SSO를 적용하려면 이 방식으로 진행하는 것을 추천합니다. SSO 서버 장애 또는 점검 등으로 사용할 수 없는 상태일 때 기존 방식의 로그인/아웃 처리를 수행하는 시나리오를 다른 방식보다 쉽게 제공할 수 있습니다.

1. 다운로드 받은 라이브러리를 필수 라이브러리 항목 + 샘플 페이지 모두 적용 가이드를 따라 복사합니다.

2. 제공된 샘플 파일을 프로덕션 환경에 맞게 레이아웃과 디자인을 변경합니다.

3. 제공된 샘플 파일에 업무 시스템 처리 로직(SSO 로그인 성공 후 처리, 로그아웃 후 처리 등)을 추가 합니다.

2. 기존 업무시스템에 존재하는 로그인/로그아웃 URL과 페이지를 그대로 활용하는 방식

1. 다운로드 받은 라이브러리에서 필수 라이브러리 항목만 적용 가이드를 따라 복사합니다.

2. 라이브러리와 함께 제공된 샘플 파일들을 참고하여 기존 비즈니스 로직에 SSO 관련 로직을 추가합니다.

적용 가이드

개발 언어에 해당하는 탭 선택 후 적용 가이드를 따라 업무 시스템에 SSO 라이브러리를 적용합니다.

ASP.NET

1. 라이브러리 파일 복사

SSO 에이전트 라이브러리 파일(NETS.SSO.Client.AuthCheck.dll, NETS.SSO.Client.Common.Crypto.dll, NETS.SSO.Client.Common.dll)을 해당 웹 응용프로그의 bin 폴더에 복사합니다.

2. 샘플 페이지 및 Javascript 파일 복사

배포된 파일 중 ‘SSOAgent’ 폴더와 그 폴더에 존재하는 모든 파일을 ‘{contextPath}/SSOAgent/’ 와 같이 호출될 수 있도록 웹 응용 프로그램의 root 폴더에 복사 합니다.

3. agentconfig.xml 파일 복사

환경 설정 파일인 ‘agentconfig.xml’은 web.config와 같은 위치에 복사합니다. Web.config의 appSettings 항목에 Agentconfig.xml 파일의 절대 경로를 설정합니다.

<appSettings>
    <add key="nsso.client.config.file" value="D:\NETS\NETS.SSO.Client.Web\agentconfig.xml" />
</appSettings>

ASP.NET MVC

1. 라이브러리 파일 복사

SSO 에이전트 라이브러리 파일(NETS.SSO.Client.AuthCheck.dll, NETS.SSO.Client.Common.Crypto.dll, NETS.SSO.Client.Common.dll)을 해당 웹 응용프로그램의 bin 폴더에 복사합니다. 웹 응용 프로그램의 프로젝트에서 참조추가를 실행해서 위 3개 dll을 참조 합니다.

2. 샘플 페이지 및 javascript 파일 복사

배포된 파일 중 ‘Views’, ‘Scripts’, ‘SSO’ 폴더에 있는 파일들을 해당 웹 응용 프로그램의 프로젝트에 복사합니다.

3. agentconfig.xml 파일 복사

환경 설정 파일인 ‘agentconfig.xml’은 web.config와 같은 위치에 복사합니다. Web.config의 appSettings 항목에 Agentconfig.xml 파일의 절대 경로를 설정합니다.

<appSettings>
    <add key="nsso.client.config.file" value="D:\NETS\NETS.SSO.Client.Web\agentconfig.xml" />
</appSettings>

JAVA

1. 필수 라이브러리 파일 복사

1-1. 배포된 'java-agent/WEB-INF/classes/Lib/java-agent-2019-SNAPSHOT.jar' 파일을 프로젝트 내 'WEB-INF/lib' 경로에 복사합니다.

java-agent/ (root)
    |-- WEB-INF/
        |-- lib/
            |-- java-agent-2019-SNAPSHOT.jar

개발환경에 따라 추가한 jar 파일이 자동으로 Java Build Path에 추가되는 경우도 있고 그렇지 않은 경우도 있습니다. Java Build Path에 라이브러리가 정상적으로 추가되었는지 확인하려면:

(eclipse 기준)

1. 프로젝트 루트에서 마우스 우클릭 후 메뉴에서 Properties를 선택합니다.

2. 팝업에서 좌측의 Java Build Path를 누르고 Libraries 탭을 선택합니다.

3. 목록에 java-agent-2019-SNAPSHOT.jar 파일이 표시되는지 확인합니다.

표시되지 않는다면 :

1. Add JARs 선택

2. {project}/src/main/webapp/WEB-INF/lib/java-agent-2019-SNAPSHOT.jar 선택

3. Apply and Close

Java Build Path에 라이브러리 추가 되었는지 확인

1-2. 배포된 'java-agent/ssoagent' 폴더와 그 폴더에 존재하는 모든 파일을 '{contextPath}/ssoagent/' 와 같이 호출 될 수 있도록 웹 응용프로그램(context)의 Root 폴더에 복사 합니다.

java-agent/ (root)
    |-- ssoagent/*

2. 샘플 페이지 복사

배포된 파일 중에 모든 샘플 페이지를 '{contextPath}/ssoagent/'와 같이 호출 될 수 있도록 웹 응용프로그램(context)의 Root 폴더에 복사 합니다.

샘플 페이지 목록

java-agent/ (root)
    |-- default.jsp
    |-- logon.jsp
    |-- logonEnc.jsp
    |-- logonError.jsp
    |-- logonTfa.jsp
    |-- logonWa.jsp

3. agentconfig.xml 파일 복사

환경설정 파일로 'WEB-INF/classes' 위치에 복사하면 됩니다.

java-agent/ (root)
    |-- WEB-INF
        |-- classes
            |-- agentconfig.xml

만일 해당 위치가 아닌 다른 곳에 복사하고 싶다면 해당 경로를 아래와 같은 형식으로 WAS 실행시 환경 변수로 추가합니다.

환경변수 위치 임의 설정 예제

-Dsso.config.file=/usr/nets/config/agentconfig.xml

라이브러리 적용이 완료되면 다음 단계로 이동하여 환경설정 파일(agentconfig.xml)을 수정 하십시오.