Se connecter à une session de base de données avec un fournisseur d'identité OAuth

Pour vous connecter à une base de données hébergée à l'aide d'un fournisseur d'identité OAuth, utilisez un point de terminaison d'API pointant vers la base de données. Utilisez les chaînes X-FM-Data-OAuth-Request-Id et X-FM-Data-OAuth-Identifier dans l'en-tête pour authentifier l'accès à la base de données hébergée. Si l'authentification est acceptée, vous recevrez une réponse correspondante du point de terminaison de l'API.

Méthode HTTP	POST
URL	https://hôte/fmi/odata/version/nom-base/$metadata hôte : nom d'hôte FileMaker Server. version : version OData, toujours v4. nom-base : nom de la base de données hébergée.
En-tête HTTP	Content-Type: application X-FM-Data-OAuth-Request-Id: id-requête X-FM-Data-OAuth-Identifier: paramètre-identifiant

Pour obtenir les paramètres OAuth au format JSON :

1. Obtenez la liste des fournisseurs OAuth pris en charge au moyen d'une méthode HTTP GET avec l'URL suivante :

   https://hôte/fmws/oauthproviderinfo

   où hôte correspond à l'adresse IP ou au nom de domaine de la machine primaire de votre déploiement FileMaker Server. Cette liste est renvoyée au format JSON.

2. Choisissez un fournisseur OAuth pris en charge.

3. Obtenez l'identifiant de suivi de votre session. Utilisez une méthode HTTP GET avec l'URL suivante :

   http://hôte/oauth/getoauthurl?trackingID=ID-suivi&provider=fournisseur-OAuth&address=127.0.0.1&X-FMS-OAuth-AuthType=2

   où hôte correspond à l'adresse IP ou au nom de domaine de la machine primaire de votre déploiement FileMaker Server, ID-suivi est l'identifiant de suivi généré par le développeur pour votre session et fournisseur-OAuth est le nom du fournisseur OAuth sélectionné.

   L'en-tête HTTP de cette requête doit inclure les éléments suivants :

   • X-FMS-Application-Type : 9

   • X-FMS-Application-Version : 15

   • X-FMS-Return-URL : http://127.0.0.1/

4. Lisez l'en-tête de réponse des données X-FMS-Request-ID. Il contient l'identifiant de requête OAuth que vous utiliserez pour la chaîne X-FM-Data-OAuth-Request-ID de l'en-tête.

5. Lisez le corps de la réponse des données X-FMS-Return-URL. Appelez l'URL renvoyée dans ce paramètre pour autoriser l'utilisateur à s'authentifier auprès du fournisseur OAuth.

6. L'« identifiant » renvoyé par le fournisseur OAuth est le paramètre d'identifiant OAuth que vous utiliserez pour la chaîne X-FM-Data-OAuth-Identifier de l'en-tête.

Consultez la section Modification de l'accès des comptes OAuth dans l'aide de FileMaker Pro.