Skip to content

Configuring Cable

Enabling SSO with SAML

Setup SSO authentication using SAML to manage access to your Cable App with your existing Identity Provider (available by Request)

The Cable Platform supports SAML 2.0 as an authentication provider – allowing your workforce to sign into our web app using your existing identity management platform.

Getting the ‘Authorisation Admin’ user role

Section titled “Getting the ‘Authorisation Admin’ user role”

To be able to administer SSO settings for your organisation, your user must be given the ‘Authorisation Admin’ role within the Cable Platform. Talk to Synctera support to have this role applied to your account.

This user role allows the given user to:

  • View and edit SSO settings within Cable
  • Enforce the use of SSO for users to access their organisation
  • Always be able to login with an email and password in the event of SSO misconfiguration

Setup with your SAML Identity Provider with a Service Provider (Cable)

Section titled “Setup with your SAML Identity Provider with a Service Provider (Cable)”

Within your SAML Identity Provider you will need to set up Cable as a Service Provider.

Some providers allow you to provide the Metadata URL which can make a lot of the set-up automatic. However, you might have to adjust some of the settings.

Field Value
Metadata URL https://shield.cable.tech/saml/metadata
Entity ID https://shield.cable.tech
ACS / SSO URL https://shield.cable.tech/saml/acs
Start Page URL (optional) https://app.cable.tech/auth/signin

When setting up your Identity Provider you will have the option to configure some attribute mappings or claims, at a minimum you must provide a mapping for the email claim

Attribute Alternatives Description
email The user’s email address
first_name givenname, name The users first name
last_name familyname The users last name
  • PERSISTENT is the best option
  • EMAIL can work if you don’t expect to be able to change your users email addresses

Setup with Cable with the Service Provider Metadata

Section titled “Setup with Cable with the Service Provider Metadata”

You must now provide the IDP SSO Descriptor as XML to the Cable application.

You can do this by:

Once the configuration is applied you can test it by logging out of the Cable App and attempting an SSO sign in. If you experience an error you can still sign in with your existing email and password and adjust the configuration.

When trying to login I receive an “SSO Login Error”

Section titled “When trying to login I receive an “SSO Login Error””

This is commonly caused by an incorrect attribute or claim mapping, you must configure the email claim correctly so that users can be correctly identified. The attribute must be called email without any namespace.