AUD SSO 로그인을 통하여 인증 접근 토큰(acces token)을 획득하여 팝업이나 새창으로 AUD 보고서나 Portal을 사용할 수 있는 오픈 API 입니다.
타 시스템에서 AUD 플랫폼에서 제공하는 보고서 및 PORTAL을 팝업이나 새창으로 오픈하여 사용이 가능합니다.
- 타 시스템과 AUD 서버와 도메인이 상이하여도 새창으로 window.open 한 형식이라면 오픈이 가능하도록 구성되어 있습니다.
SSO 인증을 위한 AUD 플랫폼에 설정할 항목
1. AUD7 Admin 에서 SSO 연동할 타 시스템 서버 IP 등록
- 시스템 관리 > 시스템 옵션 > 시스템 사용 옵션 탭 클릭
- SSO_AUTH_IP 검색 . 해당 코드가 존재 할 경우에 값에 서버 IP 추가 (여러개 등록 시 세미콜론(;) 으로 구분자 처리)
- SSO_AUTH_IP 코드가 없을 경우 신규 버튼 클릭 > 신규로 생성된 row의 코드에 SSO_AUTH_IP 추가 후 값 항목에 서버 IP 등록
- 등록 후에 저장 버튼 클릭
2. AUD 플랫폼 서버에 CORS Allowed origin url 등록
- AUD플랫폼서버 설치 경로/WEB-INF/classes/framework/service/service_api.properties 확인
- matrix.prop.location=true 되어 있고 matrix.prop.location.path에 경로가 지정되 있을 경우 해당 경로로 가서 service_api.properties 파일을 수정.
- 타 연동 시스템에서 SSO 오픈 API 호출 시에 Request Header에 설정된 Origins URL을 등록
- matrix.cross.origin.allowed 에 타사 연동 PORTAL URL 추가
# cross origin 허용 url (여러개의 주소를 설정할 경우 구분자는 콤마) matrix.cross.origin.allowed=http://1.1.1.1,https://2222:8080/XXX,http://a.co.kr
- service_api.properties 수정 후에 AUD7 플랫폼 서버 재기동 하여야 적용이 완료됩니다.
SSO 오픈API
SSO 인증 로그인
AUD 플랫폼에서 제공하는 SSO 오픈 API에서 사용하는 요청 URL에 대한 정보입니다.
요청 URL | 메서드 | 파라메터 | 응답 형식 | 설명 | ||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
{AUD7서버 주소}/api/auth/cs/sso/token/publish?userId={사용자아이디}&targetUrl={오픈할 AUD7서버 URL} | POST | query string
| - | AUD7 플랫폼에 등록된 IP 및 URL에서 호출 userId를 통하여 SSO 인증 후에 access Token 발급받아 AUD7 플랫폼에서 제공하는 보고서 또는 PORTAL 오픈 |