Auth

DocsSettings › Auth

Last updated: 30 Aug 2019 / 6:04 PM / GMT

In the following guide, you will get more familiar with the Auth tab of the InPlayer Dashboard Settings.


The Auth tab is where you’ll set up the authentification and restriction settings for your assets.

This includes things like enabling your customers to use their social accounts to register and log in, limiting the number of devices they can watch on using the same account, adding geo and domain restrictions and more.

The Auth section has multiple tabs. Let’s take a look at them.

Social Auth

In the Social Auth tab, you can let your customers use their Facebook, Twitter, or Google accounts to register and log into your platform, instead of them using the standard paywall register and log in forms.

To enable or disable the social logins, just click on their respective toggles.

Once enabled, the social login buttons will appear on the paywall.

By default, our platform will use our own social apps to manage the customer logins, but you can also use your own apps by clicking on Setup and setting them up.

OAuth & SSO

OAuth and SSO are two features of our platform that can be very useful if you have content across multiple websites (domains).

OAuth

With the OAuth feature, you can group the customers from one website into one user group (called an OAuth app or application), and the ones from another website, into another group.
This can be very useful when making reports because you will have an easy way of seeing how many people registered on each of your websites.

To use the OAuth feature, you first need to create the user groups into which your customers will be divided. We call these user groups OAuth apps.
You can then attach an OAuth app to each of your assets, so whenever a customer registers an account on that asset, they would become a part of that user group.

You will notice that you already have one OAuth app, i.e. the Default app. This is the default group to which all the customer registrations and login records will go to.

Creating a new OAuth app

To create a new OAuth app, click on the Create new app box.

Give your new app a name (you can use the name of your website for example), and click .

You can add as many OAuth apps as you want.

Using the OAuth feature

Using the OAuth feature is very simple. All you have to do is choose the OAuth app you want to use for an asset, while you are getting the embed code for that asset.

In the Assets tab of your InPlayer dashboard, go to the asset to which you wish to attach an OAuth app, and open it by clicking .

Click on the  button at the top right.

Select the OAuth app you wish to use.

With that, every time a customer registers or logs into that asset, they will be grouped into the user group of the selected OAuth app.
Once you set up the OAuth app, you can embed the asset on your webpage like you normally would.

SSO

With the SSO (Single-Sign-On) feature, you can make it so whenever a customer logs into one of your websites, they will automatically be logged into all of your other websites as well.
This greatly streamlines the customer experience.

The SSO works as an extension of the OAuth feature, which means you have to attach an OAuth group on an asset to be able to use the SSO for it as well.

Enabling the SSO feature

To enable the SSO feature, first click on .

You can now enable the SSO feature for all your OAuth apps.

To do this, just click the Enable SSO toggle on the OAuth app.

With that, the SSO is activated for that OAuth app.
Every time you set up an asset to use that OAuth app, you will have the option to enable the SSO feature for it as well.
We will see how to do this further down in this article.

But first, you need to add the domains on which your customers will be automatically logged in as soon as they log into just one.
To do that, click on the  button next to Add domains.

Type in your domain and click .

Make sure you do not add a / at the end of the domain, nor any other special characters.

You can add as many domains as you wish.
If you ever wish to remove a domain, just click the button next to it.

Using the SSO feature

Using the SSO feature is very simple. All you have to do is enable it in an asset when you are getting the embed code for it.

In the Assets tab of your InPlayer dashboard, go to the asset to which you wish to attach an OAuth app, and open it by clicking .

Click on the  button at the top right.

Select the OAuth app you wish to use.

Once you select the OAuth app, you will see a Sso enabled: toggle right next to it.
To enable or disable the SSO, just click on the toggle.
If you don’t see the toggle, go back to the OAuth & SSO tab and make sure the SSO feature for the OAuth you are using is enabled.

With that, every time a customer registers or logs into that asset, they will be logged into all domains (websites) that you’ve added in the SSO settings.

Once you set up the SSO, you can embed the asset on your webpage like you normally would.

You can disable the SSO feature at any time by going to the OAuth & SSO tab and clicking on the SSO toggle.

Concurrent Sessions

