CAS之5.2x版本之Jira单点登录-yellowcong

系统管理员 2022-05-29 10:43 400阅读 0赞

> 将Cas和jira搞一起,他们都是一家公司的产品。将Jira和cas整合在一起，主要有一下几步骤：1、配置web.xml,需要注意的是过滤器和监听器的位置，是得放在指定的地方。2、配置seraph-config.xml ,设定跳转的地址，3、拷贝依赖包到jira目录，需要注意的是，`cas-client-core-3.3.3.jar，cas-client-integration-atlassian-3.3.3.jar` 版本不能错。

## 架构 ##

注意cas的版本和jira的版本，都是比较新的，对于老版本，有可能我的配置不适合，这点请确认。

<table> 
 <thead> 
  <tr> 
   <th>节点</th> 
   <th>服务</th> 
   <th>版本</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><a href="http://192.168.1.99:8443/cas" rel="nofollow">http://192.168.1.99:8443/cas</a></td> 
   <td>cas服务端</td> 
   <td>CAS5.2</td> 
  </tr> 
  <tr> 
   <td><a href="http://192.168.100.10:8080" rel="nofollow">http://192.168.100.10:8080</a></td> 
   <td>jira服务端</td> 
   <td>jira7.2</td> 
  </tr> 
 </tbody> 
</table>

## 配置jira单点登录 ##

### 1、配置web.xml ###

需要配置过滤器和监听器两个配置

vim /opt/atlassian/jira/atlassian-jira/WEB-INF/web.xml

#### a、配置cas的过滤器 ####

