Anmelden bei einer Datenbanksitzung mithilfe eines Claris-ID Kontos (FileMaker Cloud)

Für Dateien, die FileMaker Cloud bereitstellt, werden Benutzer über Claris-ID Konten authentifiziert. Claris-ID Konten werden im Claris-ID Identitätsdienstleistersystem definiert.

Um sich bei einer bereitgestellten Datenbank mit einem Claris-ID Konto anzumelden, verwenden Sie eine HTTP POST-Methode mit dem API-Endpunkt sessions, der den Namen einer bereitgestellten Datenbank angibt. Der Claris-ID Token wird in einem Header-Authorization-String angegeben. Ihr Programmcode erhält 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

Authorization: FMID {FMID-token}

FMID-token ist der Claris-ID Token, den das Claris-ID Identitätsdienstleistersystem bereitstellt. Informationen zum Claris-ID Token finden Sie unter Verwenden der Claris-ID für die externe Authentifizierung in der Claris Customer Console Hilfe.

Siehe Bearbeiten des Claris-ID oder externen IdP-Kontozugriffs in der FileMaker Pro Hilfe.
Parameter Leeres Paar geschweifte Klammern. Beispiel: { }
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
Header
X-FM-Data-Access-Token: 823c0f48bb80f2187bde6f3859dabd4dcf8ea43be420dfeadf34
Kopieren
Body
{
  "response": {},
  "messages": [
    {
      "code": "0",
      "message": "OK"
    }
  ]
}

Siehe Fehlerantworten.

Hinweise 

  • Um FileMaker Data API-Aufrufe mit FileMaker Cloud zu verwenden, müssen Sie sich zunächst mit Ihrem Claris-ID Konto authentifizieren und die erforderlichen Sitzungstokens abrufen. Die Tokens sind eine Stunde lang gültig. Wenn seit der letzten Claris-ID Authentifizierung mehr als eine Stunde vergangen ist, können API-Aufrufe mit einem 401-Fehler fehlschlagen. Um das Problem zu beheben, authentifizieren Sie sich erneut mit dem Claris-ID Konto und rufen Sie neue Sitzungstokens ab.