Table of Contents

Google Apps Synchronization

The Google Apps Synchronization app synchronizes the users, groups and passwords on your ClearOS system with your Google Apps domain. Whether you add new users to a group or change a user password, these changes will synchronize to the cloud.

Please note, the synchronization tool is not available for the free version of Google Apps… sorry.

Installation

If your system does not have this app available, you can install it via the Marketplace.

You can find this feature in the menu system at the following location:

<navigation>Server|Messaging and Collaboration|Google Apps Synchronization</navigation>

Getting Started

Enable User Provisioning

Access to Google Apps user/group provisioning must be enabled. Log into your Google Apps account with administrator privileges and go to the Google Apps Admin Console.

Google Apps API Access

Connect ClearOS

With API access enabled, you can now connect your ClearOS system to Google Apps.

ClearOS Google Apps Request Token

At this point, you should see a long access code provided by Google. You will need to copy and paste this access code into the ClearOS app (see screenshot). You will also need to provide the Google Apps domain and the administrator e-mail.

Google Apps access code

Synchronization

Testing Synchronization

Before enabling automatic synchronization, you can test the process using the web-based administration tool in ClearOS.

In most cases, you will see the following error:

The Google Apps administrator account cannot be suspended

That makes sense (I hope!). Follow the link to create the account on your ClearOS system. Please make sure the Google Apps option is enabled when you create the user!

Users

Go ahead and create a user with Google Apps enabled and then re-run the synchronization test. One you are happy with the results, perform a synchronization and please read the following warning:

It can take several minutes for a user or group change to appear in Google Apps. Please be patient.

Groups

Groups are also synchronized to Google Apps:

After the synchronization is complete, it will take a minute or two to see the results in the Google Apps administration portal. If you would like external users to be able to e-mail groupname@your_domain.com, you need to update this policy in the Google Apps portal. By default, the mailing list is only available to internal users.

Enabling Automatic Synchronization

The final step in Google Apps Synchronization is the easiest. Please make sure automatic synchronization is enabled. This is especially important to catch the password changes that can be triggered by an end user.

Managing Users

In order to protect against losing user data, a user is put into suspended mode if Google Apps is disabled from the ClearOS User Manager. In order to completely delete the user, please use the Google Apps administrator interface to do so. You can also restore the user if the deletion was unintended.

Troubleshooting

Error 1300: EntityExists

You will see this error if you try to create a user that already exists, but is suspended. See Managing Users above. search?q=clearos%2C%20clearos%20content%2C%20Google%20Apps%20Synchronization%2C%20app-google-apps%2C%20clearos7%2C%20userguide%2C%20categorycloud%2C%20subcategoryservices%2C%20maintainer_bchambers&amp;btnI=lucky