Vai al contenuto principale
Stai visualizzando la documentazione per sviluppatori
Questa documentazione è rivolta agli sviluppatori che lavorano con la piattaforma per sviluppatori Base44. Per informazioni sui connettori nell’editor dell’app, consulta Uso dei connettori.
I connettori per utente dell’app consentono a ogni utente autenticato di collegare il proprio account di terze parti. Ogni utente dell’app ottiene il proprio token OAuth. Usali quando le azioni devono avvenire come singolo utente, ad esempio inviare email dal proprio account Gmail, pubblicare sul proprio LinkedIn personale o leggere i propri eventi di Google Calendar. A differenza dei connettori condivisi, in cui un unico account viene condiviso tra tutti gli utenti dell’app, i connettori per utente dell’app memorizzano un token OAuth separato per ciascun utente. Il flusso OAuth viene eseguito con la tua applicazione OAuth registrata, quindi gli utenti dell’app vedono il nome della tua app nella schermata di consenso del provider.
I connettori per utente dell’app richiedono un piano Builder o superiore.

​
Configurazione

Prima che gli utenti dell’app possano collegare i propri account, registra le credenziali dell’app OAuth nel tuo workspace. È richiesto l’accesso come amministratore del workspace. Ti serve anche un client ID e un client secret dal servizio esterno. Registra il connettore da Workspace Settings. Consulta Configurazione dei connettori per gli utenti dell’app per istruzioni passo passo. Dopo aver registrato il connettore, il workspace gli assegna un ID. Usa quell’ID per collegare e scollegare gli utenti dell’app nel codice frontend e per recuperare i loro token nelle funzioni backend.

​
Collegare e scollegare nel frontend

Usa base44.connectors nel codice frontend per avviare e terminare il flusso OAuth per ciascun utente dell’app. Per collegare un utente dell’app, chiama connectAppUser con l’ID del connettore. Restituisce un URL di reindirizzamento. Reindirizza l’utente a quell’URL per avviare il flusso OAuth. 
const redirectUrl = await base44.connectors.connectAppUser("YOUR_CONNECTOR_ID");
window.location.href = redirectUrl;
Dopo che l’utente completa il flusso, il suo token viene memorizzato e le tue funzioni backend possono recuperarlo.
Per scollegare un utente dell’app, chiama disconnectAppUser con l’ID del connettore. Rimuove il token memorizzato per l’utente attualmente autenticato. 
await base44.connectors.disconnectAppUser("YOUR_CONNECTOR_ID");

​
Recuperare il token in una funzione backend

Usa createClientFromRequest() per creare il client SDK nella tua funzione backend. Legge automaticamente l’identità dell’utente dalla richiesta in ingresso, quindi l’SDK sa quale token utente restituire. Poi chiama getCurrentAppUserConnection() con l’ID del connettore per recuperare il token dell’utente che sta effettuando la richiesta corrente. 
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);
}

​
Vedi anche

Questa pagina è stata tradotta utilizzando l’IA. Per informazioni più accurate e aggiornate, consulta la versione inglese.