상단

Java와 PHP를 위한 SSO 모듈인 JOSS(Java Open Single Sign-On)를 정리한다. JOSSO는 J2EE와 Spring 기반의 SSO 솔루션 이다.

 

설치 가이드 - JOSSO Gateway


Windows 환경에서 Apache Tomcat 6.0.16에 JOSSO Gateway(Idp)를 설치 한다. 사용자 인증을 위해서는 MySQL 5.0.51을 사용 한다.

 

설치전 사전 준비 사항

  • [Java SE Development Kit 6 Update 4 (JDK 1.6.0_04-b12)](JDK 6.0.md) 설치

  • [MySQL Community Server 5.0.51](MySQL 5.0.51.md) 설치

    • [MySql Tools for 5.0](MySql Tools for 5.0.md) 설치

  • [Apache HTTP Server 2.2.8 with OpenSSL 0.9.8g](Apache HTTP Server 2.2.8.md) 설치

  • [Apache Tomcat 6.0.16](Apache Tomcat 6.0.16.md) 설치

    • [Tomcat Connectors 1.1.26](Tomcat Connectors 1.1.26.md)

 

JOSSO용 Database 설정

{{MySQL DB 설정|JOSSO|jossodb|josso}}

 
  • MySQL Query Browser를 실행하여 jossodb에 josso 사용자로 로그인 한다.

    • 아래 SQL문을 실행하여 JOSSO에서 사용할 table을 생성 한다.

    • MySQL에서 password는 예약어이므로 password라는 항목명은 passwd로 변경 하여 테이블을 생성 하였다.

 
 DROP TABLE IF EXISTS `JOSSO_ROLE`;
 CREATE TABLE `JOSSO_ROLE` (
   `name` varchar(16) NOT NULL,
   `description` varchar(64) DEFAULT NULL,
   PRIMARY KEY (`name`)
 ) ENGINE=InnoDB DEFAULT CHARSET=utf8;
 
 DROP TABLE IF EXISTS `JOSSO_USER`;
 CREATE TABLE `JOSSO_USER` (
   `login` varchar(16) NOT NULL,
   `passwd` varchar(20) NOT NULL,
   `name` varchar(64) DEFAULT NULL,
   `description` varchar(64) DEFAULT NULL,
   PRIMARY KEY (`login`)
 ) ENGINE=InnoDB DEFAULT CHARSET=utf8;
 
 DROP TABLE IF EXISTS `JOSSO_USER_PROPERTY`;
 CREATE TABLE `JOSSO_USER_PROPERTY` (
   `login` varchar(16) NOT NULL,
   `name` varchar(255) NOT NULL,
   `value` varchar(255) NOT NULL,
   PRIMARY KEY (`login`,`name`), 
   CONSTRAINT `JOSSO_USER_PROPERTY_ibfk_1` 
     FOREIGN KEY (`login`) REFERENCES `JOSSO_USER` (`login`)
 ) ENGINE=InnoDB DEFAULT CHARSET=utf8; 
 
 DROP TABLE IF EXISTS `JOSSO_USER_ROLE`;
 CREATE TABLE `JOSSO_USER_ROLE` (
   `login` varchar(16) NOT NULL,
   `name` varchar(255) NOT NULL,
   PRIMARY KEY (`login`,`name`),
   KEY `name` (`name`),
   CONSTRAINT `JOSSO_USER_ROLE_ibfk_2` 
     FOREIGN KEY (`login`) REFERENCES `JOSSO_USER` (`login`),
   CONSTRAINT `JOSSO_USER_ROLE_ibfk_1` 
     FOREIGN KEY (`name`) REFERENCES `JOSSO_ROLE` (`name`)
 ) ENGINE=InnoDB DEFAULT CHARSET=utf8;
  • InnoDB를 사용하지 않을 경우에는 "ENGINE=InnoDB DEFAULT CHARSET=utf8;" 대신 "TYPE=MyISAM;"를 사용한다.

 

  • JOSSO가 정상 실행되는지 테스트를 원할 경우 다음 SQL문을 실행한다.

    • MySQL에서 password는 예약어이므로 password라는 항목명은 passwd로 변경 하여 SQL문을 작성 하였다.

 
 INSERT INTO JOSSO_ROLE (NAME,DESCRIPTION) VALUES('role1','The Role1');
 INSERT INTO JOSSO_ROLE (NAME,DESCRIPTION) VALUES('role2','The Role2');
 INSERT INTO JOSSO_ROLE (NAME,DESCRIPTION) VALUES('role3','The Role3');
 
INSERT INTO JOSSO_USER (LOGIN,PASSWD,DESCRIPTION)VALUES('user1', 'user1pwd', 'The User1'); INSERT INTO JOSSO_USER_ROLE (LOGIN,NAME) VALUES('user1', 'role1'); INSERT INTO JOSSO_USER_ROLE (LOGIN,NAME) VALUES('user1', 'role2'); INSERT INTO JOSSO_USER_PROPERTY(LOGIN,NAME,VALUE)VALUES('user1', 'user.name', 'User1 Name'); INSERT INTO JOSSO_USER_PROPERTY(LOGIN,NAME,VALUE)VALUES('user1', 'user.lastName', 'User1 Last Name'); INSERT INTO JOSSO_USER_PROPERTY(LOGIN,NAME,VALUE)VALUES('user1', 'user.registrationDate', 'User1 Registration Date');
INSERT INTO JOSSO_USER (LOGIN,PASSWD,DESCRIPTION)VALUES('user2', 'user2pwd', 'The User2') ; INSERT INTO JOSSO_USER_ROLE (LOGIN,NAME)VALUES('user2', 'role3'); INSERT INTO JOSSO_USER_PROPERTY(LOGIN,NAME,VALUE)VALUES('user2', 'user.name', 'User2 Name'); INSERT INTO JOSSO_USER_PROPERTY(LOGIN,NAME,VALUE)VALUES('user2', 'user.lastName', 'User2 Last Name'); INSERT INTO JOSSO_USER_PROPERTY(LOGIN,NAME,VALUE)VALUES('user2', 'user.registrationDate', 'User2 Registration Date');

 

JOSSO Gateway 설치

  • 다운로드 사이트에서 josso-1.8.0.zip를 다운로드 한다.

    • 압축을 풀어 d:/josso 폴더에 복사한다.

 

  • DOS 창에서 JOSSO Agent를 다음과 같이 설치 한다.

    • Windows Vista의 경우, 관리자 권한으로 실행 한다.

 
 cd d:/josso/bin
 josso-gsh.bat
   gateway install --target "$TOMCAT_HOME" --platform tc60
   exit
  • $JAVA_HOME 변수에 공백이 들어 있어 "지정된 경로를 찾을 수 없습니다."라는 오류가 발생할 경우에는, PATH 환경 변수에 $JAVA_HOME/bin 폴더를 추가하고 josso-gsh.bat를 다음과 같이 수정 한다.

 
 "%JAVACMD%" %JAVA_OPTS% -jar "%BOOTJAR%" %ARGS% 를 삭제하고 아래 라인을 추가
 java %JAVA_OPTS% -jar "%BOOTJAR%" %ARGS%

  • 설치가 정상적으로 진행이 되면 $TOMCAT_HOME 아래에서 다음 사항을 확인할 수 있다.

    • $TOMCAT_HOME/lib/josso-* 파일 들

    • $TOMCAT_HOME/webapps/josso 폴더

 

  • 설치가 완료된 후 d:/josso 폴더를 삭제한다.

 

  • Ubnutu Server에서 JOSSO 설치

 
 cd /usr/share/tomcat6
 ln ln -s /etc/tomcat6 conf
 cd ~/josso/josso-1.8.1/bin
 ./josso-gsh
     gateway install --target "/usr/share/tomcat6" --platform tc60
     exit
 
 cd /var/lib/tomcat6/webapps
 ln -s /usr/share/tomcat6/webapps/josso josso
 

