README.md

Groupsync daemon

This is a daemon that can replicate group and membership information from a relational database to Google Groups.

Notable files:

• config/config.properties -- Contains DB and Google credentials.

• config/logback.xml -- Logging configuration. Logs to logs/ by default.

• build.sh -- Build the code.

• run.sh -- Run the daemon in the foreground.

• init.sh -- An init script for running on startup.

• authorize_oauth.sh -- Sets up OAuth tokens for Google API access.

Getting started

• Unpack the code somewhere

• Configure your DB and Google settings under config.properties

• Authorize your Google account by running:

  ./authorize_oauth.sh 'yourgoogleuser.apps.googleusercontent.com' 'usersecret' 'https://configured-redirect-url.example.com/' groupsync.credentials

  These values are available under the 'Credentials' area of the Google API console. The redirect URL needs to be a valid HTTPS address, and should be something you control. When you follow the Google authentication link printed by the above program, your browser will redirect to a URL like:

  https://configured-redirect-url.example.com?code=BLAHBLAHBLAH&scope=https://www.googleapis.com/auth/apps.groups.settings%20https://www.googleapis.com/auth/admin.directory.group

  and you will need to extract the BLAHBLAHBLAH bit and paste it into the console when prompted.

• Apply the appropriate database commands for your database (see the migrations directory)

• Start it up (either with run.sh or via the init script)