OpenTV ENTera & OpenTV Platform Documentation

Signing in as a guest user

Overview

OpenTV Platform supports guest (anonymous) sign-in. If enabled, this allows a user to sign in without having to provide a username and password or authenticating in another way.

Guest sign-in can be configured to only allow access from a list of allowed countries.

Once signed in to the guest account, the client must not:

Prerequisites

Guest sign-in must have been enabled by NAGRAVISION before clients can start using this sign-in method. Check with your NAGRAVISION representative.

Request

To sign in anonymously (that is, using the shared guest account). sent a POST request to:

Bash
https://<host>:<port>/ias/v2/anonymoustoken

Headers

  • tenantId – the tenant ID (mandatory)

  • country-code – the country code for the user’s location (optional)
    If not provided, the client’s location is determined from its IP address.
    If the country code does not match the configured allowed country/countries (if any), the request will fail.

Response

A successful request returns an HTTP 200 status. The response contains the access and refresh tokens.

A bad request returns an HTTP 400 status.

A forbidden request returns an HTTP 403 status.

If the guest account does not exist, the request returns an HTTP 404 status.

See also

Identity Authentication Service (IAS) API documentation