<filter>
           <filter-name>CasSingleSignOutFilter</filter-name>
           <filter-class>org.jasig.cas.client.session.SingleSignOutFilter</filter-class>
        </filter>
        <filter>
          <filter-name>CasAuthenticationFilter</filter-name>
          <filter-class>org.jasig.cas.client.authentication.AuthenticationFilter</filter-class>
          <init-param>
            <param-name>casServerLoginUrl</param-name>
            <param-value>http://192.168.1.99:8443/cas/login</param-value>
          </init-param>
          <init-param>
            <param-name>serverName</param-name>
            <param-value>http://192.168.100.10:8080/</param-value>
          </init-param>
        </filter>
        <filter>
            <filter-name>CasValidationFilter</filter-name>
            <filter-class>org.jasig.cas.client.validation.Cas20ProxyReceivingTicketValidationFilter</filter-class>
            <init-param>
                <param-name>casServerUrlPrefix</param-name>
                <param-value>http://192.168.1.99:8443/cas/</param-value>
            </init-param>
            <init-param>
                <param-name>serverName</param-name>
                <param-value>http://192.168.100.10:8080/</param-value>
            </init-param>
            <init-param>
                <param-name>redirectAfterValidation</param-name>
                <param-value>true</param-value>
            </init-param>
        </filter>
        
    
    
    
    
        
        <filter-mapping>
           <filter-name>CasSingleSignOutFilter</filter-name>
           <url-pattern>/*</url-pattern>
        </filter-mapping>
        <filter-mapping>
            <filter-name>CasAuthenticationFilter</filter-name>
            
            
            <url-pattern>/*</url-pattern>
        </filter-mapping>
        <filter-mapping>
            <filter-name>CasValidationFilter</filter-name>
            <url-pattern>/*</url-pattern>
        </filter-mapping>

1、过滤器filter配置说明  
过滤器的数据，必须放`在THIS MUST BE THE LAST FILTER IN THE DEFINED CHAIN`这句话上面或者下面  
![这里写图片描述][70]

2、过滤器mapping配置说明  
mapping必须配置在`login`这个过滤器的上面  
![这里写图片描述][70 1]

#### b、配置监听器 ####

<listener>
        <listener-class>org.jasig.cas.client.session.SingleSignOutHttpSessionListener</listener-class>
    </listener>

1、监听器配置说明

监听器，需要配置到`DO NOT ADD ANY SERVLET CONTEXT LISTENERS`这段话的上面，或者下面。

![这里写图片描述][70 2]

### 2、配置seraph-config.xml ###

需要修改seraph-config.xml，更改授权为cas，同时配置登出和登录的信息。

vim /opt/atlassian/jira/atlassian-jira/WEB-INF/classes/seraph-config.xml

![这里写图片描述][SouthEast]

#### a、配置登录，登出的访问地址 ####

<init-param>
        
        <param-name>login.url</param-name>
        
        
        <param-value>http://192.168.1.99:8443/cas/login?service=${originalurl}</param-value>
    </init-param>
    <init-param>
        
        <param-name>link.login.url</param-name>
        
        
        
        <param-value>http://192.168.1.99:8443/cas/login?service=${originalurl}</param-value>
    </init-param>
    <init-param>
        
        <param-name>logout.url</param-name>
        
        <param-value>http://192.168.1.99:8443/cas/logout</param-value>
        
    </init-param>

![这里写图片描述][SouthEast 1]

### b、注释掉原来的验证方式，使用cas的方式 ###

注释原来已经有的授权，添加cas的授权方式，下面的是jira4.4版本以上的授权配置。

### 3、拷贝cas依赖包 ###

拷贝cas的客户端依赖的jar包（cas-client-core-3.3.3.jar，  
cas-client-integration-atlassian-3.3.3.jar）到，`/opt/atlassian/jira/atlassian-jira/WEB-INF/lib`

#我的cas依赖包下载地址
    http://yellowcong.qiniudn.com/jira+confluence+cas%20client%203.3.3.zip
    
    cas-client-core-3.3.3.jar
    cas-client-integration-atlassian-3.3.3.jar

![这里写图片描述][SouthEast 2]

### 4、重启jira服务 ###

#启动服务
    /opt/atlassian/jira/bin/startup.sh
    
    #关闭服务
    /opt/atlassian/jira/bin/shutdown.sh
    
    #查看日志信息
    tail -f -n 100  /opt/atlassian/jira/logs/catalina.out
    
    # 查看tomcat的信息
    ps -ef|grep tomcat
    
    #查看端口信息
    netstat -ntpl

## 常见问题 ##

### 1、com.atlassian.plugin.osgi.container.OsgiContainerException: Cannot start plugin: com.atlassian.jira.plugins.jira-development-integration-plugin ###

这个问题是语言包的问题，语言包我们可能破解的时候存在问题。  
![这里写图片描述][SouthEast 3]

启动完事后，可以发现，是语言包出现问题了。  
![这里写图片描述][SouthEast 4]

### 2、未认证服务 ###

![这里写图片描述][SouthEast 5]

添加服务到cas上，还需要在application.properties 中，配置`cas.serviceRegistry.initFromJson=true`,让cas可以从json来初始化数据。

![这里写图片描述][SouthEast 6]

{
        "@class": "org.apereo.cas.services.RegexRegisteredService",
        "serviceId" : "^(http|https|imaps)://.*",
        "name": "service-all",
        "id": 1000,
        "description": "allow all service",
        "evaluationOrder": 100,
        "theme":"apereo",
        "attributeReleasePolicy": { "@class": "org.apereo.cas.services.ReturnAllAttributeReleasePolicy" } }

## 参考文章 ##

1、[Integrating JIRA and SSO Using CAS][]

[70]: /images/20220529/81f8ac241c1d4cf19c7fd679b65f8dc4.png
[70 1]: /images/20220529/c91b245edd0f4605b5ea1241c14c0fd5.png
[70 2]: /images/20220529/5e40b67a8488404e98abe0915f93d60c.png
[SouthEast]: /images/20220529/3d2cb6266e7047398fe48d5456b28666.png
[SouthEast 1]: /images/20220529/52db4f1c0cb8461c9ebe0cb4fbd7ceb9.png
[SouthEast 2]: /images/20220529/bd895f676893462da9737465e07b71ba.png
[SouthEast 3]: /images/20220529/a53dcd01c4214e6ebd5e349bfa81ad6f.png
[SouthEast 4]: /images/20220529/d552755ceb964f51be8bf771196924fa.png
[SouthEast 5]: /images/20220529/8ecfe901fbb74ce289ed49542bb52384.png
[SouthEast 6]: /images/20220529/0025b91b5efc41f6b4483ad5fd52f5eb.png
[Integrating JIRA and SSO Using CAS]: https://www.ascendintegrated.com/integrating-jira-sso-using-cas/