Social providers integration

If you want to enable sign up through social providers like Facebook you will need to generate app credentials and write them into the Rails secrets file: config/secrets.yml.

Facebook

  1. Navigate to Facebook Developers Page

  2. Follow the "Add a New App" link.

  3. Click the "Website" option.

  4. Fill in your application name and click "Create New Facebook App ID" button.

  5. Fill in the contact email info and category.

  6. Validate the captcha.

  7. Ignore the source code and fill in the URL field with https://YOUR_DECIDIM_HOST/users/auth/facebook/callback

  8. Navigate to the application dashboard and copy the APP_ID and APP_SECRET

  9. Paste credentials in config/secrets.yml. Ensure the enabled attribute is true.

Twitter

  1. Navigate to Twitter Developers Page

  2. Follow the "My apps" link.

  3. Click the "Create New App" button.

  4. Fill in the Name, Description fields.

  5. Fill in the Website and Callback URL fields with the same value. If you are working on a development app you need to use http://127.0.0.1:3000/ instead of http://localhost:3000/.

  6. Check the 'Developer Agreement' checkbox and click the 'Create your Twitter application' button.

  7. Navigate to the "Keys and Access Tokens" tab and copy the API_KEY and API_SECRET.

  8. (Optional) Navigate to the "Permissions" tab and check the "Request email addresses from users" checkbox.

  9. Paste credentials in config/secrets.yml. Ensure the enabled attribute is true.

Google

  1. Navigate to Google Developers Page

  2. Follow the 'Create projecte' link.

  3. Fill in the name of your app.

  4. Navigate to the projecte dashboard and click on "Enable API"

  5. Click on Google+ API and then "Enable"

  6. Navigate to the project credentials page and click on OAuth consent screen.

  7. Fill in the Product name field

  8. Click on Credentials tab and click on "Create credentials" button. Select OAuth client ID.

  9. Select Web applications. Fill in the Authorized Javascript origins with your url. Then fill in the Authorized redirect URIs with your url and append the path /users/auth/google_oauth2/callback.

  10. Copy the CLIENT_ID AND CLIENT_SECRET

  11. Paste credentials in config/secrets.yml. Ensure the enabled attribute is true.