Creare una connessione autenticata all'host

Per accedere a un database ospitato, OData richiede quanto segue:

  • FileMaker Server: utilizzare un account File FileMaker con una password definita nel database ospitato.

  • FileMaker Cloud: utilizzare l'account e la password dell'ID Claris.

FileMaker Server

Per definire una connessione a un database ospitato, utilizzare uno degli URL OData API definiti e l'intestazione Authorization:

  • URL:

    Ad esempio, https://host/fmi/odata/v4/nome-database/$metadata

    • host – nome dell'host FileMaker Server

    • nome-database – nome del database FileMaker Pro

  • Intestazione:

    Authorization: Basic account:password

    • account:password - la stringa con codifica Base64 che rappresenta il nome account, due punti (:) e la password utilizzata per accedere al database ospitato. Questo segue lo schema di autenticazione standard HTTP Basic. Ad esempio, se il nome account è admin e la password è admin, allora questo valore è il valore con codifica Base64 di admin:admin, ovvero YWRtaW46YWRtaW4=.

    In questo esempio, il valore dell'intestazione Authorization:

    Basic YWRtaW46YWRtaW4=

FileMaker Cloud

Per definire una connessione a un database ospitato:

  1. Generare un token ID Claris per l'autenticazione esterna. Vedere Utilizzo dell'ID Claris per l'autenticazione esterna nella Guida della Claris Customer Console.

  2. Includere il token ID Claris al passo 1 nell'intestazione Authorization per tutte le chiamate OData.

Usare uno degli URL OData API definiti e l'intestazione Authorization:

  • URL:

    Ad esempio, https://host/fmi/odata/v4/nome-database/$metadata

    • host – nome dell'host FileMaker Cloud

    • nome-database – nome del database FileMaker Pro

  • Intestazione:

    Authorization: FMID Token_ID_Claris

Note 

  • Per FileMaker Cloud, è necessario prima di tutto eseguire l'autenticazione utilizzando l'ID Claris e recuperare i token di sessione richiesti. I token sono validi per un'ora. Se è trascorsa più di un'ora dall'ultima autenticazione ID Claris, è possibile che le chiamate API falliscano e venga visualizzato l'errore 401. Per risolvere il problema, autenticarsi nuovamente con l'account ID Claris e recuperare i nuovi token di sessione.