How to set up Login via Facebook, Twitter and Google

If you want your users to be able to login to Aware IM automatically using their existing Facebook, Twitter or Google accounts you need to do the following:

1. Register your application as Facebook, Twitter or Google developer (see How to register Aware IM application in Facebook, How to register Aware IM application in Twitter, How to register Aware IM application in Google sections for more details)
2. In the Configuration Tool double click on the business space version you want to change and then select the Login Options property from the list of properties.
3. Tick the corresponding checkbox to allow login via a particular account, for example Allow Login via Facebook
4. Click on the Settings button next to the tickbox.
5. Enter the application id and secret obtained from step 1.
6. Alternatively go to the SystemSettings business object and add two attributes to this object to hold the values of the application ID and secret (that is, if you want system administrators to be able to do this at run-time)

Then specify these attributes in the Settings dialog.

1. It is important to understand that when the user logs in via Facebook, Twitter or Google Aware IM will find the instance of the user object that corresponds to the current user. Therefore, you need to indicate which type of the user object Aware IM should look for, i.e. you need to indicate the member of the SystemUser group in the user drop down.
2. You should then select the attributes that Facebook, Twitter or Google provides that should map to the attributes of the selected user object. For example, you can map the id attribute provided by Facebook to the LoginName attribute of the user. Every time a user with this Facebook id logs in Aware IM will find the corresponding user object with the value of LoginName equal to this id.
3. You should also tick the “Allow creating the object automatically…” checkbox if you want **Aware IM88 to automatically create a user instance if this instance has not been found. Note that the user object should not have any mandatory attributes that are not provided by Facebook, Twitter or Google, otherwise Aware IM will not be able to create the instance automatically
4. The user can then a special URL to login. See see How to register Aware IM application in Facebook, How to register Aware IM application in Twitter, How to register Aware IM application in Google for more details