라이브러리 적용

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

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

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

JAVA

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