Zum Inhalt

Strapi-Zugangsdaten#

Sie können diese Zugangsdaten verwenden, um die folgenden Nodes zu authentifizieren:

Voraussetzungen#

Erstellen Sie ein Strapi Admin-Konto mit:

  • Zugriff auf ein bestehendes Strapi-Projekt.
  • Mindestens einem Collection-Typ innerhalb dieses Projekts.
  • Veröffentlichte Daten innerhalb dieses Collection-Typs.

Weitere Informationen finden Sie im Strapi-Entwickler- Schnellstart-Leitfaden.

Unterstützte Authentifizierungsmethoden#

  • API-Benutzerkonto: Erfordert ein Benutzerkonto mit entsprechenden Inhaltsberechtigungen.
  • API-Token: Erfordert ein Admin-Konto.

Zugehörige Ressourcen#

Weitere Informationen zum Dienst finden Sie in der Strapi-Dokumentation.

Verwenden eines API-Benutzerkontos#

Um diese Zugangsdaten zu konfigurieren, benötigen Sie:

  • Eine Benutzer- E-Mail: Muss für ein Benutzerkonto sein, nicht für ein Admin-Konto. Weitere Informationen finden Sie in den detaillierteren Anweisungen unten.
  • Ein Benutzer- Passwort: Muss für ein Benutzerkonto sein, nicht für ein Admin-Konto. Weitere Informationen finden Sie in den detaillierteren Anweisungen unten.
  • Die URL: Verwenden Sie die öffentliche URL Ihres Strapi-Servers, die in ./config/server.js als url-Parameter definiert ist. Strapi empfiehlt die Verwendung einer absoluten URL.
    • Verwenden Sie für Strapi Cloud-Projekte die URL Ihres Cloud-Projekts, z. B.: https://my-strapi-project-name.strapiapp.com
  • Die API-Version: Wählen Sie die Version der API aus, die Ihre Aufrufe verwenden sollen. Zu den Optionen gehören:
    • Version 3
    • Version 4

In Strapi umfasst die Konfiguration zwei Schritte:

  1. Konfigurieren einer Rolle.
  2. Erstellen eines Benutzerkontos.

Weitere Informationen zu den einzelnen Schritten finden Sie in den detaillierteren Anweisungen unten.

Konfigurieren einer Rolle#

Verwenden Sie für den API-Zugriff das Plugin Benutzer & Berechtigungen unter Einstellungen > Benutzer & Berechtigungen Plugin.

Weitere Informationen zum Plugin finden Sie unter Konfigurieren des Plugins Benutzer & Berechtigungen. Weitere Informationen zu Rollen finden Sie unter Konfigurieren von Endbenutzerrollen.

Für die Localmind Automate-Zugangsdaten muss der Benutzer über eine Rolle verfügen, die ihm API-Berechtigungen für den Collection-Typ gewährt. Für die Rolle können Sie entweder:

  • Aktualisieren Sie die Standardrolle Authentifiziert, um die Berechtigungen einzuschließen, und weisen Sie den Benutzer dieser Rolle zu. Weitere Informationen finden Sie unter Konfigurieren der Berechtigungen einer Rolle.
  • Erstellen Sie eine neue Rolle, um die Berechtigungen einzuschließen, und weisen Sie den Benutzer dieser Rolle zu. Weitere Informationen finden Sie unter Erstellen einer neuen Rolle.

Für beide Optionen gilt: Sobald Sie die Rolle geöffnet haben:

  1. Gehen Sie zum Abschnitt Berechtigungen.
  2. Öffnen Sie den Abschnitt für den relevanten Collection-Typ.
  3. Wählen Sie die Berechtigungen für den Collection-Typ aus, die die Rolle haben soll. Zu den Optionen gehören:
    • create (POST)
    • find und findone (GET)
    • update (PUT)
    • delete (DELETE)
  4. Wiederholen Sie dies für alle relevanten Collection-Typen.
  5. Speichern Sie die Rolle.

Weitere Informationen zu den Berechtigungsoptionen finden Sie unter Endpunkte.

Erstellen eines Benutzerkontos#

Nachdem Sie nun eine geeignete Rolle haben, erstellen Sie ein Endbenutzerkonto und weisen Sie ihm die Rolle zu:

  1. Gehen Sie zu Content Manager > Collection Types > User.
  2. Wählen Sie Add new entry.
  3. Füllen Sie die Benutzerdetails aus. Die Localmind Automate-Zugangsdaten erfordern diese Felder, obwohl Ihr Strapi-Projekt möglicherweise weitere benutzerdefinierte Pflichtfelder hat:
    • Username: Für alle Strapi-Benutzer erforderlich.
    • Email: Geben Sie diese in Strapi ein und verwenden Sie sie als Email in den Localmind Automate-Zugangsdaten.
    • Password: Geben Sie dies in Strapi ein und verwenden Sie es als Password in den Localmind Automate-Zugangsdaten.
    • Role: Wählen Sie die Rolle aus, die Sie im vorherigen Schritt eingerichtet haben.

Weitere Informationen finden Sie unter Verwalten von Endbenutzerkonten.

Verwenden eines API-Tokens#

Um diese Zugangsdaten zu konfigurieren, benötigen Sie:

  • Ein API-Token: Erstellen Sie ein API-Token unter Einstellungen > Globale Einstellungen > API-Token. Weitere Informationen zum Erstellen eines neuen API-Tokens und zum Regenerieren von API-Token finden Sie in der Strapi-Dokumentation Erstellen eines neuen API-Tokens.

    API tokens permission

    Wenn die Option API-Token unter Globale Einstellungen nicht angezeigt wird, verfügt Ihr Konto nicht über die Berechtigung API-Token > Lesen.

  • Die URL: Verwenden Sie die öffentliche URL Ihres Strapi-Servers, die in ./config/server.js als url-Parameter definiert ist. Strapi empfiehlt die Verwendung einer absoluten URL.

    • Verwenden Sie für Strapi Cloud-Projekte die URL Ihres Cloud-Projekts, z. B.: https://my-strapi-project-name.strapiapp.com
  • Die API-Version: Wählen Sie die Version der API aus, die Ihre Aufrufe verwenden sollen. Zu den Optionen gehören:
    • Version 3
    • Version 4