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/lib
in 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'
Next Step
To give the imported groups access to the Jira application, see Specifying which Groups can access an Application.
RELATED TOPICS
- 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
- Configuring directories for failover authentication