Signing in securely using dasSignOnByCasn

Request

To sign in using the device’s conditional access serial number (caSN), send a POST request to:

BASH

https://<host>:<port>/ias/v3/token/actions/dasSignOnByCasn

Headers

x-correlation-id – ID used to correlate a specific request with a response
nv-tenant-id – ID of the tenant that the device is registered with (mandatory)
nv-mac-address – the MAC address of the device (only required if In Home Detection is enabled – see Network Settings and Account profiles)

Mandatory parameters

casn – the device caSN
dasChallenge – the DAS challenge, returned when Calling DAS to get an authentication challenge
scheme – the DRM scheme used when creating the DAS challenge (either CONNECT or WIDEVINE)

Optional parameters

None

Response

A successful request returns an HTTP 200 status. The response includes the required access and refresh tokens to be used in subsequent calls.

If the request is missing the casn or dasChallenge, it returns an HTTP 400 status.

An unauthorised request returns an HTTP 401 status.

A forbidden request returns an HTTP 403 status.

For a non-existent resource, the request returns an HTTP 404 status.

Example

A successful request returns a response that looks like this:

JSON

{
  "access_token": {
    "typ": "DevAuthN",
    "ver": "1.0",
    "exp": 154826071,
    "fixed_exp": 1550679912,
    "tenantId": "nagra",
    "accountId": "account7",
    "userId": "user7",
    "deviceId": "device7",
    "deviceProfileId": "deviceProfileId8",
    "deviceProfileFeatures": [
      "SD",
      "VOD=NAGRA-FPS-MAIN-VOD",
      "NPVR"
    ],
    "deviceGroupSessionLimitProfileId": "deviceGroupSessionLimitProfileId9",
    "playoutDeviceClass": "playoutDeviceClass01",
    "inHome": false,
    "jti": "4789023423714089478",
    "geoBlockExempt": false,
    "sessionControl": {
      "groups": [
        {
          "groupId": "Group_RTL",
          "maxSessions": 5
        }
      ],
      "groupId": "null",
      "sessionControlEnabled": true,
      "maxSessions": 5
    },
    "parentalControl": {
      "ratingThreshold": {
        "FSK": "fsk12",
        "TVPG": "TV-MA"
      }
    },
    "accountProfileId": "accountProfile7",
    "deviceInformation": {
      "device": {
        "hardware": {
          "model": "Iphone"
        },
        "OS": {
          "type": "IOS"
        }
      }
    },
    "onNetwork": false,
    "filteringInformation": {
      "country": "united kingdom",
      "country-code": "GB",
      "numeric-country-code": "826",
      "region-full-name": "essex",
      "metro-name": "ITV Anglia",
      "metro-code": "826043",
      "city-name": "colchester",
      "postal-code": "co1 1aa",
      "billing-country-code": "GB",
      "filter-string": "Li150"
    },
    "blockingInformation": {
      "country": "united kingdom",
      "country-code": "GB",
      "numeric-country-code": "826",
      "region-full-name": "essex",
      "metro-name": "ITV Anglia",
      "metro-code": "826043",
      "city-name": "colchester",
      "postal-code": "co1 1aa",
      "billing-country-code": "GB",
      "filter-string": "Li150"
    },
    "currentUserProfile": {
      "_id": "string",
      "childProfile": true,
      "maxAgeRating": 0,
      "preferredAudioLanguage": "eng",
      "preferredSubtitleLanguage": "eng",
      "segmentIds": [
        {
          "segmentIds": [
            "Group A",
            "Group B",
            "Group C",
            "Group D"
          ]
        }
      ],
      "additionalProperties": [
        {
          "name": "lastPPVPurchaseDate",
          "value": "2043-01-01T01:01:01.0001Z"
        }
      ]
    },
    "watermarking": false,
    "accountAdditionalProperties": [
      {
        "name": "lastPPVPurchaseDate",
        "value": "yyyy-MM-ddTHH:mm:ss.SSSZ"
      },
      {
        "name": "creditLimit",
        "value": "20"
      },
      {
        "name": "creditSpent",
        "value": "4"
      }
    ]
  },
  "refresh_token": {
    "typ": "RefreshAuthN",
    "ver": "1.0",
    "exp": 154826071,
    "fixed_exp": 1550679912,
    "tenantId": "nagra",
    "accountId": "account7",
    "accountProfileId": "accountProfile7",
    "userId": "user7",
    "deviceId": "device7",
    "playoutDeviceClass": "playoutDeviceClass01",
    "inHome": false,
    "jti": "4789023423714089478",
    "sessionControl": {
      "groups": [
        {
          "groupId": "Group_RTL",
          "maxSessions": 5
        }
      ],
      "groupId": "null",
      "sessionControlEnabled": true,
      "maxSessions": 5
    },
    "currentUserProfileId": "string"
  },
  "client_id": "client7",
  "accountId": "account7",
  "token_type": "Bearer",
  "expires_in": 3887999,
  "refresh_expires_in": 1548260712,
  "fixed_refresh_expires_in": 1548260712,
  "parentalControl": {
    "ratingThreshold": {
      "FSK": "fsk12",
      "TVPG": "TV-MA"
    }
  },
  "currentUserProfileId": "string"
}