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 and OAuth2)
  • 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 :-).



  • 2.1.4 for Play 2.2.x
  • 2.1.1 for Play 2.1.x
  • 2.0.13 for Play 2.0.6
  • 0.2.6 for Play 1: available via the official Play module repository and under the 1.x branch on GitHub.


Note: you can use snapshots to get access to the latest changes but keep in mind that things might break there.


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