Propriétés spécifiques à la description des variables de type AuthToken

Nom de la propriété	Type manipulé	Effet
Actualisation	Chaîne de caractères	Valeur renvoyée par le serveur permettant de savoir si le token peut être renouvelé. Si cette propriété n'est pas renseignée, il ne sera pas possible d'utiliser la fonction AuthRenouvelleToken pour rafraîchir le token : il faudra alors redemander un nouveau token. Cette propriété est désormais disponible.
DateExpiration	DateHeure	Date et heure d'expiration du token. Cette propriété est désormais disponible.
RéponseServeur	Buffer	Valeur renvoyée par le serveur lors de la demande du token d'accès. Cette propriété est disponible en lecture seulement.
Valeur	Chaîne de caractères	Token d'accès. Valeur automatiquement remplie lors de l'utilisation de la fonction AuthIdentifie. Cette valeur peut être utilisée pour envoyer des requêtes authentifiées sur le service Web concerné.
Valide	Booléen	Validité du token d'accès : Vrai si le token d'accès est valide. Faux dans le cas contraire. Cette propriété est disponible en lecture seulement.

Fonctionnement de l'authentification OAuth 2.0

• Exécution d'une première requête HTTP pour demander une autorisation (URL d'autorisation spécifiée dans la variable de type OAuth2Paramètres).
• Ouverture d'une fenêtre d'identification de l'utilisateur conformément au protocole OAuth 2.0. L'interface d'identification est donnée par le service accédé.
• Après identification, le serveur retourne un premier code d'autorisation permettant de demander un token d'accès aux ressources. Ce code est ajouté en paramètre de la deuxième URL (URL de token d'accès spécifiée dans la variable de type OAuth2Paramètres).
• Exécution de la seconde requête HTTP pour demander le token d'accès. Le résultat est un buffer JSON qui contient, entre autres, le token d'accès ("access_token") à utiliser pour les requêtes authentifiées. La variable de type AuthToken contient les informations contenues dans ce buffer JSON. Ce token d'accès sera utilisé par les appels aux APIs du service Web.

• Si le serveur ne renvoie pas le token d'accès sous forme de code JSON conformément à la norme OAuth2.0, une erreur sera générée et le token ne sera pas récupéré. Il est possible de récupérer la réponse du serveur via la propriété RéponseServeur de la variable de type AuthToken.
• Si le serveur ne gère pas l'entête HTTP "Authorization" pour la transmission du token d'accès, cette transmission doit être faite par le développeur selon le format attendu par le service demandé.
  L'exemple suivant permet d'utiliser le service Web de Facebook. Dans ce cas, le token d'accès doit être précisé sur l'URL de la requête.
  • Exemple de code pour Facebook
    

    // Exemple permettant de récupérer le nom du compte Facebook
    MonToken est un AuthToken
    MonTokenParam est un OAuth2Paramètres
    
    MonTokenParam.ClientID = "123456789012345"
    MonTokenParam.ClientSecret = "45g8jh5kll45579021qsg5444j"
    MonTokenParam.URLAuth = "https://www.facebook.com/dialog/oauth"
    MonTokenParam.URLToken = "https://graph.facebook.com/v2.3/oauth/access_token"
    MonTokenParam.URLRedirection = "http://localhost:9874/"
    MonTokenParam.Scope = "email"
    
    MonToken = AuthIdentifie(MonTokenParam)
    SI MonToken <> Null ALORS
    	SI ErreurDétectée ALORS
    		Erreur(ErreurInfo())
    	SINON
    		// Token précisé sur l'URL de la requête
    		HTTPRequête("https://graph.facebook.com/me?access_token=" + MonToken.Valeur)
    		vMonRes est un Variant = JSONVersVariant(HTTPDonneRésultat(httpRésultat))
    		// Récupération du nom du compte
    		Trace(vMonRes.name)
    	FIN
    FIN

  • Exemple de code pour Facebook :
    

    MonToken est un AuthToken
    MonTokenParam est un OAuth2Paramètres
    MonTokenParam.ClientID = "1705548803004741"
    MonTokenParam.ClientSecret = "7b3305a5aa1687ef04af001ec3388ecc"
    MonTokenParam.URLAuth = "https://www.facebook.com/dialog/oauth"
    MonTokenParam.URLToken = "https://graph.facebook.com/oauth/access_token"
    MonTokenParam.URLRedirection = "fb1705548803004741://authorize/"
    MonTokenParam.Scope = "email"
    
    MonToken = AuthIdentifie(MonTokenParam)
    SI MonToken <> Null ALORS
    	SI ErreurDétectée ALORS
    		Erreur(ErreurInfo())
    	SINON
    		// Token précisé sur l'URL de la requête
    		HTTPRequête("https://graph.facebook.com/me?access_token=" + MonToken.Valeur)
    		vMonRes est un Variant = JSONVersVariant(HTTPDonneRésultat(httpRésultat))
    		// Récupération du nom du compte
    		Trace(vMonRes.name)
    	FIN
    FIN

Utilisation des variables de type AuthToken

• syntaxe classique :
  

  AuthIdentifie	Effectue une authentification utilisant le protocole OAuth 2.0 sur un webservice quelconque.
  OpenIDLitIdentité	Récupère l'identité d'un utilisateur contenue dans une variable de type AuthToken.
• syntaxe préfixée :
  

  <Variable AuthToken>.OpenIDLitIdentité	Récupère l'identité d'un utilisateur contenue dans une variable de type AuthToken.