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

Nom de la propriété	Type manipulé	Effet
Versions 26 et supérieures Actualisation Nouveauté 26 Actualisation 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 rafraichir le token : il faudra alors redemander un nouveau token.
Versions 26 et supérieures DateExpiration Nouveauté 26 DateExpiration DateExpiration	DateHeure	Date et heure d'expiration du token.
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 :
  

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

  Versions 24 et supérieures <Variable AuthToken>.OpenIDLitIdentité Nouveauté 24 <Variable AuthToken>.OpenIDLitIdentité <Variable AuthToken>.OpenIDLitIdentité	Récupère l'identité d'un utilisateur contenue dans une variable de type AuthToken.