Skip to main content
Part of Lumos Launchpad: Foundation, step 6.

Background

Lumos continually syncs with your integrated apps to keep data about your users, apps, and accounts up to date. Lumos runs syncs automatically every day, and you can also trigger ad hoc syncs from several places in the platform. This article describes both.

What is syncing in my environment?

Every integration connected on the Integrations page syncs automatically once a day.

Where can I trigger ad hoc syncs?

If you want to trigger a sync for a particular app (e.g. direct Lumos integration)

Click the connected integration. Next to the “Reconnect” button, you’ll see the option to trigger a sync. Typically, for most integrations, this will be “Sync <app\_name> Users”. The “Sync Users” scan runs automatically once per day for all of your integrations.
Zoom integration's Reconnect menu with Sync Zoom Users

If you want to trigger a sync for your IdP (or delegated integration)

Your identity provider (IdP), such as Okta or Google Workspace, is often also a delegated integration: a direct integration that lets Lumos read and manage other apps that Lumos doesn’t integrate with directly. Sync your IdP when you want to make sure your manager/team/title information is reflecting properly, or that the apps from your delegated integration have populated. Click that app in the Integrations tab, and select the app you want to sync (Okta, OneLogin, O365, Atlassian, Google Cloud, Google Workspace). Beyond the option to “Sync <app\_name> Users”, you see a few more options. “Sync <app\_name> Groups” will do a pull of all the groups from your IdP. The “Sync Groups” scan runs automatically once per day. “Find Accounts through <app\_name>” will find all the apps from that integration to populate/update the All Apps table. The “Find Accounts” scan runs automatically every night, right after that integration’s nightly sync. If the nightly sync fails before it finishes, the scan doesn’t run that night.
Okta integration's Reconnect menu with Sync Okta Users, Sync Okta Groups, and Find Accounts through Okta

If you want to trigger Shadow IT discovery (O365, Google Workspace)

Shadow IT is apps your employees use that IT hasn’t approved. Navigate to the app in the Integrations tab, and trigger one of these scans: “Find Accounts through OAuth”, which will look for all apps accessed via OAuth token The “Find Accounts through OAuth” scan runs automatically once per day when your email provider scan syncs users. “Find Accounts through Email”, which will look at just the email subject headers (not email bodies) of all the emails in your employees’ inboxes to discover Shadow IT The “Find Accounts through Email” scan does not run automatically. You must start it manually.
Google Workspace integration's Reconnect menu with Find Accounts through OAuth and Find Accounts through Email

AppStore Specific Syncs

There are a number of syncs that you can trigger while configuring your AppStore.

If you want to sync apps with your IdP

When you go to add apps to your AppStore, click Sync, then Sync apps. This syncs against O365, OneLogin, or Okta to pull in the newest apps that exist in your IdP. The “Sync apps” scan also runs automatically as part of your IdP’s scheduled sync.
Add Apps page in the AppStore with the Sync Apps button

If you want to sync a single app against your IdP

When you want to make sure you have the correct provisioning settings and assignment groups, click “Sync App Data” within the Advanced Settings of your AppStore. This syncs against O365, OneLogin, or Okta to ensure you have the right groups associated and the right provisioning configurations. Make sure you refresh the page in your browser after clicking Sync App Data to see the new groups. The “Sync App Data” scan runs automatically for every app once per day.
An app's AppStore settings panel with the Sync App Data button

Summary: What syncs and when

Lumos Automatic Syncs

The following table lists the Lumos automatic syncs, when they occur, and their purpose.

Triggering Manual Lumos Syncs

The following table describes how to trigger manual Lumos syncs, what they sync, and how long they take.

FAQs

I synced apps from my IdP, but I don’t see the app in my Lumos tenant? For an app to appear in Lumos, at least one user will need to be associated with the app in your IdP. I synced groups from my IdP, but I don’t see a group in the “Permissions” tab of the corresponding app in Lumos? Groups will only appear in an app’s Permissions tab if at least one user is assigned to the app via that group membership. Note that these empty groups will still be available in the AppStore for assignment and use in Access Requests.