기타(framework)

HOME > JAVA > FRAMEWORK > 기타(framework)

2017.08.19 / 13:09

간편한 SSO 솔루션인 JOSSO

디팟

JOSSO 설치 가이드

Windows 환경에서 Apache Tomcat 6.0.16에 JOSSO Gateway(Idp)를 설치 하고, Apache HTTP Server 2.2.8상에서 수행되는 PHP 5.2.5에 JOSSO Agent(SP)를 설치 한다. 사용자 인증을 위해서는 MySQL 5.0.51을 사용한다.

설치전 사전 준비 사항

Java SE Development Kit 6 Update 4 (JDK 1.6.0_04-b12) 설치
MySQL Community Server 5.0.51 설치

MySql Tools for 5.0 설치

Apache HTTP Server 2.2.8 with OpenSSL 0.9.8g 설치 (for Agent)
Apache Tomcat 6.0.16 설치 (for Gateway)

Tomcat Connectors 1.1.26

PHP 5.2.5 설치 (for Agent)

PHP에 GD 확장팩 설치
PHP에 GetText 확장팩 설치
PHP에 IMAP 확장팩 설치
PHP에 mysql, mysqli 확장팩 설치

JOSSO용 Database 설정

MySQL에 JOSSO에서 사용할 Schmea를 등록한다.

MySQL Administrator에 root 관리자로 로그인 한다.
좌측 상단 창에서 "Catalogs"를 선택한다.
좌측 하단의 "Schemata" 창에서 우측 마우스를 누른다.
"Create New Schema" 메뉴를 선택하여 Schema를 생성한다.
Schema 생성화면에서 "Schema name"으로 "jossodb"를 입력한다.

MySQL에 JOSSO에서 사용할 사용자를 등록한다.

좌측 상단 창에서 "User Administration"을 선택한다.
좌측 하단의 "Users Accounts" 창에서 우측 마우스를 누른다.
"Add new user" 메뉴를 선택하여 사용자를 생성한다.
"User Information" 탭에서 "MySQL User"("josso"), "Password", "Confirm Password" 등을 등록한다.

MySQL에 JOSSO에서 사용할 사용자의 권한을 설정한다.

"Schema Privileges" 탭에서 사용자가 사용할 Schema("jossodb")를 선택한다.
"Available Privileges"의 모든 권한을 "Assigned Privileges"로 이동한다.
"Apply changes" 버튼을 눌려 등록된 정보를 저장한다.

MySQL Query Browser에 접속한다.

상단의 "Tools" 메뉴에서 "MySQL Query Browser" 메뉴를 선택한다.

사용자의 MySQL 데이터베이스 접속 정보를 추가한다.

우측의 "Schemata" 탭에서 "mysql"을 더블 클릭하여 선택한다.
grant all privileges on jossodb.* to josso@localhost identified by '암호'; (사용자에게 Schmea에 대한 권한을 추가)
flush privileges; (위 명령을 통해 설정한 권한을 데이터베이스에 반영)
select host, user, password from user order by user, host; (사용자의 접속 정보 확인)

MySQL Query Browser가 아니라 DOS 창에서 접속 정보를 추가하는 방법

mysql -uroot -pxxx mysql
    grant all privileges on jossodb.* 
        to josso@localhost identified by '암호';
    flush privileges;
    select host, user, password from user order by user, host;
    exit

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 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 폴더를 삭제한다.

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 -->
<s:import resource="josso-gateway-db-stores.xml" />
<!--
<s:import resource="josso-gateway-memory-stores.xml" />
<s:import resource="josso-gateway-db-stores.xml" />
<s:import resource="josso-gateway-ldap-stores.xml" />
-->

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

기존에 있는 id="josso-identity-store" 에 해당하는 것을 삭제하고, 아래 사항을 추가 한다.
MySQL에서 password는 예약어이므로 password라는 항목명은 passwd로 변경 하여 테이블을 생성 하였으므로 SQL문도 그에 맞도록 수정 한다.

<db-istore:jdbc-store
    id="josso-identity-store"
    driverName="com.mysql.jdbc.Driver"
    connectionURL="jdbc:mysql://localhost:3306/jossodb"
    connectionName="josso"
    connectionPassword="암호"
    userQueryString="SELECT LOGIN AS NAME FROM JOSSO_USER WHERE LOGIN = ?"
    rolesQueryString="SELECT NAME AS ROLE 
                        FROM JOSSO_USER_ROLE WHERE LOGIN = ?"
    credentialsQueryString="SELECT LOGIN AS USERNAME, PASSWD password 
                              FROM JOSSO_USER WHERE LOGIN = ?"
    userPropertiesQueryString="SELECT NAME, VALUE 
        FROM JOSSO_USER_PROPERTY WHERE LOGIN = ?"
    resetCredentialDml="UPDATE JOSSO_USER SET PASSWD = ? WHERE LOGIN = ?"
    relayCredentialQueryString="SELECT LOGIN FROM JOSSO_USER WHERE #?# = ?"
    />

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

hashAlgorithm, hashEncoding를 삭제하여 암호가 Plan Text로 저장되도록 한다. (현재는 테스트용으로, 향후에는 이를 사용하여 암호가 암호화되어 저장되도록 하여야 한다.)

   <basic-authscheme:basic-auth-scheme
           id="josso-basic-authentication"
           ignorePasswordCase="false"
           ignoreUserCase="false">

       <basic-authscheme:credentialStore>
           <s:ref bean="josso-identity-store"/>
       </basic-authscheme:credentialStore>

       <basic-authscheme:credentialStoreKeyAdapter>
           <s:ref bean="josso-simple-key-adapter"/>
       </basic-authscheme:credentialStoreKeyAdapter>

   </basic-authscheme:basic-auth-scheme>

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 폴더에 복사한다.

Apache HTTP Server의 Document_root 아래에 d:/josso_php/josso-php-partnerapp 폴더를 통채로 복사한다.

http://localhost/josso-php-partnerapp/josso-security-check.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://gatewayURLorIP:8080/josso/signon/login.do';
$josso_gatewayLogoutUrl = 'http://gatewayURLorIP:8080/josso/signon/logout.do';

// WS client configuration :
$josso_endpoint = 'http://gatewayIP:8080';

JOSSO 설정 확인

http://localhost/josso-php-partnerapp/index_josso.php 사이트에서 로그인하여 화면이 제대로 뜨는지 확인 한다.

테스트가 끝나면 Document Root에 있는 index_josso.php 파일을 삭제 한다.

이제 JOSSO Gateway와 Agent의 설치가 완료 되었다. JOSSO Agent 중에서 PHP용 Agent가 사용자 프로그램(PHP)에 제공하는 정보(변수)와 기능(함수)를 살펴 보자.

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) : 로그아웃 페이지 호출
    로그아웃 후 인수로 전달된 페이지 호출

*** 참고 문헌 ***

오픈소스 비즈니스 컨설팅 - JOSSO

< Prev MP4 동영상 업로드 자동 스크린샷 파일 썸네일 생성 라이브러리

JOSSO 참고자료 - 파일 다운로드 Next >

♥