Créer une connexion authentifiée à l'hôte

Pour accéder à une base de données hébergée, OData requiert les éléments suivants :

  • FileMaker Server : utilisez un compte de fichier FileMaker avec un mot de passe défini dans la base de données hébergée.

  • FileMaker Cloud : utilisez le compte et le mot de passe Claris ID.

FileMaker Server

Pour définir une connexion à une base de données hébergée, utilisez l'une des URL de l'API OData définies et l'en-tête Authorization :

  • URL :

    Par exemple, https://hôte/fmi/odata/v4/nom-base/$metadata

    • hôte : nom d'hôte de FileMaker Server.

    • nom-base : nom de la base de données FileMaker Pro.

  • En-tête :

    Authorization : Basic compte:mot de passe

    • compte:mot de passe : chaîne codée en base64 représentant le nom du compte, un signe deux-points (:) et le mot de passe utilisé pour se connecter à la base de données hébergée. Cela suit le schéma d'authentification HTTP Basic standard. Par exemple, si le nom du compte est admin et le mot de passe est admin, alors cette valeur est la valeur codée en base64 de admin:admin, c'est-à-dire YWRtaW46YWRtaW4=.

    Dans cet exemple, la valeur de l'en-tête Authorization est :

    Basic YWRtaW46YWRtaW4=

FileMaker Cloud

Pour définir une connexion à une base de données hébergée :

  1. Générez un jeton Claris ID pour une authentification externe. Consultez la section Utilisation de Claris ID pour l'authentification externe dans l'aide de la Claris Customer Console.

  2. Incluez le jeton Claris ID de l'étape 1 dans l'en-tête Authorization pour tous les appels OData.

Utilisez l'une des URL de l'API OData définies et l'en-tête Authorization :

  • URL :

    Par exemple, https://hôte/fmi/odata/v4/nom-base/$metadata

    • hôte : nom d'hôte FileMaker Cloud.

    • nom-base : nom de la base de données FileMaker Pro.

  • En-tête :

    Authorization : FMID Jeton_Claris_ID

Remarques 

  • Pour FileMaker Cloud, vous devez d'abord vous authentifier à l'aide de votre compte Claris ID et récupérer les jetons de session requis. Les jetons sont valables pendant une heure. Si cela fait plus d'une heure depuis la dernière authentification Claris ID, il se peut que les appels API échouent avec une erreur 401. Pour résoudre le problème, authentifiez-vous à nouveau à l'aide de votre compte Claris ID et récupérez les nouveaux jetons de session.