Agent 환경 설정 파일 수정

Agent 환경 파일(agentconfig.xml) 내 주요 설정 항목

주요 설정 항목이 잘못된 경우에는 오류가 발생합니다. 그렇기 때문에 환경 설정 파일에 정보가 올바르게 설정되었는지 반드시 확인이 필요합니다. 그래도 해결 할 수 없는 경우에는 오류코드를 참고하거나 SSO 담당자를 통해 확인 바랍니다.

SSO 서버 정보

1. SSO Provider

SSO 인증 도메인 정보로 초기값이 설정되어 있지만 다시 한 번 확인합니다.

• 개발서버 : ssodev.lotte.net

• 운영서버 : sso.lotte.net

agentconfig.xml 일부

... 중략
<ssoProvider value="sso.lotte.net">
...

개발서버와 운영서버의 값이 다르므로 올바르게 설정 되었는지 확인합니다. SSO 담당자에게 확인 후 필요하다면 변경합니다. 특별한 경우가 아니라면 변경할 필요가 없습니다.

2. Agent Service Url

SSO Agent와 SSO 인증 서버 간 각종 정보 교환을 위해 사용하는 웹 서비스 URL 입니다. 초기값이 설정되어 있지만 다시 한 번 확인합니다.

timeout 속성을 이용해 SSO 서버와 통신할 때 타임아웃 시간을 설정할 수 있으며 밀리초(Millisecond) 단위 입니다. 기본값은 5000(5초) 입니다.

agentconfig.xml 일부

... 중략
<agentServiceUrl value="https://sso.lotte.net/AuthWeb/AgentService/Web/2019/%s.aspx" timeOut="5000" />
...

개발서버와 운영서버의 값이 다르므로 올바르게 설정 되었는지 확인합니다. SSO 담당자에게 확인 후 필요하다면 변경합니다. 특별한 경우가 아니라면 변경할 필요가 없습니다.

업무시스템 정보

업무시스템 정보는 아래와 같은 형태로 기본값이 설정되어 있습니다. 각 항목 확인 후 업무시스템에 해당하는 값으로 변경해야 합니다.

agentconfig.xml 일부(업무시스템 정보)

<agentConfig>
	<common>
		... 중략
		<checkLive cycleTime="1000" ssoSiteFqdn="test.lotte.net" />
	</common>
	... 중략
	<ssoSite fqdn="test.lotte.net" id="2C2637BD8AC54583ADE7AB3FCBE3258E" serverIP="111.111.111.111" agentType="1104">
	    <authCheckLevel level="MEDIUM" />
	    <defaultReturnURL value="https://test.lotte.net/Agent/Default.aspx" />
	    <errorPageURL value="https://test.lotte.net/Agent/LogonError.aspx" />
	</ssoSite>
	...
</agentConfig>

3. (.NET MVC only) ssoSiteFqdn

업무 시스템의 FQDN(Fully Qualified Domain Name)을 입력합니다.

<checkLive> 태그는 .NET MVC 라이브러리에만 필요한 태그입니다.

4. fqdn

업무 시스템의 FQDN(Fully Qualified Domain Name)을 입력합니다.

멀티 도메인을 지원해야 할 경우 엘리먼트를 추가합니다.

개발서버와 운영서버의 값이 다르므로 올바르게 설정 되었는지 확인합니다.

5. id

SSO에 등록된 업무시스템 ID로 SSO 담당자로부터 제공 받아 입력합니다.

업무시스템 정보 전달 과정에서 SSO 담당자가 발급하여 제공하는 정보입니다.

6. serverIP

Agent가 동작하는 WAS 서버의 IP를 입력합니다.

WEB 서버가 아닌 WAS 서버의 IP 입니다.

7. agentType

업무시스템 개발 언어에 따라 다릅니다. 아래 코드를 참고해 입력합니다.

언어	코드
ASP.NET	1101
ASP.NET MVC	1106
JAVA	1104
PHP	1107

이 외의 언어는 현재는 지원하지 않습니다. 추후 지원 여부는 SSO 담당자에게 문의 바랍니다.

8. defaultReturnURL

인증되지 않은 경우 이동할 페이지의 호스트를 포함한 Full URL을 입력합니다.

9. errorPageURL

로그온이 실패한 경우 이동할 페이지의 호스트를 포함한 Full URL 또는 Context Path를 입력합니다.

[환경설정 파일 전체 예시]

agentconfig.xml

<?xml version="1.0" encoding="utf-8" ?>
<agentConfig>
	<common>
		<clientIPCheckLevel value="0">
			<skipDeviceUserAgentList>
				<userAgent value="Android" />
				<userAgent value="iPhone" />
				<userAgent value="iPad" />
			</skipDeviceUserAgentList>
		</clientIPCheckLevel>
		<submitUrlOption value="submit"/>
		<scriptOption value="top" />
		<serverTimeSyncBuffer value="0" />
		<checkLive cycleTime="1000" ssoSiteFqdn="test.lotte.net" /> // .NET MVC only
		<methodExecution checkLive="true" logTime="false"/> // Java only
	</common>
	<ssoProvider value="sso.lotte.net">
		<agentServiceUrl value="http://sso.lotte.net/AuthWeb/AgentService/Web/2019/%s.aspx" timeOut="10000" />
		<ssoSiteList>
			<ssoSite fqdn="test.lotte.net" id="2C2637BD8AC54583ADE7AB3FCBE3258E" serverIP="111.111.111.111" agentType="1104">
				<authCheckLevel level="MEDIUM" />
				<defaultReturnURL value="https://test.lotte.net/Agent/Default.aspx" />
				<errorPageURL value="https://test.lotte.net/Agent/LogonError.aspx" />
			</ssoSite>
		</ssoSiteList>
	</ssoProvider>
</agentConfig>

agentconfig.xml은 개발 언어별로 조금씩 다르기 때문에 배포된 라이브러리에 포함된 파일을 베이스로 위에서 가이드된 내용만 수정하시기 바랍니다. 그 외의 값은 특별한 경우가 아니라면 수정하지 않는 것을 권장합니다.