Anmelden bei einer Datenbanksitzung mithilfe eines OAuth-Identitätsdienstleisters

Verwenden Sie für die Anmeldung bei einer bereitgestellten Datenbank über einen OAuth-Identitätsdienstleister eine HTTP POST-Methode mit dem API-Endpunkt sessions, der die Datenbank angibt. Geben Sie die Zeichenfolge X-FM-Data-OAuth-Request-Id und die Zeichenfolge X-FM-Data-OAuth-Identifier im Header an, um den Zugriff auf die bereitgestellte Datenbank zu authentifizieren. Wenn die Authentifizierung akzeptiert wird, erhält Ihr Programmcode einen Zugriffstoken, der Ihre Verbindung zu der Datenbank definiert. Bei dieser Verbindung handelt es sich um eine so genannte Datenbanksitzung.

HTTP-Methode

POST

URL

/fmi/data/version/databases/datenbankname/sessions

version – die angeforderte FileMaker Data API-Version, kann v1, v2 oder vLatest sein

datenbankname – der Name der bereitgestellten Datenbank

HTTP-Header

Content-Type: application/json

X-FM-Data-OAuth-Request-Id: Abfrage-ID

X-FM-Data-OAuth-Identifier: ID-Parameter
Parameter Leeres Paar geschweifte Klammern. Beispiel: { } Kann optional den Parameter fmDataSource für die Anmeldung bei einer externen Datenquelle verwenden. Siehe Anmeldung bei einer externen Datenquelle.
Antwort

Der Zugriffstoken, ein leerer Antworthauptteil und ein Meldungsarray mit dem Fehlercode 0.

Der Header X-FM-Data-Access-Token wird als Antwort zurückgegeben. Dabei handelt es sich um den Sitzungstoken, der für anschließende API-Aufrufe zu verwenden ist.

Beispiel:

Kopieren 
X-FM-Data-Access-Token: 823c0f48bb80f2187bde6f3859dabd4dcf8ea43be420dfeadf34
{
    "response": {},
    "messages":[{"code":"0","message":"OK"}]
}

Siehe Fehlerantworten.

So erhalten Sie die OAuth-Parameter in JSON-Format:

  1. Rufen Sie die Liste unterstützter OAuth-Dienstleister ab, indem Sie eine HTTP GET-Methode mit dieser URL verwenden:

    https://host/fmws/oauthproviderinfo

    Dabei steht host für die IP-Adresse oder den Domänennamen des Primär-Computers in Ihrem FileMaker Server-Einsatz. Die Liste wird in JSON-Format zurückgegeben.

  2. Wählen Sie einen unterstützten OAuth-Dienstleister.

  3. Holen Sie sich die Tracking-ID für Ihre Sitzung. Verwenden Sie eine HTTP GET-Methode mit dieser URL:

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

    Dabei steht host für die IP-Adresse bzw. den Domänennamen des Primär-Computers in Ihrem FileMaker Server-Einsatz, Tracking-ID für die vom Entwickler generierte Tracking-ID für Ihre Sitzung und OAuth-Dienstleister für den Namen des von Ihnen ausgewählten OAuth-Dienstleisters.

    Der HTTP-Header für diese Abfrage muss Folgendes beinhalten:

    • X-FMS-Application-Type: 9

    • X-FMS-Application-Version: 15

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

  4. Lesen Sie den Antwortheader für die X-FMS-Request-ID-Daten. Dieser Antwortheader enthält die OAuth-Request-ID, die Sie für die Zeichenfolge X-FM-Data-OAuth-Request-ID im Header verwenden werden.

  5. Lesen Sie den Antwortheader für die X-FMS-Return-URL-Daten. Rufen Sie die URL auf, die dieser Parameter zurückgibt, damit der Benutzer sich beim OAuth-Dienstleister authentifizieren kann.

  6. Der vom OAuth-Dienstleister zurückgegebene „Identifier“ ist der OAuth-Identifier-Parameter, den Sie für die Zeichenfolge X-FM-Data-OAuth-Identifier im Header verwenden werden.

Weitere Informationen finden Sie unter „Bearbeiten von OAuth-Kontozugriff“ in der FileMaker Pro Hilfe.