Single sign-on (SSO)
Getting started
Audience
This documentation is designed for people familiar with PHP programming and object-oriented programming concepts. You should also be familiar with Filmchief from a user's point of view. There are many PHP tutorials available on the Web.
Prerequisites
Before you start, make sure that you have everything you need.
- A Light, Standard or Premium Filmchief license
- A web server with PHP version 5.6 or higher
- A HTTPS-enabled website
How it works
With single sign-on, your festival website can detect whether your visitor is signed in on Filmchief, and read various properties such as selected language and the number of items in their shopping cart.
Whenever an event occurs that affects your visitor’s session information, Filmchief sends this information to your website by calling a script that you installed there. The script updates your PHP $_SESSION
object, in which you will find all the synchronized data.
Setting up the SSO connection
In Filmchief, visit the SSO setup guide which will take you through the entire process. You will find this guide at at System Settings Single sign-on synchronization URL.
The setup guide also provices examples on how to use the session information.
Signing in and out
To allow your visitors to sign in and out from your website.
To create a 'Sign in' link, use the following URL:
https://«FESTIVAL IDENTIFIER».filmchief.com/sign-in?lang=«LANGUAGE IDENTIFIER»&redirect-from=«RETURN URL»
parameters | |
---|---|
lang |
Type:
string ISO 639-1 (alpha-2) language code to be used on the sign in page and any related pages (e.g. the account registration form or the account activation page).
|
redirect-from |
Type:
string If set, the user will be redirected to this URL after having signed in (or registered) successfully. If not set, the user will be redirected to the Portal Home page.
|
Similarly, use the following URL to create a 'Sign out' link:
https://«FESTIVAL IDENTIFIER».filmchief.com/sign-in?lang=«LANGUAGE IDENTIFIER»
parameter | |
---|---|
lang |
Type:
string ISO 639-1 (alpha-2) language code to be used on the sign out page.
|
After the sign out, the browser will automatically return to the page it came from (based on the HTTP_REFERER
header). The redirect-from
parameter will be ignored.