In the Concurrent Sessions tab, you can limit how many login sessions your customers can have when using a single account, thereby preventing the sharing of credentials.

This is left as blank by default, which means your customers can have an unlimited amount of sessions.

To limit the session, just enter the maximum number of active sessions in the field.

As soon as a customer surpasses that number, they will be logged out of the first session they’ve logged into. The log out will happen immediately, without the need for the customer to refresh their page.

Note that if you are using multiple OAuth apps, the concurrent session setting will work per single OAuth app.

Geo Restrictions

In the Geo Restrictions tab, you can restrict access to your content based on the customer’s country.

To restrict the content, you first need to create a country set, which you can then use as the default geo-restriction set, or use it on a single asset only.

Creating a country set

To create a new country set, click on Create new set.

You can either include a set of countries, thereby making the assets only available there, or exclude a set of countries thereby making the asset available everywhere but there.
Set everything up and click .

After you create a country set, you can either set it up as a default set, so it affects your entire content, or use it as an asset-specific domain restriction, which affects a single asset. Note that the asset-specific restrictions will always override the default restrictions. In addition, you can also use the country sets created here for geo-restricting individual asset prices, so that they only appear in certain countries.

Setting up a default geo-restriction

The set you set up as default in the Geo Restrictions tab of the Settings will affect your entire content, i.e. all of your assets.

To do this, click on the three dots in the upper right corner of the country set, and then click on make default.

Setting up an asset-specific geo-restriction

An asset-specific geo-restriction will affect only a single asset.

You can set it up in the asset’s settings.

To do this, open the asset, go the Restrictions section, and under Geography select the country set you wish to use for the asset.

Setting up a price-specific geo-restriction for an asset

In addition to being able to geo-restrict a single asset, we can go one step further and geo-restrict only a single price option of an asset.

To do this, open the asset, go to the Price options section, and open the price you wish to restrict by clicking on the button.

Then go to the Additional Info tab and check the Geo-restriction setting.

Here, you can either restrict the price in a single country, or use a country set you’ve created previously.

Domain Restrictions

Similar to the geo-restrictions, in the Domain Restrictions tab you can limit the availability of your content based on a domain.

This means that your assets will only be embeddable on domains specified by you.

You can set up a default domain restriction which affects your entire content, or an asset-specific domain restriction, which affects a single asset. Note that the asset-specific restrictions will always override the default restrictions.

Setting up a default domain restriction

The domain you set up in the Domain Restrictions tab of the Settings is going to be the default domain restriction, and will affect your entire content, i.e. all of your assets.

To do this, click on Add a domain.

Enter your domain and click .

Make sure you do not add a / at the end of the domain, nor any other special characters.
If you ever wish to remove a domain, just click the  button next to it.

Setting up an asset-specific domain restriction

An asset-specific domain restriction will affect only a single asset.

You can set it up in the asset’s settings.

To do this, open the asset, go the Restrictions section, and under Domains, click Add a domain and enter the domain.

Make sure you do not add a / at the end of the domain, nor any other special characters.

Custom Fields

Custom Fields are additional fields on the paywall’s registration form. They can be used to gather all kinds of metadata from our customers. These details will help you discover, identify and describe your customers, and understand their connection and feelings about your product or service.

Adding custom fields

Log into your InPlayer merchant panel and go to Settings.

Then go to the Custom Fields tab.

To add a custom field, click .

There are several different types of custom fields.

Input

The Input field is where your customers can type in text.

  • Name – This is the name of the field which is stored in the database. Your customers will not see this.
  • Placeholder – Here you can type in a short description that will tell the customers what they should enter in the field.
  • Default Value – This is going to be the default text in the field. You can leave this blank.

Dropdown

The Dropdown field lets you add a drop-down menu to the registration form.

  • Name – This is the name of the field which is stored in the database. Your customers will not see this.
  • Placeholder – Here you can type in a short description for the field.
  • Select Options – This is where you add the drop-down menu entires.
    • Enter Option Key – This is the title of the entry that will be written in the database. Your customers will not see this.
    • Enter Option Label – This is the title of the entry that will appear on the paywall, and what your customers will actually see.

