free for TeamCity Professional and TeamCity Enterprise servers users, closed-source
The plugin adds the ability to log in to TeamCity via JetBrains Hub, and allows for synchronization of user details from Hub to TeamCity: creating/deleting TeamCity users and updating TeamCity user data (username, display name, email, jabber, default VCS usernames, etc.).
The current plugin version is compatible with TeamCity 9.1+ and Hub 1.0.
The plugin requires Java version 1.7+
Download and Installation Instructions
After the server restart, the integration with Hub is managed using the Administration | Hub Settings page.
Enabling / Disabling integration with Hub
On the Administration | Hub Settings page provide the Hub URL of the following format
Сlick Register TeamCity service in Hub.
You will be redirected to the Services page in Hub. Verify the TeamCity Hub service using the Trust button.
After you trust the TeamCity service in Hub, return to the TeamCity Web interface to configure user synchronization.
Synchronizing Users with Hub
Using the Administration | Hub Settings| Synchronization tab of the server settings, you can enable, configure and run on-demand user synchronization.
TeamCity supports one-way synchronization with Hub: the data is retrieved from Hub and is stored in the TeamCity database. Periodically, TeamCity fetches data from Hub and updates users in TeamCity.
Synchronization with Hub in TeamCity allows you to:
- Retrieve the user's profile data from Hub
- Automatically create and remove users in TeamCity based on the information retrieved from Hub
The following options are available:
|Enable users synchronization||Allows importing users and their details from Hub to TeamCity.|
|Update user profiles in TeamCity||The user name, email and VCS usernames in TeamCity will be updated with data from the user profile in Hub on the first synchronization. If any of this data will be later modified in TeamCity, the changed data will not be imported from Hub on the next synchronization.|
|Create user accounts in TeamCity||New users (those existing in Hub but not existing in TeamCity) matched by the users filter will be imported to TeamCity with their login details, emails and VCS usernames. All the imported users will have a Hub ID in TeamCity. |
If a user with the same name exists in TeamCity and Hub, the user is not synchronized until they login to TeamCity via Hub. The existing TeamCity users with no match in Hub will remain intact.
|Delete user accounts from TeamCity|
Clicking Synchronize now launches synchronization manually. After the synchronization is finished, the results will be reported on the page.
After registering of TeamCity service in Hub, TeamCity widgets can be configured on Hub dashboard. But widgets will not work until additional configuration is performed on TeamCity side. Hub Dashboard uses TeamCity REST API to access TeamCity data. But since REST API requests are performed on behalf of the current user and from different host, REST API CORS settings should be configured appropriately. For this two internal properties should be set:
Enabling access to TeamCity from Hub Dashboard
After registering of TeamCity service in Hub, TeamCity widgets can be configured on Hub dashboard. But widgets will not work until additional configuration is performed on TeamCity side.
Hub Dashboard uses TeamCity REST API to access TeamCity data. But since REST API requests are performed on behalf of the current user and from different host, REST API CORS settings should be configured appropriately.
For this two internal properties should be set:
Plugin Development Status
In active development.
Everyone is encouraged to try the plugin, however issues can be uncovered.
If you believe you've faced a bug: Issue Tracker (project: TeamCity)
If you want to ask a question or discuss: Forum
Any of the above, but you do not want it to be publicly accessible: Online Form or Feedback email