If your school uses Google Workspace for Education, you can import your Google Users, Groups, and Classrooms into Linewize Filter. After syncing, you can use this data for classrooms in Classroom Manager or Google sign-in using the Captive Portal. You can also let teachers manually sync their Google Classrooms from within Classroom Manager.
Before you begin
Important
The Super Administrator role is necessary because Google Classrooms can only be synced with an account at that level. However, Linewize does not gain full Super Admin access. Linewize only uses read access for the specific data required, through a token generated by your account credentials. This means Linewize can’t access or change any other data in your Google Workspace.
You must have access to Configuration in Linewize Filter.
You will need at least 15 minutes to complete the configuration. The first sync can take up to three hours, depending on the size of your directory.
To turn on Google integration with Linewize Filter, you need:
Your school’s Google domain.
Credentials for a Google domain account with Super Administrator privileges to turn on Google API.
You must also turn on the following Google Sync Permissions:
View organization units on your domain.
View groups on your domain.
View users on your domain.
View the email addresses of people in your classes.
View your Google Classroom class rosters.
View your Google Classroom classes.
Set up the Google Integration
Required Settings
Sign in to Linewize Filter and go to Configuration > Authentication > Google.
Select Enabled.
In the Administrator field, type in the email address of your Google Workspace Super Administrator account.
Optional Settings
Note
If you sync School data from multiple sources and want to limit the number of users synced from each provider, contact your Linewize Deployment Engineer.
Setting |
Description |
|---|---|
Use FZ Auth API |
Turn on to use Linewize Cloud Authentication. |
Allow Chrome Extension Authentication |
Turn on to use Linewize Connect for Chrome to a user’s device. |
Sync Organization Units |
Turn on to sync any existing organizational units in your Google Workspace. |
Sync Classrooms |
Turn on to let Google Classrooms, including assigned students and teachers, sync with Classroom Manager. |
Sync Groups by ID |
Turn on to sync multiple groups with the same name, and strip domain doesn't apply to groups anymore. Changing this can invalidate existing filtering rules. |
Domain Filter |
Turn on to use a CSV list of domains. Only users and groups attached to these domains will be synced. |
Advanced Configuration settings
Advanced sync settings are for complex deployments only. To see them, expand Advanced Configuration.
Important
Contact the Linewize Support team before you change any Advanced Configuration settings.
Setting |
Description |
|---|---|
Merge Priority |
When multiple source directories contain the same users, sets which directory takes priority when they're combined into a single identity on the Qoria platform. The user from the sync with the highest priority value becomes the primary user. Give each sync a unique merge priority. If syncs share the same priority, which user becomes the primary user is unpredictable. |
Merge Key |
Select the user property used to merge users from multiple sources: Email, Email Without Domain or Computed Expression. |
Attach to existing users only |
Turn on to stop this sync from creating new users. Users must already exist so this source can be merged with the existing user. |
Strip Domain |
Turn on to import users as username instead of username@example.com |
Organizational Unit Filter |
Turn on to import users only from specific organizational units (OUs), then enter the OUs. To enter multiple OUs, use the format /OU1, /OU2 (for example, /local.users, /google.users). When this filter is on, Ignore Empty Groups and Ignore Empty Classrooms turn on automatically. |
Ignore Empty Groups |
Turn on so empty groups aren't synced. |
Ignore Empty Classrooms |
Turn on so empty classrooms aren't synced. |
When you finish setting up, select Submit.
Link your Google Credentials
Sign in to Linewize Filter and go to Configuration > Authentication > Google.
Select Continue with Google on the right-hand panel.
You will be redirected to a Google authorization page. It will auto-populate the Username in the Administrator field.
Select Next, then enter the Password.
Select Allow, and you will be redirected back to the Linewize Filter interface.
Note
If you sync multiple directories that contain the same users, you can merge them into a single Linewize user to avoid conflicting profiles from each directory.
Run Sync
Sign in to Linewize Filter and go to Configuration > Authentication > Google.
Select Run Sync on the right-hand panel.
When sync is complete, you will see the results.
Result |
Description |
|---|---|
User Unchanged |
How many users remained unchanged from this sync. |
Users Added |
How many new users were added from this sync. |
Groups Unchanged |
How many groups remained unchanged from this sync. |
Groups Added |
How many new groups were added from this sync. |
Classrooms Unchanged |
How many classrooms remained unchanged from this sync. |
Classrooms Added |
How many new classrooms were added from this sync. |
Sync Status |
Completed or Failed. Note If the sync is unsuccessful, Sync Status will display “Failed” and an error message, you can use the error message to troubleshoot the sync. |
Sync Started |
The time the sync started. The time is in your time zone. |
Sync Finished |
The time the sync finished. The time is in your time zone. |
Note
Linewize Filter syncs nightly depending on your region.
US region: syncs start at 6:00 PM US Central Time (UTC-5).
AU region: syncs start at 6:00 PM Australian Western Standard Time (UTC+8).
NZ region: syncs start at 6:00 PM New Zealand Standard Time (UTC+12).
UK region: syncs start at 6:00 PM (UTC).
A device's sync may start any time between 6:00 PM in that region and 12 hours later, depending on previous sync times from other devices. You can manually run a sync to propagate changes before the automatic sync period.