Accedere alla sessione di un database utilizzando un provider di identità OAuth

Per accedere a un database ospitato utilizzando un provider di identità OAuth, utilizzare un endpoint API che punti al database. Utilizzare le stringhe X-FM-Data-OAuth-Request-Id e X-FM-Data-OAuth-Identifier nell'intestazione per autenticare l'accesso al database ospitato. Se l'autenticazione viene accettata, si riceve una risposta corrispondente dall'endpoint API.

Metodo HTTP POST

URL

https://host/fmi/odata/versione/nome-database/$metadata

host – nome dell'host FileMaker Server

versione – versione OData, sempre v4

nome-database – nome del database ospitato

Intestazione HTTP

Content-Type: application

X-FM-Data-OAuth-Request-Id: id-richiesta

X-FM-Data-OAuth-Identifier: parametro-identificativo

Per ricavare i parametri OAuth in formato JSON:

  1. Ricavare l'elenco dei provider OAuth supportati utilizzando un metodo GET HTTP con questo URL:

    https://host/fmws/oauthproviderinfo

    dove host è l'indirizzo IP o il nome di dominio della macchina primaria nella distribuzione di FileMaker Server. L'elenco viene restituito in formato JSON.

  2. Selezionare un provider OAuth supportato.

  3. Ottenere l'ID di monitoraggio per la sessione. Utilizzare un metodo GET HTTP con questo URL:

    http://host/oauth/getoauthurl?trackingID=ID-monitoraggio&provider=provider-OAuth&address=127.0.0.1&X-FMS-OAuth-AuthType=2

    dove host è l'indirizzo IP o il nome di dominio della macchina primaria nella distribuzione di FileMaker Server, ID-monitoraggio è l'ID di monitoraggio generato dallo sviluppatore per la sessione e provider-OAuth è il nome del provider OAuth selezionato.

    L'intestazione HTTP per questa richiesta deve includere quanto segue:

    • X-FMS-Application-Type: 9

    • X-FMS-Application-Version: 15

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

  4. Leggere l'intestazione di risposta per i dati X-FMS-Request-ID. Questa intestazione di risposta contiene l'ID della richiesta OAuth da utilizzare per la stringa X-FM-Data-OAuth-Request-Id nell'intestazione.

  5. Leggere il corpo della risposta per i dati X-FMS-Return-URL. Chiamare l'URL restituito in questo parametro per permettere all'utente di eseguire l'autenticazione con il provider OAuth.

  6. L'"identificativo" restituito dal provider OAuth è il parametro identificativo OAuth da utilizzare per la stringa X-FM-Data-OAuth-Identifier nell'intestazione.

Vedere Modifica dell'accesso tramite account OAuth nella Guida di FileMaker Pro.