Authentifizierung für FileMaker Cloud

FileMaker Admin API verwendet einen Zugriffstoken, um eine Verbindung zum Host zu definieren. Der Token ist so lange gültig, bis er entweder über den Aufruf „Invalidate Access Token“ ungültig gemacht wird oder bis 15 Minuten nach dem letzten Aufruf, der den Token angegeben hat. (Während der Token gültig ist, setzt jeder Aufruf, der den Token angibt, den Zähler für das Zeitlimit der Sitzung wieder zurück.)

So authentifizieren Sie Konten für FileMaker Cloud:

  1. Generieren Sie den Claris-ID Token. Siehe Claris Customer Console Hilfe.
  2. Schließen Sie den Claris-ID Token aus Schritt 1 im Authentifizierungsaufruf oder anderen Aufrufen mit ein, um einen Zugriffstoken zu generieren.

    Verwenden Sie zum Beispiel folgende URL und Header für den Authentifizierungsaufruf:

    • URL: https://host/fmi/admin/api/v2/user/auth

      Dabei ist host der Hostname bzw. die IP-Adresse des virtuellen Servers, auf dem FileMaker Cloud läuft.

    • Header: Authorization FMID Claris_ID_Token

    Wenn Sie den Authentifizierungsaufruf verwenden, wird der Zugriffstoken im Antwortteil zurückgegeben. Wenn Sie andere Aufrufe verwenden, wird der Token im Feld X-FM-Access-Token im Antwort-Header zurückgegeben.

  3. Schließen Sie für nachfolgende API-Aufrufe den folgenden Authorization-Header für den Authentifizierungsaufruf mit ein:

    Header: Authorization Bearer Zugriffstoken

Hinweise 

  • Jedes Mal, wenn Sie das Claris-ID Authentication-Schema verwenden, um einen Zugriffstoken abzurufen, wird eine neue API-Sitzung erstellt. Um zu vermeiden, dass mehrere API-Sitzungen aktiv sind, verwenden Sie den gleichen Zugriffstoken mit dem Bearer-Authentication-Schema für alle API-Aufrufe.

  • Um FileMaker 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.

  • Informationen zur Authentifizierung von Konten für das Hochladen von Apps in FileMaker Cloud oder das Aktualisieren einer eigenen App basierend auf Änderungen in einem Clone finden Sie unter Authentifizierung für FileMaker Cloud API-Aufrufe zum Hochladen oder Aktualisieren von Apps.