JOSSO为Web应用提供了SSO的功能,其中JOSSO Gateway默认提供了统一的登录页面等。
为了统一Web应用的风格,有必要对JOSSO Gateway的登录页面或出错页面进行定制开发,下面介绍详细过程。
对JOSSO Gateway进行定制,需要如下条件:
具体步骤如下:
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 -->
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