1. 程式人生 > >Docker 建立 Crowd3.3.2 以及打通 Jira Software7.12.3和Confluence6.12.2 SSO 單點登入

Docker 建立 Crowd3.3.2 以及打通 Jira Software7.12.3和Confluence6.12.2 SSO 單點登入

目錄

目錄

1、介紹

1.1、什麼是Crowd?

  以下是來自官網的介紹:
  能夠管理來自多個目錄(Active Directory、LDAP、OpenLDAP 或 Microsoft Azure AD)的使用者,並在一個位置控制應用身份驗證許可權。
  

  • 單點登入 (SSO)
      為使用者提供一組使用者名稱和密碼來登入需要訪問的所有應用,讓他們的生活更加輕鬆。無縫整合 JiraConfluence
    和 Bitbucket 等所有 Atlassian 產品,為您的使用者提供單點登入 (SSO) 體驗。
      
  • 集中多個目錄
      將任意目錄組合對映到單個應用(非常適用於管理不在主目錄中的使用者),然後在同一位置管理身份驗證許可權。開始使用適用於 AD、LDAP、Microsoft Azure AD、Novell eDirectory 等的聯結器。您甚至可以建立自己的自定義聯結器。   

    不建議大家在公司使用破解版。

2、Crowd 的官網在哪裡?

  https://www.atlassian.com/
    

3、如何下載安裝?

  我將 Crowd 3.3.2 直接封裝到了 Docker 映象中,如何安裝Docker,請參考這篇文章<Centos7的安裝、Docker1.12.3的安裝,以及Docker Swarm叢集的簡單例項>
    
  以下例項中安裝 Crowd 3.3.2 ,需要用到 MySQL 5.7,如果你已經安裝完Docker,可以下載已經做好的 <docker-compose.yml>。檔案內容如下,請注意修改/srv/your_folder/my.ini的位置為你下載後的檔案位置:

version: '3'
# https://docs.docker.com/compose/compose-file/
# support Docker version 17.05.0-ce
services:

#################################### crowd ######################################################

##############################
# jira_crowd_mysql
##############################
  jira_crowd_mysql:
    image: "idoall/mysql:5.7"
    hostname: jira_crowd_mysql
    ports:
     - "6033:3306"
    volumes:
      - /srv/your_folder/my.ini:/etc/mysql/my.cnf
    networks:
      - crowd
    environment:
      - MYSQL_ROOT_PASSWORD=123456
      - MYSQL_DATABASE=crowd
      - MYSQL_USER=crowd
      - MYSQL_PASSWORD=crowd_mshk
      - character-set-server=utf8mb4
      - collation-server=utf8mb4_bin
    deploy:
      replicas: 1
      update_config:
        delay: 1s
      restart_policy:
        condition: on-failure
##############################
# jira_crowd
##############################
  jira_crowd:
    image: "idoall/ubuntu16.04-jira-crowd:3.3.2"
    hostname: jira_crowd
    ports:
     - "80:8095"
    networks:
      - crowd
    depends_on:
     - jira_crowd_mysql
    deploy:
      replicas: 1
      update_config:
        delay: 1s
      restart_policy:
        condition: on-failure

# 統一網路設定
networks:
  crowd:
    driver: overlay

     
  我們執行以下命令,使用 Docker Stack 的編排服務,來建立 Crowd 3.3.2 以及 MySQL 5.7 服務:

$ docker stack deploy -c docker-compose.yml mshk_crowd
Creating network mshk_crowd_crowd
Creating service mshk_crowd_jira_crowd
Creating service mshk_crowd_jira_crowd_mysql

  
  啟動成功後,使用下面的命令,可以看到 Crowd 3.3.2MySQL 5.7 的服務執行狀態:

$ docker service ls
ID                  NAME                          MODE                REPLICAS            IMAGE                                 PORTS
hgijdmnrwobl        mshk_crowd_jira_crowd         replicated          1/1                 idoall/ubuntu16.04-jira-crowd:3.3.2   *:80->8095/tcp
8jqw32rdaoh6        mshk_crowd_jira_crowd_mysql   replicated          1/1                 idoall/mysql:5.7                      *:6033->3306/tcp

  
  再等幾分鐘以後,在<docker-compose.yml>檔案中,可以看到,我們對 Crowd 做了80->8095埠的對映,所以開啟:http://localhost ,能夠看到如下頁面,說明執行成功:

這時的等待是因為 Crowd的服務需要啟動, MySQL 5.7 的資料庫需要建立。

  

4、對 Crowd 進行配置

4.1、破解 Crowd 第一步

  Crowd 3.3.2 的破解檔案已經打包到了 Docker 中。
  先用 docker ps 命令,檢視服務生成的容器名稱,本文測試時生成的容器名稱是 mshk_crowd_jira_crowd.1.vvl9un0ubbyos0so8xoms1r81

