Self Registration

Self Registration (formerly called Social registration) is a Splynx add-on that allows customers to register themselves in the Splynx portal using their e-mail address or mobile phone numbers. Customers can also register and log in using their Google+, Facebook or Twitter accounts.

If you want to use this add-on to social platforms - it is necessary to have the API applications . If you don't have this - below is how you create them.

How to create and enable API-apps in Google+, Facebook, and Twitter

Google API

You need a Google API Console project to integrate Google Sign-In into your Splynx-site. To create a Google API Console project and client ID, follow these steps:

  • Go to the Google API Console (https://console.developers.google.com/projectselector/apis/library)

  • Select an existing project, or create a new one 4.png

  • In the sidebar under APIs & Services, select Credentials, then select the OAuth consent screen tab
    5.png

  • Choose an Email Address, specify a Product Name, and press Save 6.png

  • In the Credentials tab, select Create credentials drop-down list, and choose OAuth client ID 7.png

  • Under Application type, select Web application Authorized JavaScript origins - URL of your Splynx-server Authorized redirect URIs - enter these values: 1) https://splynx.youdomain.com/register/site/auth?authclient=google 2) https://splynx.youdomain.com/register/login/auth?authclient=google

    selfreg_create-google-api-auth.png

  • Click Create

NOTICE: If the customer receives this error message during registration or sign-in process, then the wrong URI (1) has been added to Authorized redirect URIs list.

10.png

Reference: Google documentation

Facebook API

To integrate Facebook Logins into your Splynx-site, you must have a Facebook API. Notice: Splynx-site must use HTTPS. It is required by Facebook.

  • Go to developers portal https://developers.facebook.com/apps

  • Create App 13.png

  • In Select a product select Facebook Login (click Set Up)
    14.png

  • Do not use Quickstart, use Settings selfreg_fb-use-settings.png

  • Enter Valid Oauth redirect URIs: 1) https://splynx.youdomain.com/register/site/auth?authclient=facebook 2) https://splynx.youdomain.com/register/login/auth?authclient=facebook 15.png

  • Click Save Changes

  • Go to App Settings / Basic, copy App ID and App Secret to Splynx
    selfreg_fb-AppID_Secret-mix.png

  • Enable App as Public (from App Review) 17.png

Reference: Facebook documentation

Twitter API

For Twitter integration, go to the Application Management page - https://apps.twitter.com/

  • Create a New App 18.png

  • Enter application Name, Description, Website, Callback URL (http://splynx.youdomain.com/register/login/auth?authclient=twitter), and click button Create your Twitter application 19.png

  • From tab Keys and Access Tokens copy Consumer Key (API Key) and Consumer Secret (API Secret) to Splynx

  • Go to Permissions and enable Request email addresses from users
    Selection_034.png

Installing the Add-on

The add-on can be installed in two methods, via CLI or the Web UI.

To install the "Self Registration" add-on via CLI, the following commands can be used:

sudo apt update
sudo apt install splynx-social-registration

To install it via the Web UI:

Navigate to Config -> Integrations -> Add-ons:

1.png

Locate or search for the "splynx-0self-registration" addon and click on the install icon in the Actions column

2.png

Click on the "OK, confirm" button to begin the installation process

3.png

After the installation has completed, you have to configure the add-on under Config / Integrations / Modules List.

Modules_list.png

Locate or search for the "splynx-0self-registration" addon and click on the edit icon in the Actions column

Module_edit.png

You need to enable the Entry points status for portal in the Main information section

Module_edit1.png

You may enable or disable Entry Points here as well. There are two entry points in the configuration.

Edit_entry.png

The first one provides the ability to sign-in to the Splynx-portal using social networks.

Entry_point_one.png

The second one provides the ability of registration via social networks.

Entry_point_two.png

Edit the URL of your server:

Splynx_url.png

Enable social networks that you want to use:

Social_networks_enable-disable.png

You can enable TowerCoverage integration:

selfreg_towercoverage.png

Once all settings have been configured click on Save.


Registration

28.png

Customer will need to Enter the required information, and click on the Sign In button.

29.png


Login customer to Splynx-portal

  • Login with Facebook
    If the customer is not logged into Facebook, they will be prompted to log into Facebook and then redirected to Splynx-portal. 21.png

  • Login with Google If the customer is not logged in Google+, they will be prompted to log into Google and then redirected to Splynx-portal. 22.png

  • Login with Twitter
    If the customer is not logged in Twitter, they will be prompted to log into Twitter and then redirected to Splynx-portal. 23.png

Information about social-networks is stored in Customer / Information / Additional information in the Social ID field

24.png


TowerCoverage Integration