juplo.de Git - website/blob

   1 ---
   2 _edit_last: "2"
   3 author: kai
   4 categories:
   5   - howto
   6 date: "2016-01-25T17:59:59+00:00"
   7 guid: http://juplo.de/?p=626
   8 parent_post_id: null
   9 post_id: "626"
  10 tags:
  11   - createmedia.nrw
  12   - facebook
  13   - graph-api
  14   - java
  15   - oauth2
  16   - spring
  17   - spring-boot
  18   - spring-social
  19 title: 'Develop a Facebook-App with Spring-Social – Part IV: Signing In Users'
  20 url: /develop-a-facebook-app-with-spring-social-part-04-signing-in-users/
  21
  22 ---
  23 In this series of Mini-How-Tow's I will describe how to develop a facebook app with the help of [Spring-Social](http://projects.spring.io/spring-social/ "Learn more about Spring-Social")
  24
  25 In [the last part of this series](/develop-a-facebook-app-with-spring-social-part-03-implementing-a-user-id-source "Go back to part 3 of this series, to learn how you plug in user-recognition into Spring Social"), we tried to teach Spring Social how to remember our signed in users and learned, that we have to sign in a user first.
  26
  27 In this part, I will show you, how you sign (and automatically sign up) users, that are authenticated via the Graph-API.
  28
  29 ## The Source is With You
  30
  31 You can find the source-code on [/git/examples/facebook-app/](/git/examples/facebook-app/ "Link for cloning")
  32 and [browse it via gitweb](/gitweb/?p=examples/facebook-app;a=summary "Browse the source-code now").
  33 Check out `part-04` to get the source for this part of the series.
  34
  35 ## In Or Up? Up And In!
  36
  37 In the last part of our series we ran in the problem, that we wanted to connect several (new) users to our application.
  38 We tried to achieve that, by extending our initial configuration.
  39 But the mistake was, that we tried to _connect_ new users.
  40 In the world of Spring Social we can only connect a _known user_ to a _new social service_.
  41
  42 To know a user, Spring Social requires us to _sign in_ that user.
  43 But again, if you try to _sign in_ a _new user_, Spring Social requires us to _sign up_ that user first.
  44 Because of that, we had already implemented a [`ConnectionSignUp`](/develop-a-facebook-app-with-spring-social-part-03-implementing-a-user-id-source/#ProviderUserIdConnectionSignUp "Jump back to the last part and view the source of our implementation") and [configured Spring Social to call it](/develop-a-facebook-app-with-spring-social-part-03-implementing-a-user-id-source/#plumbing-ConnectionSignUp "Jump back to the last part to view how we pluged in our ConnectionSignUp"), whenever it does not know a user, that was authenticated by Facebook.
  45 If you forget that (or if you remove the according configuration, that tells Spring Social to use our `ConnectionSignUp`), Spring Social will redirect you to the URL `/signup` — a Sign-Up page you have to implement — after a successfull authentication of a user, that Spring Social does not know yet.
  46
  47 The confusion — or, to be honest, _my_ confusion — about _sign in_ and _sign up_ arises from the fact, that we are developing a Facebook-Application.
  48 We do not care about signing up users.
  49 Each user, that is known to Facebook — that is, who has signed up to Facebook — should be able to use our application.
  50 An explicit sign-up to our application is not needed and not wanted.
  51 So, in our use-case, we have to implement the automatically sign-up of new users.
  52 But Spring Social is designed for a much wider range of use cases.
  53 Hence, it has to distinguish between sign-in and sign-up.
  54
  55 ## Implementation Of The Sign-In
  56
  57 Spring Social provides the interface `SignInAdapter`, that it calls every time, it has authenticated a user against a social service.
  58 This enables us, to be aware of that event and remember the user for subsequent calls.
  59 Our implementation stores the user in our `SecurityContext` to sign him in and creates a cookie to remember him for subsequent calls:
  60
  61 ```Java
  62 public class UserCookieSignInAdapter implements SignInAdapter
  63 {
  64   private final static Logger LOG =
  65       LoggerFactory.getLogger(UserCookieSignInAdapter.class);
  66
  67   @Override
  68   public String signIn(
  69       String user,
  70       Connection connection,
  71       NativeWebRequest request
  72       )
  73   {
  74     LOG.info(
  75         "signing in user {} (connected via {})",
  76         user,
  77         connection.getKey().getProviderId()
  78         );
  79     SecurityContext.setCurrentUser(user);
  80     UserCookieGenerator
  81         .INSTANCE
  82         .addCookie(usSigning In Userser, request.getNativeResponse(HttpServletResponse.class));
  83
  84     return null;
  85   }
  86 }
  87
  88 ```
  89
  90 It returns `null`, to indicate, that the user should be redirected to the default-URL after an successful sign-in.
  91 This URL can be configured in the `ProviderSignInController` and defaults to `/`, which matches our use-case.
  92 If you return a string here, for example `/welcome.html`, the controller would ignore the configured URL and redirect to that URL after a successful sign-in.
  93
  94 ## Configuration Of The Sign-In
  95
  96 To enable the Sign-In, we have to plug our `SignInAdapter` into the `ProviderSignInController`:
  97
  98 ```Java
  99 @Bean
 100 public ProviderSignInController signInController(
 101     ConnectionFactoryLocator factoryLocator,
 102     UsersConnectionRepository repository
 103     )
 104 {
 105   ProviderSignInController controller = new ProviderSignInController(
 106       factoryLocator,
 107       repository,
 108       new UserCookieSignInAdapter()
 109       );
 110   return controller;
 111 }
 112
 113 ```
 114
 115 Since we are using Spring Boot, an alternative configuration would have been to just create a bean-instance of our implementation named `signInAdapter`.
 116 Then, the auto-configuration of Spring Boot would discover that bean, create an instance of `ProviderSignInController` and plug in our implementation for us.
 117 If you want to learn, how that works, take a look at the implementation of the auto-configuration in the class [SocialWebAutoConfiguration](https://github.com/spring-projects/spring-boot/blob/v1.3.1.RELEASE/spring-boot-autoconfigure/src/main/java/org/springframework/boot/autoconfigure/social/SocialWebAutoConfiguration.java#L112 "Jump to GitHub to study the implementation of the SocialWebAutoConfiguration"), lines 112ff.
 118
 119 ## Run it!
 120
 121 If you run our refined example and visit it after impersonating different facebook-users, you will see that everything works as expected now.
 122 If you visit the app for the first time (after a restart) with a new user, the user is signed up and in automatically and a cookie is generated, that stores the Facebook-ID of the user in the browser.
 123 On subsequent calls, his ID is read from this cookie and the corresponding connection is restored from the persistent store by Spring Social.
 124
 125 ## Coming Next...
 126
 127 In [the next part](/develop-a-facebook-app-with-spring-social-part-05-refactor-the-redirect-logic "Jump to the next part of this series and read on...") of this little series, we will move the redirect-if-unknown logic from our `HomeController` into our `UserCookieInterceptor`, so that the behavior of our so-called "security"-concept more closely resembles the behavior of Spring Security.
 128 That will ease the migration to that solution in a later step.
 129
 130 Perhaps you want to skip that, rather short and boring step and jump to the part after the next, that explains, how to sign in users by the `signed_request`, that Facebook sends, if you integrate your app as a canvas-page.
 131
 132 ## Funded by the Europian Union
 133
 134 This article was published in the course of a
 135 [resarch-project](http://yourshouter.com/projekte/crowdgest%C3%BCtzte-veranstaltungs-suchmaschine.html "Show details about the funded resarch-project"),
 136 that is funded by the European Union and the federal state Northrhine-Wetphalia.
 137
 138 [![Europäische Union: Investitionen in unsere Zukunft - Europäischer Fonds für regionale Entwicklung](/img/EFRE_Foerderhinweis_deutsch_farbig.svg)![EFRE.NRW 2014-2020: Invesitionen in Wachstum und Beschäftigung](/img/Ziel2NRW_4c_1809_eps.svg)](http://yourshouter.com/projekte/crowdgest%C3%BCtzte-veranstaltungs-suchmaschine.html "Show details about the funded resarch-project")