CONTAINER ID        IMAGE                                 COMMAND                  CREATED             STATUS              PORTS                     NAMES
f41c14a845ec        idoall/ubuntu16.04-jira-crowd:3.3.2   "/bin/bash -e /init/…"   37 minutes ago      Up 37 minutes       8095/tcp                  mshk_crowd_jira_crowd.1.vvl9un0ubbyos0so8xoms1r81
5adfee0cc8d8        idoall/mysql:5.7                      "docker-entrypoint.s…"   About an hour ago   Up About an hour    3306/tcp                  mshk_crowd_jira_crowd_mysql.1.9z947zyvdxiswwt93drk6wxh6

  Docker 編排服務後的容器名稱比較長,把容器名稱賦值到一個變數CONTAINERNAME ,這樣後面使用起來會很方便。
  將要破解的檔案、破解工具從容器中複製到本地,並將要破解的檔案atlassian-extras-3.2.jar重新命名為atlassian-extras-2.6.jar

CONTAINERNAME=`docker ps --format "{{.Names}}" | grep mshk_crowd_jira_crowd.1`
docker cp $CONTAINERNAME:/home/work/_app/_jira_crowd/crowd-webapp/WEB-INF/lib/atlassian-extras-3.2.jar ./atlassian-extras-2.6.jar
docker cp $CONTAINERNAME:/usr/src/_crowd/crowd_keygen.jar .

  在當前目錄,執行以下命令,開啟破解檔案,在彈出的破解檔案視窗中,點選.patch!,找到剛才從容器中複製出來的atlassian-extras-2.6.jar檔案。破解成功後,在破解工具的左下方,會提示jar successfully patched這時不要著急關閉破解檔案的視窗,後面還會用到。 

$ java -jar crowd_keygen.jar

  停止 Crowd 容器執行的服務;同時將 Crowd 容器的原檔案 atlassian-extras-3.2.jar 重新命名為atlassian-extras-3.2.jar.bak做備份;再將我們破解後的atlassian-extras-2.6.jar檔案,複製到容器中重新命名為atlassian-extras-3.2.jar ;啟動容器;下面是本次操作的命令:

$ docker exec $CONTAINERNAME sh -c '/home/work/_app/_jira_crowd/stop_crowd.sh;mv /home/work/_app/_jira_crowd/crowd-webapp/WEB-INF/lib/atlassian-extras-3.2.jar /home/work/_app/_jira_crowd/crowd-webapp/WEB-INF/lib/atlassian-extras-3.2.jar.bak'
$ docker cp atlassian-extras-2.6.jar $CONTAINERNAME:/home/work/_app/_jira_crowd/crowd-webapp/WEB-INF/lib/atlassian-extras-3.2.jar 
$ docker exec $CONTAINERNAME sh -c '/home/work/_app/_jira_crowd/start_crowd.sh'

  
  這時在瀏覽器,輸入 http://localhost,開啟 Crowd ,能夠開啟以介面,說明破解的第一步成功。
  

  

4.2、破解 Crowd 第二步,獲取授權許可

  點選 Set up Crowd,在獲取授權碼時,回到我們剛才開啟的破解檔案視窗,輸入NameEmailOrganizationServer ID,點選.gen!,生成授權碼,並將授權碼複製到頁面中,點選Continue

  

4.2、Crowd 的安裝 Crowd installation

    
  如圖中選擇New installation 新的安裝,然後點選Continue
  
  

4.3、資料庫配置 Database configuration

  
  選擇 JDBC connection,然後 Database 選擇 MySQL,將 JDBC URL 的內容更改為 jdbc:mysql://jira_crowd_mysql/crowd?autoReconnect=true&characterEncoding=utf8&useUnicode=true,Username輸入crowd,Password輸入crowd_mshk,最後點選Continue

這裡輸入的資料庫引數,是我們在<docker-compose.yml>中配置的主機名 jira_crowd_mysql ,資料庫名稱 crowd ,使用者名稱 crowd ,密碼 crowd_mshk

4.4、Crowd 選項 Options

  這裡可以設定 Crowd 的標題,會話超時的時間Session timeout單位是分鐘,以及Base URL,點選Continue

4.5、內部目錄設定 Internal directory

  這裡可以做一些基礎的設定,比如密碼的正則,無效登入的嘗試次數等,我們不做太多演示,直接點選Continue

4.6、設定預設管理員帳號 Default administrator

  輸入Email addressUsernamePasswordConfirm passwordFirst nameLast name,點選Continue

4.7、綜合應用 Integrated applications

  什麼也不操作,點選Continue

4.8、檢視破解後的授權資訊

  用剛才設定的管理員帳號登入以後,點選右上角的齒輪,選擇Licensing,能夠看到破解日期已經延長到了2337年。

