定制JOSSO 1.8.10 Gateway登录页面及与WildFly AS 10的集成

JOSSO为Web应用提供了SSO的功能，其中JOSSO Gateway默认提供了统一的登录页面等。

为了统一Web应用的风格，有必要对JOSSO Gateway的登录页面或出错页面进行定制开发，下面介绍详细过程。

对JOSSO Gateway进行定制，需要如下条件：

• JDK 1.8
• Maven 3
• WildFly AS 10
• JOSSO 1.8.10

具体步骤如下：

1.打开Windows命令行窗口，执行如下命令生成JOSSO项目

mvn archetype:generate -DinteractiveMode=false -DarchetypeRepository=http://repository.josso.org/ -DarchetypeGroupId=org.josso -DarchetypeArtifactId=josso-archetype-gateway -DarchetypeVersion=1.8.10 -DgroupId=com.viavi -DartifactId=my-gateway -Dversion=0.0.1-SNAPSHOT -DremoteRepositories=http://repository.josso.org

说明：

archetypeRepository=http://repository.josso.org/给出JOSSO项目的发布URL

archetypeGroupId=org.josso给出JOSSO项目的路径

archetypeArtifactId=josso-archetype-gateway给出JOSSO项目的标识

上述命令执行成功，在当前目录下生成my-gateway目录，其中包含了JOSSO Gateway的全部代码。

2.替换logo图片

修改my-gateway\src\main\webapp\resources\img\content\josso-logo.png


3.修改页面my-gateway\src\main\webapp\josso-layout.jsp

        <h1> <!-- Logo JOSSO-->
            <a href="http://www.josso.org" title="Click here to go to the homepage">
                <img src="<%=request.getContextPath()%>/resources/img/content/josso-logo.png" alt="Java Open Single SignOn" width="372" height="48"/>
            </a>
        </h1> <!-- /Logo JOSSO -->

必要的情况下，还可以修改具体的登录页面my-gateway\src\main\webapp\signon\usernamePasswordLogin.jsp

4.Maven编译修改后的项目，Windows命令行窗口，执行如下命令
mvn install


5.将修改后的JOSSO Gateway部署到WildFly AS 10服务器

打开JOSSO命令行客户端
cd C:\XiangbinHan\software\josso-1.8.10\bin

C:\XiangbinHan\software\josso-1.8.10\bin>josso-gsh.bat

在JOSSO命令行客户端，执行如下命令
gateway install --target C:/XiangbinHan/software/wildfly-10.0.0.CR2-bin/standalone/deployments --platform jee --copy-configuration false --source mvn:com.viavi/my-gateway/0.0.1-SNAPSHOT/war

该命令执行完毕，将向WildFly AS 10服务器的部署目录部署josso-gateway-web-.war文件，这就是定制后的JOSSO Gateway。

6.打开浏览器，访问JOSSO Gateway的登录界面即可。

参考文献：

http://www.josso.org/confluence/display/JOSSO1/Branding+JOSSO