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

• <Nom de la variable>..<Nom de la propriété>
• <Nom de la variable>.<Nom de la propriété>

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.