Welcome to the Filmchief Developer Help Center

API reference, tools and resources for developers

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 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.

{{#files}} {{/files}}