Integrating Crowd with Atlassian HipChat
You can connect Hipchat Server to Atlassian Crowd or to a Jira application (version 4.3 or later) for management of users and for authentication (verification of a user's login).
Connecting Hipchat Server to Crowd
You can connect Hipchat Server to Atlassian Crowd for user management and authentication. For more information on Crowd, see the Crowd Administration Guide.
When to use this option: Connect to Crowd if you want to import and synchronize users from and authenticate those users against Crowd.
You can't filter users. When you sync users, you'll sync all users in Atlassian Crowd. (Learn the workaround.) Hipchat Server marks inactive users from Crowd as deactivated users and doesn't count them towards your license.
Crowd does not provide SSO functionality for Hipchat.
A feature request to support SSO is available to be watched and up-voted: HCPUB-304 - Getting issue details... STATUS
To connect Hipchat Server to Crowd:
- Go to your Crowd Administration Console and define the Hipchat Server to Crowd. See the Crowd documentation: Adding an Application.
- Browse to your server's fully qualified domain name, for example https://hipchat.yourcompany.com/.
- Log into the Hipchat Server web user interface (UI) using your administrator email and password.
- Click Group admin > Authentication > External directory.
- Choose Add Directory then choose Atlassian Crowd. Enter the settings as described below.
- Save the directory settings.
- Define the directory order by clicking the blue up and down arrows next to each directory in the User Directories list. Here is a summary of how the directory order affects the processing:
- ディレクトリの順序は、ユーザーおよびグループの検索順序です。
- ユーザーおよびグループへの変更は、アプリケーションが変更権限を持つ最初のディレクトリに対してのみ行われます。
Settings in Hipchat Server for the Crowd directory type
設定 | 説明 |
|---|---|
名前 | ディレクトリ サーバーの一覧でこの Crowd サーバーを識別するのに役立つよう、わかりやすい名前にします。例:
|
サーバー URL | Crowd コンソール サーバーのWeb アドレス。例:
|
アプリケーション名 | ご利用の Crowd サーバーが認識する、アプリケーションの名前。Crowd 管理コンソールを使用して、Crowd でもアプリケーションを定義する必要があります。アプリケーションの追加については、Crowd ドキュメントを参照してください。 |
アプリケーション パスワード | クライアントとして Crowd フレームワークとの認証を行う場合に、アプリケーションが使用するパスワード。これは、Crowd でこのアプリケーションに対して登録したパスワードと同じである必要があります。アプリケーションの追加については、Crowd ドキュメントを参照してください。 |
Crowd 権限
設定 | 説明 |
|---|---|
読み取り専用 | このディレクトリのユーザー、グループおよびメンバーシップは、Crowd から取得され、Crowd を介してのみ変更することができます。アプリケーション管理画面から Crowd ユーザー、グループ、またはメンバーシップを変更することはできません。 Note: There are no user group structures within Hipchat Server. Group data is synchronized, but not used. |
| 読み取り/書き込み | Not applicable to Hipchat Server. |
高度な Crowd 設定
設定 | 説明 |
|---|---|
Enable Nested Groups | Not applicable to Hipchat Server. When you sync your users, you'll sync every user that exists in the directory. |
Synchronization Interval (minutes) | 同期とは、アプリケーションがユーザー データの内部ストアをディレクトリ サーバ上のデータで更新するプロセスです。アプリケーションは x 分ごとにディレクトリ サーバーにリクエストを送信します。x はここで指定する数値です。既定値は60分です。 |
Connecting Hipchat Server to Jira applications
一定の制限はありますが、単一の Jira アプリケーションに複数のアトラシアン アプリケーションを接続して、一元的なユーザー管理を行うことができます。
このオプションを使用すべきタイミング: Jira 4.3 以降、Jira Software 7.0 以降、Jira Core 7.0 以降、または Jira Service Management (旧 Jira Service Desk) 3.0 以降を実行中のサーバーに接続できます。ユーザーの数が限られているシンプルな構成では、Atlassian Crowd の代替として、このオプションを選択します。
You can't filter users. When you sync users, you'll sync all users in the Jira application. Hipchat Server marks inactive users from the Jira application as deactivated users and doesn't count them towards your license.
To connect Hipchat Server to a Jira application:
- Configure the Jira application to recognize Hipchat Server:
- Log in to the Jira application as a user with the 'Jira Administrators' global permission.
- Choose
> User Management > User Server.
Keyboard shortcut: 'g' + 'g' + start typing 'jira user'. - Add an application.
- Enter the application name and password that Hipchat Server will use when accessing the Jira application.
- Enter the IP address or addresses of Hipchat Server.
- Save the new application.
- Configure Hipchat Server to connect to a Jira application:
- Browse to your server's fully qualified domain name, for example https://hipchat.yourcompany.com/.
- Log into the Hipchat Server web user interface (UI) using your administrator email and password.
- Click Group admin > Authentication > External directory.
- Choose Add Directory then choose Atlassian Jira. Enter the settings as described below.
- Enter the settings as described below. When asked for the application name and password, enter the values that you defined in the settings on the Jira application.
- Save the directory settings.
- Define the directory order by clicking the blue up- and down-arrows next to each directory in the User Directories list.
ディレクトリの順序がどういった影響をもたらすかを説明します。
- The order of the directories is the order in which they will be searched for users.
- Changes to users will be made only in the first directory where the application has permission to make changes.
Settings for the Jira directory type
設定 | 説明 |
|---|---|
名前 | ディレクトリ サーバーの一覧でこの Jira サーバーを識別するのに役立つ、わかりやすい名前にします。例:
|
サーバー URL | Jira サーバーの Web アドレス。例:
|
アプリケーション名 | The application name that Hipchat Server will use when accessing the Jira application. |
アプリケーション パスワード | The password that Hipchat Server will use when accessing the Jira server that acts as user manager. |
Permissions for the Jira directory type
設定 | 説明 |
|---|---|
読み取り専用 | The users, groups and memberships in this directory are retrieved from the Jira server that is acting as user manager. They can only be modified via that Jira server.
Note: There are no user group structures within Hipchat Server. Group data is synchronized, but not used. |
Advanced Settings for the Jira directory type
設定 | 説明 |
|---|---|
Enable Nested Groups | Not applicable to Hipchat Server.
|
Synchronization Interval (minutes) | 同期とは、アプリケーションがユーザー データの内部ストアをディレクトリ サーバ上のデータで更新するプロセスです。アプリケーションは x 分ごとにディレクトリ サーバーにリクエストを送信します。x はここで指定する数値です。既定値は60分です。 |
可能な設定の図
Diagram above: Hipchat Server connecting to Crowd for user management.
Diagram above: Hipchat Server connecting to a Jira application for user management. The Jira application does the user management, storing the user data in its internal directory.
Diagram above: Hipchat Server connecting to a Jira application for user management, with the Jira application in turn connecting to an LDAP server.