Getting Started

SecureSocial is an authentication module for Play Framework applications that works with services based on OAuth1, OAuth2 and OpenID*.

It provides out of the box support for:

• Twitter (OAuth1)
• Facebook (OAuth2)
• GitHub (OAuth2)
• Google (OAuth2)
• LinkedIn (OAuth1)
• Foursquare (OAuth2)
• Instagram (OAuth2)
• VK (OAuth2)
• XING (OAuth1)
• Username/Password with signup and reset password functionality.

*OpenID and more services are coming soon

Scala or Java

SecureSocial is written in Scala. However, if you don't use Scala fear not, the module provides APIs in both languages so you can use your preferred one :-).

Versions

Stable

• SecureSocial 2.1: There isn't a release yet for Play 2.1, but there's a master snapshot available.
• SecureSocial 2.0.12 for Play 2.0.x: available in the 2.0.12 branch on GitHub.
• SecureSocial 0.2.6 for Play 1: available via the official module repository and under the 1.x branch on GitHub.

Snapshots

• SecureSocial for Play 2.1 is built from master.
• SecureSocial for Play 2.0.x is built from 2.0.x.

Note that these branches are used for development, you can use them to get access to the latest changes but keep in mind that things might break there.

Important

This guide is for SecureSocial 2, if you need the documentation for an older version please check the 1.x branch on GitHub.