Apache Adobe Flex TutorialTutoriaux Adobe Flex & AIR en Français

AFCS – Tutorial Introduction à AFCS avec Flex (4 – Authentification et Session)

Suite du tutorial AFCS – Tutorial Introduction à AFCS avec Flex (1), AFCS – Tutorial Introduction à AFCS avec Flex (2 – Préparer la room et Flex Builder) et AFCS – Tutorial Introduction à AFCS avec Flex (3 – Les composants de base Pods) traduction de Introduction to Adobe Flash Collaborative Services par Romin Irani.

Dans les tutoriaux Flex précédents, on a vu comment développer une application AFCS simple avec quelques Pods. On va maintenant voir comment gérer l'authentification (login) et les évènements de base d'AFCS.
Dans les exemples précédents, on utilisait la classe AdobeHSAuthenticator présente dans le package com.adobe.rtc.authentication comme ceci:

<rtc:AdobeHSAuthenticator id="auth"
                          userName="...Nom d'Utilisateur..."
                          password="...Password..."/>

Ce n'est pas un bon mécanisme d'authentification, qui ne devrait uniquement être utilisé pour les tests développeurs et pas pour une application en ligne. En effet, vous ne voulez pas coder en dur vos propres informations de compte AFCS .

Le scénario idéal voudrait que l'utilisateur rentre ses propres informations soit comme invité (avec simplement un nom d'utilisateur), soit comme utilisateur authentifié (avec un couple nom d'utilisateur/password). AFCS gère cela grâce aux classes suivantes:

• Pour s'enregistrer comme invité (guest), il faut seulement fixer la valeur de l'attribut "userName". Fixez l'attribut "password" à null.
• Pour s'enregistrer comme utilisateur authentifié, vous devez donner un userName et un password comme on l'a fait jusque là. Le seul souci est que ce service d'authentification (ici AdobeHSAuthenticator) identifie seulement les couples nom d'utilisateur/password issus d'AFCS.

Utiliser un authentification externe (External Authentication)

Si vous le voulez, vous pouvez utiliser votre propre mécanisme d'authentification, et ne pas utiliser la classe AdobeHSAuthenticator. Dans ce cas, on parle d'External Authentication. Cela est bien sûr supporté par AFCS.

Cela veut dire que votre application côté serveur est capable de fournir son propre mécanisme d'authentification et d'interagir avec le service AFCS. AFCS fournit aussi des scripts serveur présents dans le dossier extras/scripts/ du SDK. On ne va pas couvrir l'External Authentication dans cet article. Il fera l'objet d'un tutorial Flex avancé.

Souvenez vous, dans le tutorial précédent, de l'utilisation de la classe ConnectSessionContainer. Cette classe est primordiale car elle gère les aspects suivants:

• La classe ConnectSessionContainer (présente dans le package com.adobe.rtc.session) va tenter une authentification à sa création. Cela se produit uniquement si l'attribut autoLogin est fixé à true. Il utilise une référence vers la classe AdobeHSAuthenticator pour faire son authentification. Vous devez spécifier la room à laquelle il doit se connecter via l'attribut roomURL.
• Si l'authentification se passe bien, le CSC va contenir une session sur la room. Que l'authentification réussisse ou non, un évènement de type com.adobe.rtc.events.AuthenticationEvent sera envoyé. Vous pouvez donc écouter cet évènement dans votre application Flex pour y répondre de manière appropriée.
• Si l'authentification se passe bien, le CSC va créer une session sur la room et tous les Pods AFCS vont se synchroniser avec n'importe quelle donnée présente dans la room (par exemple, les messages de Chat). Vous pouvez être notifié de la bonne synchronisation via la classe Event com.adobe.rtc.events.SessionEvent (voir plus loin). C'est une bonne pratique de rendre le conteneur visible (le CSC en principe) seulement lorsque la Session a bien été synchronisée.

Modifions maintenant notre exemple AFCS afin qu'il gère:

• Authentification utilisateur (invité ou compte AFCS)
• Écouter les évènements AuthenticationEvent et SessionEvent et y répondre