JOSSO Gateway 환경 설정

  • MySQL용 JDBC Driver를 설정한다.

    • MySQL JDBC Driver 다운로드 사이트에 접속 한다.

    • "JDBC Driver for MySQL (Connector/J)" 아래에 있는 "Download" 링크를 선택한다.

    • Source and Binaries (zip) 옆에 있는 링크를 선택하여 mysql-connector-java-5.1.7.zip 파일을 다운로드 한다.

    • zip 파일의 압축을 풀어 안에 있는 mysql-connector-java-5.1.7-bin.jar 파일을 $TOMCAT_HOME/webapps/josso/WEB-INF/lib 아래에 복사하고 Tomcat을 재기동 한다.

 

  • $TOMCAT_HOME/lib/josso-gateway-config.xml 파일에 사용자 정보 저장소로 DB 설정 정보를 사용하도록 수정 한다.

 
 <!-- Identity, Session and Assertion Stores configuration -->
 
 <!--
 
 
 
 -->

  • $TOMCAT_HOME/lib/josso-gateway-db-stores.xml 파일에서 DB 정보를 설정 한다.

    • 기존에 있는 id="josso-identity-store" 에 해당하는 것을 삭제하고, 아래 사항을 추가 한다.

    • MySQL에서 password는 예약어이므로 password라는 항목명은 passwd로 변경 하여 테이블을 생성 하였으므로 SQL문도 그에 맞도록 수정 하였다.

 
 

  • $TOMCAT_HOME/lib/josso-gateway-auth.xml 파일에서 기본 인증 정보를 수정한다.

    • hashAlgorithm, hashEncoding를 삭제하여 암호가 Plan Text로 저장되도록 한다.

 
    
 
        
            
        
 
        
            
        
 
    

설치 가이드 - PHP용 Agent


Windows 환경에서 PHP 5.2.5에 JOSSO Agent(SP)를 설치 한다.

 

