Etablissement d'une connexion HTTP authentifiée par formulaire

Pour établir une connexion HTTP avec une authentification par formulaire, activez une stratégie de connexion sortante pour l'authentification par formulaire.

Pourquoi et quand exécuter cette tâche

Les paramètres de l'exemple de fragment de code suivant activent une stratégie de connexion sortante pour l'authentification par formulaire. L'exemple suppose que le site http://the_remote_server.com/login-form-protected/ est protégé par une authentification par formulaire. Le formulaire est envoyé par une URL d'action https://the_remote_server.com/doLogin.php.

<policy url="http://the_remote_server.com/login-form-protected/*" >	
     <meta-data>
          <name>hpaa.authtype</name>
          <value>form</value>
     </meta-data>
     <meta-data>
          <name>hpaa.slotid</name>
          <value>OutboundConnectionCredentials</value>
     </meta-data>
     <meta-data>
          <name>forward-credentials-from-vault</name>
          <value>true</value>
     </meta-data>
     <meta-data>
          <name>form-action-url</name>
          <value>https://the_remote_server.com/doLogin.php</value>
     </meta-data>
     <meta-data>
          <name>form-field-name-user</name>
          <value>user_id</value>
     </meta-data>
     <meta-data>
          <name>form-field-name-password</name>
          <value>user_id_password</value>
     </meta-data>
     <meta-data>
          <name>form-additional-fields</name>
          <value>param1=value1,param2=value2</value>
          </meta-data>
     <meta-data>
          <name>form-session-cookies</name>
          <value>sessioncookie1,sessioncookie2</value>
     </meta-data>
</policy>

Définissez les paramètres de métadonnées suivants selon vos besoins :

hpaa.slotid: Ce paramètre permet d'indiquer l'ID emplacement du coffre des identifications. Pour des informations sur la manière de fournir les données d'identification de l'utilisateur de la connexion distante, consultez Indication des données d'identification de l'utilisateur pour les connexions authentifiées.
forward-credentials-from-vault: Ce paramètre permet d'indiquer que les données d'identification de l'authentification par formulaire sont collectées dans le coffre des identifications.
form-action-url: Utilisez ce paramètre pour spécifier l'URL à laquelle sont soumises les données de formulaire.
form-field-name-user: Utilisez ce paramètre pour spécifier l'ID de la balise <input> HTML qui contient l'ID utilisateur. Dans l'exemple précédent, la valeur spécifiée est user_id.
form-field-name-password: Utilisez ce paramètre pour spécifier l'ID de la balise <input> HTML qui contient le mot de passe. Dans l'exemple précédent, la valeur spécifiée est user_id_password.
form-additional-fields: Utilisez ce paramètre pour indiquer les noms des éléments d'entrée HTML supplémentaire qui figurent dans le formulaire. Dans l'exemple précédent, les éléments spécifiés sont param1=value1 et param2=value2.
form-session-cookies: Utilisez ce paramètre pour spécifier les noms des cookies de session qui sont reçus depuis le serveur distant comme éléments d'en-têtes Set-Cookie lorsque le formulaire est soumis et l'authentification aboutit. Dans l'exemple précédent, les cookies indiqués sont sessioncookie1 et sessioncookie2.