- Home
- SCIM Provisioning
- SCIM Provisioning Documentation
- Effortless User and Group Sync for miniOrange
Effortless User and Group Sync for miniOrange
The User & Group Sync app syncs user and group information from miniOrange to Jira, Confluence, and Bitbucket. Syncing user group attributes will sync user details such as groups, users, and directories. Sync can be performed manually or scheduled to run after set time intervals. By doing so, the administrator only has to manage user accounts in miniOrange. As a result, Atlassian modules such as Jira, Confluence, and Bitbucket require less admin time to create users and groups.
Try it for freeDownload and Installation
- Log into your atlassian instance as admin.
- Navigate to the settings menu and Click Manage Apps.
- Click on Find new apps .
- Locate miniOrange User and Group Sync app.
- Click Try free to begin a new trial or Buy now to purchase a license.
- Enter your information and click Generate license when redirected to MyAtlassian.
- Click Apply license.
Step 1: Get SCIM Client Details
- Open the Miniorange Admin Console and log in.
- From the sidebar, select the "Apps" tab.
- Clicking on the “Add Application” button, pick SCIM Server (Destination) Application after searching for SCIM.
-
Configure the application by providing the following required details:
- Application Name
- Base URL
- Bearer Token - Click "Test Connection" once the information has been entered. A success popup should appear if the connection was successful.
- Make sure you toggle on all the provisioning toggles when performing SCIM operations.
- “Save” the application.
- Then navigate to the Policies >> App Login Policy from the sidebar.
-
Here, you should enter the following information into the Add App Authentication policy:
- Configured Application Name
- Group Name (by default, choose "Default" Group)
- Policy Name
- Login Method
- If needed enable Multi-Factoring options provided.
- And click on “Save”. - Determining a successful SCIM connection by testing the addition or removal of users or groups from miniOrange and seeing if it also affects Jira.
Step 2: Setup User Sync & Group Sync app
- Open your "Jira Admin Console" and log in.
- Navigate to the “Manage Apps” Section from the settings in the top right corner.
- Under the “Find New Apps” Section search for SCIM, and install “SCIM Provisioning, User Sync & Group Sync for Jira.”
- You will find the “miniOrange User Sync/SCIM” tab on the sidebar, move into it.
- Click "Add New App" under Configuration, then choose miniOrange as your provider.
- Configure your SCIM application by providing the “App Name” and save the application.
- Use “SCIM Base URL” and “Bearer Token” to configure your miniOrnage Application.
- Now you established a valid connection with your miniOrange provider.
Step 3: LDAP Sync Settings
- The miniOrange user sync app now provides support for LDAP Sync. Follow the instructions to configure the LDAP directory. By configuring the LDAP directory, you can synchronize all attributes from your LDAP directory and choose the attributes you wish to include in Jira.
- Once you have successfully configured the LDAP directory in Jira/Confluence, you can test the specific user’s attributes by using the Test Sync button.
- To test your configuration, enter an username(sAMAccountName) from your directory's user data and click on the Search User button. You will then be able to view the details of the searched user.
Step 4: User Sync Settings
- Select the User Sync Settings tab from the left sidebar. Here you can configure different settings about user creation and updation.
- You can select the directory, enable or disable user import, update process.
- The user can be automatically enabled or disabled here based on IDP configuration.
- You also have an option to set Default Project Lead and Default Component Lead.
- Attribute mapping enables you to map your attributes sourced from the IDP to Jira attributes. Through this section you can map your jira attributes to the attributes coming from IDP. By default, username attribute corresponds to the username/userPrincipalName attribute, email corresponds to the email/mail attribute, and displayName corresponds to the full name attribute. However, if you want to map these jira attributes with other attributes coming from IDP, you can use this feature to change the attribute mapping configurations.
- User sync also supports mapping of custom attributes. Here, you can create custom attributes and automatically assign values to them from the IDP (Identity Provider). Select the desired attributes from the IDP that you want to display in Jira and provide a name for the custom attributes to be shown in Jira.
- Custom fields will be displayed in the user profile section as shown below
Step 5: Group Sync Settings
- Select the Group Sync Settings tab from the left sidebar. Here you can configure different settings about group creation and group mapping.
- Here you can configure Default groups for new and all users.
- You can set Manual Group Mapping or On-The Fly Group Mapping.
- Here users will be assigned to groups in Jira whose group name is the same as groups from IDP. If the group doesn't exist in Jira then it will be created.
- You can configure to keep the existing user groups, filter groups and apply regular expressions on the groups.
- Here you can manually map Jira groups with the groups from IDP.
- You can also configure to import IDP groups, filter groups and whether to keep existing users or not.
1. On-The Fly Group Mapping -
2. Manual Group Mapping -
Step 6: Multiple IDPs
- The plugin allows for configuring SCIM provisioning on your SP (Service Provider) to accommodate your specific use case. To add another IDP, simply navigate to the "Configured IDPs" section. Select on Add new App to configure multiple provisioning connections.
Did this page help you?