4.9、建立應用程式目錄

  點選上方的Directory->Add directory,選擇Internal,點選Next,在Name處輸入apps,點選Continue,建立成功後的效果如下圖。

  

4.10、新增使用者組 Group

  點選Groups->Add roup,如下圖,分別新增confluence-administratorsconfluence-usersjira-administratorsjira-software-usersjira-software-developers 使用者組,Directory選擇我們剛才建立的apps,點選 Create

  
新增後的結果如下圖:

  

4.11、從 JIRA 中匯入使用者

如果之前沒有設定過 JIRAConfluence 統一使用 JIRA 的帳號登入,或者兩套程式中沒有使用者,可以忽略此步驟。

  第一步點選上方的 Users,左側點選 Import users,右側選擇Atlassian importer,然後點選 Next
  第二步,在 Atlassian product required 選擇 JIRA ,在 Directory 選擇 apps, 在 Product database URL 輸入 JIRA 的資料庫連線地址 jdbc:mysql://jira_mysql/jira?autoReconnect=trueUsername 輸入使用者名稱 jiraPassword 輸入 jira_mshk,點選 Continue

為什麼這樣設定的 JIRA 資料庫資訊,請參考 Docker 建立 Jira Core/SoftWare 7.12.3 中文版

  操作成功後,可以看到提示從 JIRA 匯入多少個使用者。

  

4.12、新增 JIRA 和 Confluence 應用程式

  點選 Applications->Add application,在 Application type 選擇 JIRA,輸入 NameJIRADescriptionJIRA Application,再設定密碼123456,點選Next.

  
  在URL輸入設定的JIRA URL地址,點選 Resolve IP address,會自動解析出 Remote IP address
  選擇剛才建立的apps目錄,點選Next
  在Directory groups中選擇jira-software-users,點選Add Group,將使用者新增到授權組Authorised groups,同樣操作將jira-administrators也新增到授權組,點選Next。(也可以勾選Allow all users to authenticate,允許目錄中所有的使用者訪問)
  最後點選Add Application,新應用新增成功。

  
  Confluence 的新增方式同上,只是在選擇使用者組的時候,新增confluence-administratorsconfluence-users,如下圖,其他步驟沒有變化:

  
  最終 Jira SoftwareConfluence 應用程式新增後的效果如下圖:

  
  做完上面的步驟,Crowd 的配置基本結束。
  

5、設定 Confluence 使用 Crowd 認證

5.1、設定 Crowd 的使用者目錄

  第一步:使用管理員帳號登入到 Confluence 後臺,左側點選 使用者目錄 在彈出的視窗中選擇 Atlassian 人群 ,點選 下一步
  第二步:在 應用程式名稱 處輸入剛才設定的 Confluence應用程式名稱 confluence,在應用程式密碼輸入剛才我們設定的密碼123456,點選 測試設定,能夠看到如下圖中有綠色的提示框,提示 連線測試成功,最後點 測試並儲存
  第三步:在 使用者目錄,可以看到,我們剛新增的 Crowd Server 目錄。

  
  調整 Crowd Server 目錄的順序到第一行,調整後的順序如下:

  

5.2、啟用 Confluence 與 Crowd 的 SSO 整合

  修改 Confluence 容器中的檔案 /opt/atlassian/confluence/confluence/WEB-INF/classes/crowd.properties,修改前的格式如下:

application.name                        username
application.password                    password
application.login.url                   http://localhost:8095/crowd/console/

crowd.server.url                        http://localhost:8095/crowd/services/
crowd.base.url                          http://localhost:8095/crowd/

session.isauthenticated                 session.isauthenticated
session.tokenkey                        session.tokenkey
session.validationinterval              2
session.lastvalidation                  session.lastvalidation

  
  將 crowd.properties 檔案中的內容改為我們之前配置的應用程式內容( 參考 本文的4.12章節), application.name修改為confluenceapplication.password修改為123456,修改後的內容如下:

application.name                        confluence
application.password                    123456
application.login.url                   http://localhost:8095/crowd/console/

crowd.server.url                        http://localhost:8095/crowd/services/
crowd.base.url                          http://localhost:8095/crowd/

session.isauthenticated                 session.isauthenticated
session.tokenkey                        session.tokenkey
session.validationinterval              2
session.lastvalidation                  session.lastvalidation
cookie.tokenkey                         crowd.token_key

  
  設定 Confluence 的驗證授權為 Crowd,修改 /opt/atlassian/confluence/confluence/WEB-INF/classes/seraph-config.xml 檔案,將 <authenticator class="com.atlassian.confluence.user.ConfluenceAuthenticator"/> 註釋,將 <!-- <authenticator class="com.atlassian.confluence.user.ConfluenceCrowdSSOAuthenticator"/> --> 取消註釋,修改後的內容如下:

