Video Guide 

User Guide 

First, login into your OneLogin domain and click Administration.


Next, hoover over DEVELOPERS and click API Credentials.


Then, click New Credential.


Please provide a Name and choose Read users. Click Save to continue.


Please copy & paste the Client Secret and the Client ID to a text editor of your choice.


Now, go to your Atlassian product and navigate to the User & Group Sync settings. Click Create Connector and choose OneLogin.


You can change or add a Name for your OneLogin Connector. Please enter the Client ID and die Client Secret. Please also choose the OneLogin Base URL of your OneLogin account. To make sure that everything is set up correctly, click Save and Test Connection.

Next, please choose what to sync for the groups. You can sync the Groups from member_of (in case you have an external connector integrated into OneLogin), Groups from roles (the OneLogin roles for groups), and you can sync the OneLogin Group from group of a user.

You could also modify the Minimum remaining API calls. In this case, the sync doesn't start if less than the configured amount of calls is available within the hour.

Last but not least you could add a required OneLogin Group "Required OneLogin Groups:". User & Group Sync would only sync users when they are members of the OneLogin Group(s). Using this group-based approach to filtering will speed up your sync significantly.


Don't forget to save "Save and Return" your settings!


You are now ready to commence either a simulated or a full sync. By simulating the sync first you will be able to verify your configuration and see what changes User Sync would apply like what users will be added, modified, or not modified. With the full sync, User Sync will apply those changes. Both sync actions will run a full sync and will have the same sync duration. For more information on the sync simulation please refer to Using the Simulated Sync Feature.

Please read here, if you already have users in your system which you want to migrate, without losing their history. Don't hesitate to reach out to, if you need any help with achieving this. 

Scheduled Synchronization

To take full advantage of User Sync, click on the Sync Settings tab and Enable Scheduled Synchronization.
You can control the sync interval with the modal but also by editing the Cron expression.

Do not forget to save your configuration. Scroll down to the bottom of the page and press Save or Save and Return.

Additional Resources: