Passer au contenu principal
Vous consultez la documentation pour développeurs
Cette documentation est destinée aux développeurs travaillant avec la plateforme développeur Base44. Pour des informations sur les connecteurs dans l’éditeur d’applications, consultez Utilisation des connecteurs.
Les connecteurs d’utilisateur d’application permettent à chaque utilisateur connecté de l’application de connecter son propre compte tiers. Chaque utilisateur d’application obtient son propre jeton OAuth. Utilisez ceci lorsque les actions doivent se produire en tant qu’utilisateur individuel de l’application, comme envoyer un e-mail depuis son compte Gmail, publier sur son LinkedIn personnel ou lire ses propres événements Google Calendar. Contrairement aux connecteurs partagés, où un seul compte est partagé entre tous les utilisateurs de l’application, les connecteurs d’utilisateur d’application stockent un jeton OAuth distinct par utilisateur. Le flux OAuth s’exécute sous votre application OAuth enregistrée, de sorte que les utilisateurs de l’application voient le nom de votre application sur l’écran de consentement du fournisseur.
Les connecteurs d’utilisateur d’application nécessitent un plan Builder ou supérieur.

Configurer

Avant que les utilisateurs de l’application puissent connecter leurs comptes, enregistrez les identifiants de votre application OAuth dans votre workspace. Ceci nécessite un accès administrateur du workspace. Vous avez également besoin d’un ID client et d’un secret client du service externe. Enregistrez le connecteur depuis les paramètres de votre workspace. Consultez Configuration des connecteurs pour les utilisateurs de l’application pour des instructions étape par étape. Après avoir enregistré le connecteur, le workspace lui attribue un ID. Utilisez cet ID pour connecter et déconnecter les utilisateurs de l’application dans votre code frontend et récupérer leurs jetons dans vos fonctions backend.

Se connecter et se déconnecter dans votre frontend

Utilisez base44.connectors dans votre code frontend pour démarrer et terminer le flux OAuth pour chaque utilisateur de l’application. Pour connecter un utilisateur d’application, appelez connectAppUser avec l’ID du connecteur. Cela retourne une URL de redirection. Naviguez l’utilisateur de l’application vers cette URL pour démarrer le flux OAuth.
const redirectUrl = await base44.connectors.connectAppUser("YOUR_CONNECTOR_ID");
window.location.href = redirectUrl;
Une fois que l’utilisateur de l’application a terminé le flux, son jeton est stocké et vos fonctions backend peuvent le récupérer.
Pour déconnecter un utilisateur d’application, appelez disconnectAppUser avec l’ID du connecteur. Cela supprime le jeton stocké pour l’utilisateur de l’application actuellement connecté.
await base44.connectors.disconnectAppUser("YOUR_CONNECTOR_ID");

Récupérer le jeton dans une fonction backend

Utilisez createClientFromRequest() pour créer le client SDK dans votre fonction backend. Il lit automatiquement l’identité de l’utilisateur de l’application à partir de la requête entrante, de sorte que le SDK sait quel jeton d’utilisateur retourner. Appelez ensuite getCurrentAppUserConnection() avec l’ID du connecteur pour récupérer le jeton pour l’utilisateur de l’application faisant la requête actuelle.
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);
}

Voir aussi

Cette page a été traduite à l’aide de l’IA. Pour les informations les plus précises et à jour, consultez la version anglaise.