Once you set up an entry, make sure to click the  button on the right of it to save it.
You can add up to 30 entries.

Radio

The Radio field lets you add a set of multiple options from which the customer will have to select only one.

  • Name – This is the name of the field which is stored in the database. Your customers will not see this.
  • Label – Here you can type in the description or title of the field that your customers will see.
  • Radio Options – This is where you add the multiple options.
    • Enter Option Key – This is the title of the option that will be written in the database. Your customers will not see this.
    • Enter Option Label – This is the title of the option that will appear on the paywall, and what your customers will actually see.

Once you set up an option, make sure to click the  button on the right of it to save it.

Checkbox

The Checkbox field lets you add a checkbox.

  • Name – This is the name of the field which is stored in the database. Your customers will not see this.
  • Label – Here you can type in the description or title of the field that your customers will see.
  • Default Value – Set whether the field will be checked or unchecked by default.
    A very useful feature of the Checkbox custom field is that you can add a hyperlink to the Label text.

To do this, select the text you want to hyperlink to and click  .

Country field

With the Country field, your customers can select their country.

  • Placeholder – Here you can type in a short description for the field.

For each of the custom fields, you can set up whether they are going to be required or non-required, by toggling the slider next to the  button.

Date picker

This will include a date picker field.

  • Name – This is the name of the field which is stored in the database. Your customers will not see this.
  • Label – Here you can type in the description or title of the field that your customers will see.

Modifying the custom fields

Once created, the custom fields can always be modified.
To do this, just open the field you wish to edit by clicking on the  button next to it.

Removing a custom field

To remove a custom field, just open it, and click the  button.

Getting the metadata from the custom fields

The customer metadata gathered from the custom fields can be accessed and exported at any time.

To do this, go to the Audience tab of your InPlayer dashboard.

To get the customers’ metadata, just click on the  button in the Action column on the customer’s row.

In the Info collected section, you can see the metadata that was gathered from the customer upon registration.

Additionally, if you want to export the data for a report, you can always do so by clicking on  in the Audience tab.

Here, in Select report columns, you can select all the fields you wish to include in your report, along with the timeframe for it.
Then click .

To view the report, click on .

From there you can download the report as a CSV file and use it in any way you wish.

Age Restrictions

The age restriction tab gives you a way to restrict access to your content based on age.

The feature is not enabled by default, but if you want to use it, just send us an email on support@inplayer.com and we will enable it for you.

When a customer tries to purchase an asset that has been age-restricted, they will have to confirm their date of birth.

If their age is less than the one set up in the InPlayer Dashboard, they will not be granted access.

You can set up a global age restriction which affects your entire content, or an asset-specific age restriction, which affects a single asset. Note that the asset-specific restrictions will always override the global restrictions.

Setting up a global age restriction

The age restriction you set up in the Age Restrictions tab of the Settings is going to be the global restriction, and will affect your entire content, i.e. all of your assets.

To do this, select the minimum age from the drop-down menu.

Then click .

Setting up an asset-specific age restriction

An asset-specific age restriction will affect only a single asset.

You can set it up in the asset’s settings.

To do this, open the asset, go the Restrictions section, and under Age select a minimum age.

Make sure to click the button in the bottom right corner.

How it works

When a customer tries to purchase an asset that is age-restricted, they will first need to enter their date of birth.

Upon entering their age, they will receive an email with a PIN number.

They will need to enter this PIN on the next screen on the paywall.

They will be able to use the same PIN each time they log in, but they can also get a new one, in case they lose or forget it.

When they enter their PIN, if their age is equal or greater than the one set up in the age restriction settings, they will be able to purchase the asset and watch the content.

The PIN enables the customer to watch for one hour. After the hour is up, the PIN window will appear again and the customer will need to enter it again so they can continue watching.

If the customer’s age is lower than the one set up in the age restriction settings, they will be shown the below message, and won’t be able to watch the content.

This concludes our guide.

If you have any questions, don’t hesitate to contact us on support@inplayer.com.

We use cookies to analyse our traffic. We also share information about your use of our site with our analytics partners. See details