Importing Users from Atlassian JIRA
If you have already been using Atlassian JIRA, and are now configuring JIRA as a Crowd application, you will probably want to import your existing JIRA users and groups into a Crowd directory.
It is recommended that you import your JIRA users into an Internal Directory that has its 'Password Encryption' set to 'ATLASSIAN-SECURITY'. Otherwise, users' passwords will not be copied across to Crowd.
To import users and groups from Atlassian JIRA into a Crowd directory,
- Ensure that the database drivers for the JIRA database are on Crowd's classpath. To do this, simply copy the JDBC driver jar for your particular JIRA database across to
apache-tomcat/common/libin your Crowd installation directory. Then restart Crowd.
- Log in to the Crowd Administration Console.
- Click the 'Users' link in the top navigation bar.
- This will display the User Browser. Click the 'Import Users' link.
- This will display the 'Import Type' screen. Click the 'Atlassian Importer' button.
- This will display the 'Options' screen. Complete the fields as follows:
- 'Atlassian Product' — Select 'JIRA'.
- 'Directory' — Select the directory that you have created for your JIRA users.
- 'Import Passwords' — Select this checkbox if you wish to import the users' passwords from JIRA. You can only import passwords if the Crowd directory is using the 'Atlassian SHA1' encryption method.
- 'Product Database URL' — Type the URL of your JIRA instance's database. The exact syntax will depend on which database you are using; see Connecting JIRA to a Database in the JIRA Installation Guide.
- 'Database Driver' — Type the name of your JIRA instance's database JDBC driver, e.g.
For MySQL, type com.mysql.jdbc.Driver
For PostgreSQL type org.postgresql.Driver
- For Oracle type oracle.jdbc.OracleDriver
- For MS SQL Server type net.sourceforge.jtds.jdbc.Driver
- For HSQLDB type org.hsqldb.jdbcDriver
- 'Username' — Type the username of the database user that Crowd will use to log in to your JIRA instance's database.
- 'Password' — Type the password of the database user Crowd will use to log in to your JIRA instance's database.
The import process will log in to the database, not into JIRA.
- Click the 'Continue' button to import the users from your JIRA instance into your Crowd directory.
- The 'Results' screen will be displayed, showing how many users and groups have been imported into your Crowd directory.
- Click the 'Users' button to view and manage the imported users and groups via the Crowd Administration Console (assuming the directory's permissions allow this).
Screenshot: 'Import JIRA Users'
- Using the Directory Browser
- Adding a Directory
- Configuring Caching for an LDAP Directory
- Using Naive DN Matching
- Specifying Directory Permissions
- Importing Users and Groups into a Directory
- Importing Users from Atlassian Confluence
- Importing Users from Atlassian JIRA
- Importing Users from Atlassian Bamboo
- Importing Users from Jive Forums
- Importing Users from CSV Files
- Importing Users from One Crowd Directory into Another
- Configuring directories for failover authentication