How do I set up Shared Session?

Shared Session can be used to automatically log in users to your TNEW website when they are directed there from your app.

How it works

1. A user logs into your app. (Logins persist, so users don't need to re-login when they come back to the app)
2. User clicks a button or link in the app that goes to your TNEW website.
3. InstantEncore's servers and TNEW communicate to setup the shared session.
4. User lands on your TNEW website with the same session as they were using in the app.

Prerequisites

The following are required to setup Shared Session.

1. TNEW v7 or later
2. Access to DNS settings for your website domain
3. Access to your TNEW Administration Site

Setup Overview

1. Configure DNS settings
2. Configure the Redirect Domain in TNEW
3. Copy Shared Session settings from TNEW
4. InstantEncore completes the setup
5. Test
6. Enable Shared Session

1. Configure DNS Settings

1. Log into your domain registrar to manage your DNS settings.
   
   
2. Add an "A (Host) record" for "instantencore.yourdomain.com". Replace "yourdomain.com" with the domain used by your TNEW site. This should point to the IP address 3.94.1.216. Leave the TTL value as the default. Save changes.
   
   Example: If your TNEW site is "tickets.myorganization.com" then you would add an A record for "instantencore.myorganization.com".
   
   
3. Verify that this has been completed. An easy way to do this is by using DNS Look Up website. Just put in the Domain Name "instantencore.yourdomain.com" (replace yourdomain.com). You should see the IP address 3.94.1.216.
   
   
   
   For those more technically inclined, you can run this following from the command line:
   dig +noall +answer instantencore.yourdomain.com
Expected result:
   instantencore.yourdomain.com. 599 IN A 3.94.1.216
   
   
4. Log into your InstantEncore account and go to the Shared Session page (Control Panel > InstantApps > Tessitura > Shared Session > Manage).
   
   
5. In the "DNS" section click the "This is Done" button.

2. Configure the Redirect Domain in TNEW

1. Send an email to Tessitura asking them to add "instantencore.yourdomain.com" to the list of Approved Redirect Domains. Replace "yourdomain.com" with the domain used by your TNEW site.
   
   Example: If your TNEW site is "tickets.myorganization.com" then you would add "instantencore.myorganization.com" as a Redirect Domain.
   
   
2. Get confirmation from Tessitura that they have completed this.
   
   
3. Log into your InstantEncore account and go to the Shared Session page (Control Panel > InstantApps > Tessitura > Shared Session > Manage).
   
   
4. In the "Redirect domain" section click the "This is Done" button.

3. Copy Shared Session settings from TNEW

1. Log into your TNEW Administration site.
   
   
2. Go to Site Setup > Session Sharing. You will need to copy these values into the InstantEncore Control Panel.
   
   
3. Log into your InstantEncore account and go to the Shared Session page (Control Panel > InstantApps > Tessitura > Shared Session > Manage).
   
   
4. Fill in the values in the "Settings" section.
   
   TNEW Domain: The domain of your TNEW website. Example: tickets.myorganization.com
   
   Redirect Domains: Comma separated list of domains that use Shared Session. This should include the "TNEW domain" above. It may also contain other domains that you have configured for shared session. Shared session will only work with links that have a domain in this list. If a user clicks a link and the domain is not in this list then Shared Session will not be initiated.
   
   Authentication Key: Copy this from the TNEW Administration Site.
   
   Salt: Copy this from the TNEW Administration Site.
   
   Passphrase: Copy this from the TNEW Administration Site.
   
   
5. Click "Update".

4. InstantEncore completes the setup

InstantEncore needs 1-2 business days to configure our servers for Shared Session. We will notify you when this is complete.

5. Test

1. Log into your InstantEncore account and go to the Shared Session page (Control Panel > InstantApps > Tessitura > Shared Session > Manage).
   
   
2. Click the "Test" button. You should see a success message. 

6. Enable Shared Session

1. Click the "Enable" button on the Shared Session page.

Viewing Logs

The Logs section is under the Checklist on the Shared Session page. This summarizes recent Shared Session activity. To view more details click the "View Logs" button.

Once this is set-up, you can still retrieve your app ticket revenue, go to this article to learn how.