설치전 사전 준비 사항

  • [Apache HTTP Server 2.2.8 with OpenSSL 0.9.8g](Apache HTTP Server 2.2.8.md) 설치

  • [PHP 5.2.5](PHP 5.2.5.md) 설치

    • PHP에 [GD 확장팩](PHP 5.2.5.md#GD Library 설치.md) 설치

    • PHP에 [GetText 확장팩](PHP 5.2.5.md#IGetText 설치.md) 설치

    • PHP에 [IMAP 확장팩](PHP 5.2.5.md#IMAP 설치.md) 설치

    • PHP에 mysql, mysqli 확장팩 설치

 

PHP용 JOSSO Agent 설치

  • 다운로드 사이트에서 josso-1.8.0.zip를 다운로드 한다.

    • 압축을 풀어 d:/josso 폴더에 복사한다.

    • d:/josso/dist/agents/src/josso-php-agent-1.8.0-.zip의 압축을 풀어 d:/josso_php 폴더에 복사한다.

 

 

  • PHP에 JOSSO Agent를 설정 한다.

 
 mkdir c:/php/includes
 c:/php/includes 아래에 d:/josso_php/josso-php-inc 폴더를 통채로 복사한다.
  • JOSSO Agent 설정 파일은 c:/php/includes/josso-php-inc/josso-cfg.inc 이다.

  • $PHP_HOME에 있는 php.ini 파일에서 다음과 같이 수정 한다.

 
 include_path = ".;c:\php\includes"
 auto_prepend_file = "josso-php-inc\josso.php"

  • 테스트를 위해 d/:/josso/dist/samples/apps/josso-partner-php-1.8.0-.zip 파일의 압축을 풀어 index.php 파일을 Apache HTTP Server의 Document Root에 index_josso.php로 이름을 바꾸어 저장 한다.

 

  • 설치가 완료된 후 d:/josso 폴더와 d:/joss_php 폴더를 삭제하고 Apache HTTP Server를 재기동 한다.

 

PHP용 JOSSO Agent 환경 설정

  • JOSSO Agent 설정 파일(c:/php/includes/josso-php-inc/josso-cfg.inc)에서 다음을 수정 한다.

    • JOSSO Gateway의 IP 또는 URL(예, www.josso.com)을 사용하여 설정한다.

    • josso_endpoint는 JOSSO Gateway의 IP를 사용하여 설정한다.

 
 // Josso agent configuration
 $josso_gatewayLoginUrl = 'http://Gateway_서버_IP_or_URL:8080/josso/signon/login.do';
 $josso_gatewayLogoutUrl = 'http://Gateway_서버_IP_or_URL:8080/josso/signon/logout.do';
 
 // WS client configuration :
 $josso_endpoint = 'http://Gateway_서버_IP:8080';

 

 
 

설치 가이드 - Tomcat용 Agent


Windows 환경에서 Apache Tomcat 6.0.16에 JOSSO Agent(SP)를 설치 한다. 
여기서는 JOSSO Gateway가 설치된 장비에 JOSSO Agent를 설치 한다.

 

설치전 사전 준비 사항

  • [Java SE Development Kit 6 Update 4 (JDK 1.6.0_04-b12)](JDK 6.0.md) 설치

  • [Apache HTTP Server 2.2.8 with OpenSSL 0.9.8g](Apache HTTP Server 2.2.8.md) 설치

  • [Apache Tomcat 6.0.16](Apache Tomcat 6.0.16.md) 설치

    • [Tomcat Connectors 1.1.26](Tomcat Connectors 1.1.26.md)

 

Tomcat용 JOSSO Agent 설치

  • 다운로드 사이트에서 josso-1.8.0.zip를 다운로드 한다.

    • 압축을 풀어 d:/josso 폴더에 복사한다.

 

  • 도스창을 띄워 Apache Tomcat 6.x용 Agent를 설치 한다.

 
 cd d:/josso/bin
 josso-gsh.bat
     agent install --target "$TOMCAT_HOME" --platform tc60
     exit

  • 설치 후 Tomcat이 정상적으로 기동되지 않을 경우 다음과 같이 조치 한다.

    • 새로 생성된 $TOMCAT_HOME/bin/setenv.bat과 setenv.sh를 삭제 한다.

    • Java 환경 변수에 "Djava.security.auth.login.config"을 추가 한다.

      • 화면 우측 하단의 "Apache Tomcat" 아이콘을 오른쪽 마우스로 선택 한다.

      • "Configure..." 메뉴를 선택 한다.

      • "Java" 탭에서 "Java Options"에 "-Djava.security.auth.login.config=%CATALINA_HOME%/conf/jaas.conf"을 추가 한다.

 

  • 기존 설치된 Web Application과 충돌이 발생할 경우 다음과 같이 조치 한다.

    • $TOMCAT_HOME/lib 에 새로 추가된 jar 파일을 기존 Web Application의 lib 파일과 버전을 비교하여 최신 버전을 사용한다.

    • Confluence의 경우, xbean-spring-3.4.3.jar 에서 충돌이 발생하여 Confluence의 Session ID를 가져오지 못한다. (java.lang.NullPointerException)

 

Tomcat용 JOSSO Agent 환경 설정

  • JOSSO Agent 설정 파일($TOMCAT_HOME/lib/josso-agent-config.xml)을 수정 한다.

    • JOSSO Gateway의 IP 또는 URL(예, www.josso.com)을 사용하여 설정한다.

    • josso_endpoint는 JOSSO Gateway의 IP를 사용하여 설정한다.

 
 http://Gateway_서버_IP_or_URL:8080/josso/signon/login.do
 http://Gateway_서버_IP_or_URL:8080/josso/signon/logout.do
 
 
 
 
 

Java Web Application용 Agent


위에서 정리한 Tomcat용 JOSSO Agent는 Tomcat에 설치된 모든 웹 애플리케이션에 적용(Agent는 전체에 적용이 되나 설정에 따라 필요한 프로그램만 SSO 처리가 가능)이 되므로 library 파일 등에서 충돌이 발생할 수 있다. 그러서 여기서는 하나의 Web Application에 Filter 기능을 사용하여 적용이 가능한 자체 개발한 JOSSO Web Application Agent를 소개 한다.

 

Tomcat용 JOSSO Agent을 참조하여 JOSSO Web Application Agent를 제작 하였으므로 관련 library는 Tomcat용 JOSSO Agent에 있는 것을 사용한다.

 
  • JOSSO와 Web Service를 위한 라이브러리 파일 설정

    • /WEB-INF/lib에 josso-ws-1.8.0.jar 파일 복사

 

```
- Agent 적용을 위한 Filter 설정  
  - /WEB-INF/web.xml 파일에 다음을 추가 한다.  
jossoAgent pnus.josso.LoginFilter jossoGatewayLoginUrl http://localhost/josso/signon/login.do jossoGatewayLogoutUrl http://localhost/josso/signon/logout.do jossoEndpoint http://localhost flag_josso true login com.atlassian.seraph.filter.LoginFilter jossoAgent *.action jossoAgent *.jsp ```
  • 실제 JOSSO와 통신하여 SSO 처리를 하는 LoginFilter.java를 컴파일하여 /WEB-INF/classes/pnus/josso/LoginFilter.class 로 복사 한다.

    • [JOSSO Web Application Agent.zip, 2009년 3월 9일 최종 작성](Media:JOSSO Web Application Agent.zip.md)

 

  • Tomcat을 재기동하여 JOSSO Web Service Agent가 정상적으로 동작하는지 확인 한다.

 

사용자 가이드


JOSSO 지원 플랫폼

  • JOSSO 지원 플랫폼

    • Gateway : JOSSO에서 Agent의 요청을 받아 사용자 인증을 처리하는 서비스

    • Agent : 사용자 프로그램이 수행되는 곳에 설치되어 Gateway와 통신하여 인증 처리를 하는 서비스
      ![JOSSO 지원 플랫폼](img/Josso platform.png)

 

PHP에 JOSSO 적용

 

  • JOSSO Agent가 PHP에 제공하는 정보 명세

 
 $josso_agent  : JOSSO Agent
 $ssoSessionId : JOSSO Session ID
 
 $user = $josso_agent.getUserInSession() : 세션에 있는 사용자 정보 반환
 $roles = $josso_agent->findRolesBySSOSessionId($sessionId) : Roles을 반환
 $josso_agent.isUserInRole($rolename) : 해당 Role에 속하는지 여부 반환
 
 $user->getName() : 사용자 명(사용자 아이디)을 반환
 $user->getProperties() : 사용자의 모든 Properties를 반환
 $user->getProperty('user.name') : 사용자의 해당 Property를 반환

  • JOSSO Agent가 PHP에 제공하는 함수 명세

 
 jossoRequestLogin() : 로그인 페이지로 가고 싶을 때 호출
 jossoCreateLoginUrl() : 로그인 URL을 반환
 jossoRequestLoginForUrl($currentUrl) : 로그인 페이지 호출
     로그인 후 인수로 전달된 페이지 호출
 
 jossoRequestLogout() : 로그아웃을 하고 싶을 때 호출
 jossoCreateLogoutUrl() : 로그아웃 URL을 반환
 jossoRequestLogoutForUrl($currentUrl) : 로그아웃 페이지 호출
     로그아웃 후 인수로 전달된 페이지 호출

Java에 JOSSO 적용

 
 

Tomcat용 JOSSO Agent 동작 원리

  • josso-tomcat60-agent-1.8.0.jar에서 다음 함수가 요청을 받아 처리함

    • public void invoke(Request request, Response response)

 
 

관리자 가이드


JOSSO 로그

  • 로그 설정

    • $JOSSO_HOME/WEB-INF/web.xml

 
 action 에서
 
     debug
     5 이 값을 변경하여 로그를 남김
 
 
  • 로그 파일

    • $TOMCAT_HOME/logs/catalina.2009-03-20.log

 
 

Single Sign On 적용 방안

  • '''JOSSO의 SSO 적용 방안'''
    SSO(Single-Sign-On)을 하기 위해서는 자동적으로 세션 정보가 생성되고 관리 되어야 한다. 다음과 같은 규칙을 SSO가 필요한 프로그램에 적용한다.

    • 주의 사항 : 아래 규칙은 프로그램에서 세션 정보를 초기화 시키기 전에 추가 하여야 한다.

    • JOSSO의 SSO 정보가 없을 경우

 
 if (접속 시스템의 세션 정보가 있으면) {
     접속 시스템의 세션 정보를 삭제 한다.
 }
 if (로그인 또는 로그아웃 요청일 경우) {
     분기 화면 정보로 디폴트 페이지를 설정 한다.
 } else {
     분기 화면 정보로 접속하려던 페이지를 설정 한다.
 }
 JOSSO 로그인 화면을 보여 준다.
 JOSSO에 로그인이 되었을 경우 분기 화면을 보여 준다.
 
  • JOSSO의 SSO 정보가 있을 경우

 
 if (로그인 요청일 경우) {
     디폴트 페이지를 호출 한다.
     exit;
 }
 
 if (로그아웃 요청일 경우) [
     접속 시스템의 세션 정보를 삭제 한다.
         반드시 접속 시스템에서 사용하는 세션 정보만 삭제 한다.
         모든 세션 정보를 삭제하면 JOSSO도 비정상 동작 한다.
     분기 화면 정보로 디폴트 페이지를 설정 한다.
     JOSSO에서 로그아웃을 한다.
     JOSSO 로그인 화면을 보여 준다.
     exit
 }
 
 if (접속 시스템의 세션 정보와 JOSSO의 세션 정보가 틀릴 경우) {
     접속 시스템의 세션 정보를 삭제 한다.
 }
 if (접속 시스템의 세션 정보가 없을 경우) {
     접속 시스템의 세션 정보를 생성 한다.
 }
 원래 페이지 코드를 계속 처리 한다.
 
  • 사용자 정보 동기화 방안

    • 사용자 등록, 수정, 삭제, 암호 변경 시 SSO가 필요한 모든 시스템의 사용자 정보의 관리 방안을 수립하여야 한다.

    • 1안. '''각 시스템에서 별도 관리''' (권장 방안)

      • JOSSO에서 사용자 등록, 수정, 삭제, 암호 변경 화면을 제공

      • JOSSO에서 작업 수행 시 SSO가 필요한 모든 시스템의 사용자 정보를 동기화 한다.

      • 권한 설정 등의 부가 작업은 각 시스템에서 진행 한다.

    • 2안. JOSSO에서 통합 관리

      • 각 시스템의 세션에 사용자 정보를 제공하는 것은 JOSSO에서 제공하는 사용자 정보로 대체 한다.

      • 각 시스템에서 사용자 정보를 사용하는 부분을 JOSSO에서 사용자 정보를 읽는 것으로 대체 한다.

     
  • 역할 정보 동기화 방안

    • 역할 및 권한 정보는 각 시스템에서 별도로 관리 한다.

    • JOSSO에서 통합 관리할 경우에는, 각 시스템의 권한 설정을 제거하고 JOSSO에서 권한 설정을 하여야 하므로 아주 복잡하다. JOSSO는 권한 관리를 위한 상세한 기능을 제공하고 있지 않다.

 
 

세션 Timeout 시간 설정

  • $TOMCAT_HOME/webapps/josso/WEB-INF/web.xml에서 세션 Timeout 시간을 분단위로 설정 한다.

 
 
     30
 

로그인 화면 디자인 변경

  • 아래 두개의 파일의 디자인을 변경 한다.

    • $TOMCAT_HOME/webapps/josso/josso_layout.jsp : 화면 레이아웃

    • $TOMCAT_HOME/webapps/josso/signon/usernamePasswordLogin.jsp : 로그인 화면 내용

 
 

JOSSO Gateway의 LDAP 설정

 
 

참고 문헌


 
 

분류: 오픈소스 
SSO

최종 수정일: 2024-09-30 12:26:18

이전글 :
다음글 :