<!-- Default Confluence authenticator, which uses the configured user management for authentication. -->
<!-- <authenticator class="com.atlassian.confluence.user.ConfluenceAuthenticator"/> -->

<!-- Custom authenticators appear below. To enable one of them, comment out the default authenticator above and uncomment the one below. -->

<!-- Authenticator with support for Crowd single-sign on (SSO). -->
<authenticator class="com.atlassian.confluence.user.ConfluenceCrowdSSOAuthenticator"/>

<!-- Specialised version of the default authenticator which adds authenticated users to confluence-users if they aren't already a member. -->
<!-- <authenticator class="com.atlassian.confluence.user.ConfluenceGroupJoiningAuthenticator"/> -->

  
  在管理後臺的站點管理->使用者&安全->安全配置中勾選上外部使用者管理。通過以上步驟,就完成了 Confluence 使用 Crowd 認證.
  通過以下命令,重啟 Confluence 容器內的服務,使用在 Crowd 中配置的使用者登入,就可以測試效果了。

$ CONTAINERNAME=`docker ps --format "{{.Names}}" | grep mshk_confluence_confluence.1`
$ docker exec $CONTAINERNAME sh -c 'service confluence restart'

  

6、設定 Jira Software 使用 Crowd 認證

6.1、設定 Crowd 的使用者目錄

  使用管理員帳號登入以後,右上角齒輪,選擇使用者管理->左側選擇使用者目錄,點選新增目錄,在彈出的視窗中選擇Atlassian 人群,點選下一步

  
  後面的步驟,同 5.1章節 一樣,只是在 應用程式名稱 處輸入剛才設定的 JIRA應用程式名稱 jira,在應用程式密碼輸入剛才我們設定的密碼123456,點選 測試設定,能夠看到如下圖中有綠色的提示框,提示 連線測試成功,最後點 測試並儲存
  新增後,將 Crowd Server 的順序調整到第一行,調整後的效果如下圖:

  

6.2、啟用 JIRA 與 Crowd 的 SSO 整合

  新增 JIRA 容器中的檔案 /opt/atlassian/jira/atlassian-jira/WEB-INF/classes/crowd.properties,內容如下:

application.name                        jira
application.password                    123456
application.login.url                   http://localhost:8095/crowd/console/

crowd.server.url                        http://localhost:8095/crowd/services/
crowd.base.url                          http://localhost:8095/crowd/

session.isauthenticated                 session.isauthenticated
session.tokenkey                        session.tokenkey
session.validationinterval              2
session.lastvalidation                  session.lastvalidation
cookie.tokenkey                         crowd.token_key

在這個版本中 /opt/atlassian/jira/atlassian-jira/WEB-INF/classes/crowd.propertie檔案是不存在的,所以我們需要建立

  
  設定 JIRA 的驗證授權為 Crowd,修改 /opt/atlassian/jira/atlassian-jira/WEB-INF/classes/seraph-config.xml 檔案,將 <authenticator class="com.atlassian.jira.security.login.JiraSeraphAuthenticator"/> 註釋,將 <authenticator class="com.atlassian.jira.security.login.SSOSeraphAuthenticator"/> 取消註釋,修改後的內容如下:

<!-- CROWD:START - If enabling Crowd SSO integration uncomment the following SSOSeraphAuthenticator and comment out the JiraSeraphAuthenticator below -->
<authenticator class="com.atlassian.jira.security.login.SSOSeraphAuthenticator"/>

<!-- CROWD:END -->

<!-- CROWD:START - The authenticator below here will need to be commented out for Crowd SSO integration -->
<!-- <authenticator class="com.atlassian.jira.security.login.JiraSeraphAuthenticator"/> -->
<!-- CROWD:END -->

<!-- NB: the URL to redirect to is now specified by login.url above -->

  
  通過以下命令,重啟 JIRA 容器內的服務,使用在 Crowd 中配置的使用者登入,就可以測試效果了。

$ CONTAINERNAME=`docker ps --format "{{.Names}}" | grep mshk_crowd_jira_crowd.1`
$ docker exec $CONTAINERNAME sh -c 'service jira stop;service jira start'

  

7、相關文章

7.1、 Crowd Adding an Application


博文作者:迦壹
部落格地址:Docker 建立 Crowd3.3.2 以及打通 Jira Software7.12.3和Confluence6.12.2 SSO 單點登入
轉載宣告:可以轉載, 但必須以超連結形式標明文章原始出處和作者資訊及版權宣告,謝謝合作!

比特幣地址:1KdgydfKMcFVpicj5w4vyn3T88dwjBst6Y
以太坊地址:0xbB0a92d634D7b9Ac69079ed0e521CC2e0a97c420