Zum Hauptinhalt springen
Du siehst gerade die Entwicklerdokumentation
Diese Dokumentation richtet sich an Entwickler, die mit der Base44-Entwicklerplattform arbeiten. Informationen zu Connectors im App-Editor findest du unter Connectors verwenden.
App-User-Connectors ermöglichen es jedem angemeldeten App-Benutzer, sein eigenes Drittanbieterkonto zu verbinden. Jeder App-Benutzer erhält seinen eigenen OAuth-Token. Verwende dies, wenn Aktionen als individueller App-Benutzer ausgeführt werden müssen, etwa E-Mails aus dem eigenen Gmail-Konto senden, in das eigene LinkedIn posten oder die eigenen Google-Calendar-Ereignisse lesen. Im Gegensatz zu Shared Connectors, bei denen ein Konto über alle App-Benutzer hinweg geteilt wird, speichern App-User-Connectors einen separaten OAuth-Token pro Benutzer. Der OAuth-Flow läuft unter deiner registrierten OAuth-Anwendung, sodass App-Benutzer den Namen deiner App auf dem Zustimmungs-Bildschirm des Providers sehen.
App-User-Connectors erfordern einen Builder plan oder höher.

Einrichten

Bevor App-Benutzer ihre Konten verbinden können, registriere die OAuth-App-Anmeldedaten in deinem Workspace. Dies erfordert Workspace-Admin-Zugriff. Du benötigst außerdem eine Client-ID und ein Client-Secret vom externen Dienst. Registriere den Connector in deinen Workspace-Einstellungen. Siehe Connectors für App-Benutzer einrichten für Schritt-für-Schritt-Anweisungen. Nachdem du den Connector registriert hast, weist der Workspace ihm eine ID zu. Verwende diese ID, um App-Benutzer in deinem Frontend-Code zu verbinden und zu trennen und ihre Tokens in deinen Backend-Funktionen abzurufen.

Im Frontend verbinden und trennen

Verwende base44.connectors in deinem Frontend-Code, um den OAuth-Flow für jeden App-Benutzer zu starten und zu beenden. Um einen App-Benutzer zu verbinden, rufe connectAppUser mit der Connector-ID auf. Dies gibt eine Redirect-URL zurück. Leite den App-Benutzer zu dieser URL, um den OAuth-Flow zu starten.
const redirectUrl = await base44.connectors.connectAppUser("YOUR_CONNECTOR_ID");
window.location.href = redirectUrl;
Nachdem der App-Benutzer den Flow abgeschlossen hat, wird sein Token gespeichert und deine Backend-Funktionen können es abrufen.
Um einen App-Benutzer zu trennen, rufe disconnectAppUser mit der Connector-ID auf. Dies entfernt den gespeicherten Token für den aktuell angemeldeten App-Benutzer.
await base44.connectors.disconnectAppUser("YOUR_CONNECTOR_ID");

Den Token in einer Backend-Funktion abrufen

Verwende createClientFromRequest(), um den SDK-Client in deiner Backend-Funktion zu erstellen. Er liest die Identität des App-Benutzers automatisch aus dem eingehenden Request, sodass das SDK weiß, welchen Benutzer-Token es zurückgeben soll. Rufe dann getCurrentAppUserConnection() mit der Connector-ID auf, um den Token für den App-Benutzer abzurufen, der die aktuelle Anfrage stellt.
import { createClientFromRequest } from "@base44/sdk";

export default async function handler(req: Request) {
  const base44 = createClientFromRequest(req);

  const { accessToken } =
    await base44.asServiceRole.connectors.getCurrentAppUserConnection(
      "YOUR_CONNECTOR_ID",
    );

  const response = await fetch(
    "https://www.googleapis.com/calendar/v3/calendars/primary/events",
    {
      headers: { Authorization: `Bearer ${accessToken}` },
    },
  );

  const events = await response.json();
  return Response.json(events);
}

Siehe auch

Diese Seite wurde mit KI übersetzt. Für die genauesten und aktuellsten Informationen siehe die englische Version.