Impostazione - Twenty Documentation

Panoramica

Prima volta che installi? Segui la guida all’installazione di Docker Compose per far funzionare Twenty, quindi torna qui per la configurazione.

Twenty offre due modalità di configurazione per soddisfare diverse esigenze di distribuzione: Accesso al pannello di amministrazione: Solo gli utenti con privilegi di amministrazione (canAccessFullAdminPanel: true) possono accedere all’interfaccia di configurazione.

1. Configurazione del Pannello di Amministrazione (Predefinito)

IS_CONFIG_VARIABLES_IN_DB_ENABLED=true  # default

La maggior parte della configurazione avviene tramite l’interfaccia utente dopo l’installazione:

Accedi alla tua istanza Twenty (solitamente http://localhost:3000)
Vai a Impostazioni / Pannello di Amministrazione / Variabili di Configurazione
Configura integrazioni, email, storage e altro
Le modifiche hanno effetto immediato (entro 15 secondi per distribuzioni multi-container)

Distribuzioni Multi-Container: Quando si utilizza la configurazione del database (IS_CONFIG_VARIABLES_IN_DB_ENABLED=true), sia i container server che worker leggono dallo stesso database. Le modifiche al pannello di amministrazione influiscono su entrambi automaticamente, eliminando la necessità di duplicare le variabili di ambiente tra i container (eccetto per le variabili infrastrutturali).

Cosa puoi configurare tramite il pannello di amministrazione:

Autenticazione - Google/Microsoft OAuth, impostazioni della password
Email - Impostazioni SMTP, modelli, verifica
Storage - Configurazione S3, percorsi storage locale
Integrazioni - Gmail, Google Calendar, servizi Microsoft
Workflow e limitazione della frequenza - Limiti di esecuzione, throttling delle API
E molto altro ancora…

Variabili di Configurazione del Pannello di Amministrazione

Ogni variabile è documentata con descrizioni nel tuo pannello di amministrazione in Impostazioni → Pannello di Amministrazione → Variabili di Configurazione. Alcune impostazioni infrastrutturali come connessioni al database (PG_DATABASE_URL), URL del server (SERVER_URL) e segreti (ENCRYPTION_KEY, FALLBACK_ENCRYPTION_KEY) possono essere configurate solo tramite file .env.Riferimento tecnico completo →

Chiavi di crittografia

Twenty utilizza due chiavi di crittografia disponibili solo tramite variabili d’ambiente:

Variabile	Scopo	Obbligatorio
`ENCRYPTION_KEY`	Chiave primaria utilizzata per crittografare i segreti a riposo (token OAuth, variabili dell’applicazione, chiavi private delle chiavi di firma, segreti TOTP, valori di configurazione sensibili).	Sì per le nuove installazioni (le installazioni legacy possono invece fare affidamento su `APP_SECRET` — vedi sotto)
`FALLBACK_ENCRYPTION_KEY`	Chiave utilizzata solo per la verifica. Impostata durante una rotazione alla precedente `ENCRYPTION_KEY` in modo che le righe esistenti rimangano decifrabili.	Solo durante la rotazione

Per garantire la retrocompatibilità, se ENCRYPTION_KEY non è impostata, Twenty torna a utilizzare APP_SECRET per la crittografia a riposo, in modo da rispecchiare il comportamento legacy delle distribuzioni meno recenti. Le nuove installazioni dovrebbero sempre impostare una ENCRYPTION_KEY dedicata. Genera i valori con openssl rand -base64 32 e conservali in un luogo sicuro (un secrets manager, configurazioni sigillate, ecc.). Perdere ENCRYPTION_KEY significa perdere l’accesso a ogni segreto memorizzato nel database. Per ruotare ENCRYPTION_KEY senza tempi di inattività, consulta la guida alla rotazione delle chiavi.

2. Configurazione Solo-Ambiente

IS_CONFIG_VARIABLES_IN_DB_ENABLED=false

Tutta la configurazione gestita tramite file .env:

Imposta IS_CONFIG_VARIABLES_IN_DB_ENABLED=false nel tuo file .env
Aggiungi tutte le variabili di configurazione nel tuo file .env
Riavvia i container per applicare le modifiche
Il pannello di amministrazione mostrerà i valori attuali ma non potrà modificarli

Modalità multi-workspace

Per impostazione predefinita, Twenty viene eseguito in modalità a workspace singolo — ideale per la maggior parte delle distribuzioni self-hosted in cui è necessaria un’istanza di CRM per la tua organizzazione.

Modalità a workspace singolo (predefinita)

IS_MULTIWORKSPACE_ENABLED=false  # default

Un workspace per istanza di Twenty
Il primo utente diventa automaticamente amministratore con privilegi completi (canImpersonate e canAccessFullAdminPanel)
Le nuove registrazioni sono disabilitate dopo la creazione del primo workspace
Struttura URL semplice: https://your-domain.com

Abilitare la modalità multi-workspace

IS_MULTIWORKSPACE_ENABLED=true
DEFAULT_SUBDOMAIN=app  # default value

Abilita la modalità multi-workspace per distribuzioni in stile SaaS in cui più team indipendenti necessitano dei propri workspace sulla stessa istanza di Twenty. Differenze principali rispetto alla modalità a workspace singolo:

È possibile creare più workspace sulla stessa istanza
Ogni workspace ottiene il proprio sottodominio (ad es., sales.your-domain.com, marketing.your-domain.com)
Gli utenti si registrano e accedono su {DEFAULT_SUBDOMAIN}.your-domain.com (ad es., app.your-domain.com)
Nessun privilegio amministrativo automatico — il primo utente in ogni workspace è un utente normale
Le impostazioni specifiche del workspace, come sottodominio e dominio personalizzato, diventano disponibili nelle impostazioni del workspace

Impostazione solo per l’ambiente: IS_MULTIWORKSPACE_ENABLED può essere configurata solo tramite il file .env e richiede un riavvio. Non può essere modificata tramite il pannello di amministrazione.

Configurazione DNS per la modalità multi-workspace

Quando si utilizza la modalità multi-workspace, configura il DNS con un record wildcard per consentire la creazione dinamica dei sottodomini:

*.your-domain.com -> your-server-ip

Ciò abilita l’instradamento automatico dei sottodomini per i nuovi workspace senza configurazione DNS manuale.

Limitare la creazione di workspace

In modalità multi-workspace, potresti voler limitare chi può creare nuovi workspace:

IS_WORKSPACE_CREATION_LIMITED_TO_SERVER_ADMINS=true

Quando è abilitata, solo gli utenti con canAccessFullAdminPanel possono creare workspace aggiuntivi. Gli utenti possono comunque creare il loro primo workspace durante la registrazione iniziale.

Integrazione Gmail & Google Calendar

Crea Progetto nel Google Cloud

Vai a Google Cloud Console
Crea un nuovo progetto o seleziona uno esistente
Abilita queste API:

Configura OAuth

Vai a Credenziali
Crea ID client OAuth 2.0
Aggiungi questi URI di reindirizzamento:
- https://{your-domain}/auth/google/redirect (per SSO)
- https://{your-domain}/auth/google-apis/get-access-token (per integrazioni)

Configura in Twenty

Vai a Impostazioni → Pannello di Amministrazione → Variabili di Configurazione
Trova la sezione Google Auth
Imposta queste variabili:
- MESSAGING_PROVIDER_GMAIL_ENABLED=true
- CALENDAR_PROVIDER_GOOGLE_ENABLED=true
- AUTH_GOOGLE_CLIENT_ID={client-id}
- AUTH_GOOGLE_CLIENT_SECRET={client-secret}
- AUTH_GOOGLE_CALLBACK_URL=https://{your-domain}/auth/google/redirect
- AUTH_GOOGLE_APIS_CALLBACK_URL=https://{your-domain}/auth/google-apis/get-access-token

Modalità solo ambiente: Se imposti IS_CONFIG_VARIABLES_IN_DB_ENABLED=false, aggiungi queste variabili al tuo file .env invece.

Scope richiesti (configurati automaticamente): Vedi il codice sorgente pertinente

https://www.googleapis.com/auth/calendar.events
https://www.googleapis.com/auth/gmail.readonly
https://www.googleapis.com/auth/profile.emails.read

Se la tua app è in modalità di test

Se la tua app è in modalità di test, dovrai aggiungere utenti di prova al tuo progetto. Sotto Schermo di Consenso OAuth, aggiungi i tuoi utenti di prova nella sezione “Utenti di Prova”.

Integrazione Microsoft 365

Gli utenti devono avere una Licenza Microsoft 365 per poter utilizzare l’API Calendario e Messaggi. Non potranno sincronizzare il loro account su Twenty senza una.

Crea un progetto in Microsoft Azure

Avrai bisogno di creare un progetto in Microsoft Azure e ottenere le credenziali.

Abilita API

Nel Microsoft Azure Console abilita le seguenti API in “Permessi”:

Microsoft Graph: Mail.ReadWrite
Microsoft Graph: Mail.Send
Microsoft Graph: Calendars.ReadWrite
Microsoft Graph: User.Read
Microsoft Graph: openid
Microsoft Graph: email
Microsoft Graph: profile
Microsoft Graph: offline_access

Tutte queste autorizzazioni sono necessarie, anche se vuoi solo sincronizzare le email e gli eventi del calendario. Twenty richiede sempre “Mail.ReadWrite”, “Mail.Send” e “Calendars.ReadWrite” quando un utente collega il proprio account, quindi le autorizzazioni di sola lettura come “Mail.Read” o “Calendars.Read” non sono sufficienti.

Se il tuo tenant non consente agli utenti regolari di acconsentire a queste autorizzazioni, visualizzeranno l’errore AADSTS90094 quando collegano il proprio account. Un amministratore può risolvere il problema facendo clic su “Concedi il consenso dell’amministratore per ” nella pagina “Autorizzazioni API” della registrazione dell’app.

URI di Riindirizzamento Autorizzati

Devi aggiungere i seguenti URI di reindirizzamento al tuo progetto:

https://{your-domain}/auth/microsoft/redirect se vuoi usare Microsoft SSO
https://{your-domain}/auth/microsoft-apis/get-access-token

Configura in Twenty

Vai a Impostazioni → Pannello di Amministrazione → Variabili di Configurazione
Trova la sezione Microsoft Auth
Imposta queste variabili:
- MESSAGING_PROVIDER_MICROSOFT_ENABLED=true
- CALENDAR_PROVIDER_MICROSOFT_ENABLED=true
- AUTH_MICROSOFT_ENABLED=true
- AUTH_MICROSOFT_CLIENT_ID={client-id}
- AUTH_MICROSOFT_CLIENT_SECRET={client-secret}
- AUTH_MICROSOFT_CALLBACK_URL=https://{your-domain}/auth/microsoft/redirect
- AUTH_MICROSOFT_APIS_CALLBACK_URL=https://{your-domain}/auth/microsoft-apis/get-access-token

Modalità solo ambiente: Se imposti IS_CONFIG_VARIABLES_IN_DB_ENABLED=false, aggiungi queste variabili al tuo file .env invece.

Configura scope

Vedi il codice sorgente pertinente

‘openid’
‘email’
‘profilo’
‘offline_access’
‘Mail.ReadWrite’
‘Mail.Send’
‘Calendars.ReadWrite’
‘User.Read’

Se la tua app è in modalità di test

Se la tua app è in modalità di test, dovrai aggiungere utenti di prova al tuo progetto. Aggiungi i tuoi utenti di prova nella sezione “Utenti e gruppi”.

Lavori in Background per Calendario & Messaggistica

Dopo aver configurato le integrazioni di Gmail, Google Calendar o Microsoft 365, devi avviare i lavori in background che sincronizzano i dati. Registrare i seguenti lavori ricorrenti nel tuo container worker:

# from your worker container
yarn command:prod cron:messaging:messages-import
yarn command:prod cron:messaging:message-list-fetch
yarn command:prod cron:calendar:calendar-event-list-fetch
yarn command:prod cron:calendar:calendar-events-import
yarn command:prod cron:messaging:ongoing-stale
yarn command:prod cron:calendar:ongoing-stale
yarn command:prod cron:workflow:automated-cron-trigger

Connessioni in uscita verso host interni

Per impostazione predefinita, Twenty rifiuta le connessioni in uscita verso indirizzi IP privati/interni (protezione SSRF). Ciò copre le azioni dei flussi di lavoro HTTP, i webhook, i provider di identità SSO e le connessioni IMAP/SMTP/CalDAV. Se il provider di identità, il server di posta o il server di calendario viene eseguito su una rete privata, elencane il nome host o il letterale IP:

OUTBOUND_HTTP_ALLOWED_INTERNAL_HOSTS=keycloak,mail.internal,192.168.1.10

Le voci vengono confrontate solo in base al nome host, senza caratteri jolly: per un emittente OIDC come http://keycloak:8080/realms/twenty, elenca keycloak. Ogni altro indirizzo privato rimane bloccato e persino un host consentito non può mai raggiungere l’intervallo di indirizzi dei metadati cloud. Imposta la variabile su * per disabilitare completamente la protezione, operazione appropriata solo su reti affidabili e isolate. OUTBOUND_HTTP_SAFE_MODE_ENABLED è deprecata. Finché è impostata su false, la protezione rimane completamente disattivata e OUTBOUND_HTTP_ALLOWED_INTERNAL_HOSTS viene ignorata, quindi rimuovila quando esegui la migrazione all’elenco. Questo elenco non include gli allegati di file IA: immagini e PDF raggiungono il modello come link creati da SERVER_URL, recuperati dal provider di IA o dall’AI SDK nel worker, che rifiuta gli indirizzi privati. Affinché gli allegati funzionino, SERVER_URL deve essere pubblico; con un SERVER_URL localhost o privato, le chat e gli agenti IA funzionano solo con il testo.

Configurazione Email

Vai a Impostazioni → Pannello di Amministrazione → Variabili di Configurazione
Trova la sezione Email
Configura le impostazioni SMTP:

Gmail
Office365
smtp4dev

Avrai bisogno di provvedere una Password per l’App.

EMAIL_DRIVER=smtp
EMAIL_SMTP_HOST=smtp.gmail.com
EMAIL_SMTP_PORT=465
EMAIL_SMTP_USER=indirizzo_email_gmail
EMAIL_SMTP_PASSWORD=‘password_app_gmail’

smtp4dev è un server SMTP fittizio per lo sviluppo e il test.

Esegui l’immagine smtp4dev: docker run --rm -it -p 8090:80 -p 2525:25 rnwood/smtp4dev
Accedi all’interfaccia smtp4dev qui: http://localhost:8090
Imposta le seguenti variabili:
- EMAIL_DRIVER=smtp
- EMAIL_SMTP_HOST=localhost
- EMAIL_SMTP_PORT=2525

Modalità solo ambiente: Se imposti IS_CONFIG_VARIABLES_IN_DB_ENABLED=false, aggiungi queste variabili al tuo file .env invece.

Archiviazione S3

Per impostazione predefinita, Twenty archivia i file caricati nel file system locale. Per le distribuzioni in produzione, usa S3 o un servizio compatibile con S3 (MinIO, DigitalOcean Spaces, ecc.). per garantire che i file persistano tra i riavvii dei container e per poter scalare su più istanze server.

Imposta STORAGE_TYPE=S_3 e configura le variabili STORAGE_S3_* tramite il pannello di amministrazione o .env.

Variabile	Obbligatorio	Descrizione
`STORAGE_S3_REGION`	Sì	Regione del bucket: una regione AWS come `eu-west-3` oppure uno slug specifico del provider come `fr-par` per Scaleway.
`STORAGE_S3_NAME`	Sì	Nome del bucket.
`STORAGE_S3_ACCESS_KEY_ID`	No	Chiave di accesso di un utente IAM. Lasciare non impostato per utilizzare la catena di credenziali predefinita di AWS (vedere Credenziali).
`STORAGE_S3_SECRET_ACCESS_KEY`	No	Segreto per la chiave di accesso sopra indicata. Obbligatorio quando è impostato `STORAGE_S3_ACCESS_KEY_ID`.
`STORAGE_S3_ENDPOINT`	No	URL dell’endpoint personalizzato. Solo per servizi compatibili con S3 come `http://minio:9000` o per un endpoint di interfaccia VPC AWS. Lasciare non impostato per S3 AWS nativo, dove l’SDK ricava l’endpoint dalla regione.
`STORAGE_S3_PRESIGNED_URL_ENABLED`	No	Quando è `true`, i download vengono reindirizzati a URL prefirmati e i browser caricano direttamente nel bucket anziché passare attraverso il server. Il valore predefinito è `false`.
`STORAGE_S3_PRESIGNED_URL_BASE`	No	Endpoint pubblico da usare negli URL prefirmati quando `STORAGE_S3_ENDPOINT` è un indirizzo interno che i browser non possono raggiungere, ad esempio MinIO all’interno di Docker.
`STORAGE_S3_PRESIGNED_URL_EXPIRES_IN`	No	Durata degli URL prefirmati in secondi. Il valore predefinito è `900`.

Un file .env minimo per AWS S3 con un utente IAM:

STORAGE_TYPE=S_3
STORAGE_S3_REGION=eu-west-3
STORAGE_S3_NAME=my-twenty-bucket
STORAGE_S3_ACCESS_KEY_ID=AKIA...
STORAGE_S3_SECRET_ACCESS_KEY=...

Il file Docker Compose inoltra STORAGE_TYPE, STORAGE_S3_REGION, STORAGE_S3_NAME, STORAGE_S3_ENDPOINT e le due variabili delle credenziali da .env. Impostare le variabili degli URL prefirmati nel pannello di amministrazione oppure aggiungerle al blocco environment dei servizi server e worker.

Credenziali

Quando STORAGE_S3_ACCESS_KEY_ID non è impostato, il server risolve le credenziali tramite la catena predefinita dell’SDK AWS: le variabili d’ambiente AWS_ACCESS_KEY_ID e AWS_SECRET_ACCESS_KEY, un file di credenziali condiviso, un ruolo di attività ECS, un ruolo di account di servizio EKS (IRSA) o un profilo di istanza EC2.

Profili di istanza EC2 e Docker: il profilo di istanza viene fornito dal servizio di metadati dell’istanza e un container sulla rete bridge predefinita di Docker si trova a un hop di rete più lontano da esso rispetto all’host. Con il limite di hop IMDSv2 predefinito di 1, il container non riceve mai le credenziali anche se l’AWS CLI funziona sull’host. Aumentare il limite a 2 sull’istanza oppure utilizzare credenziali statiche.

aws ec2 modify-instance-metadata-options --instance-id i-0123456789abcdef0 --http-put-response-hop-limit 2

Quando non è possibile trovare credenziali, il server registra CredentialsProviderError: Could not load credentials from any providers al primo caricamento, mentre l’interfaccia utente mostra solo un errore generico.

Autorizzazioni del bucket

Un caricamento viene prima scritto in un percorso in attesa, convalidato, quindi copiato nel percorso finale e l’oggetto in attesa viene eliminato. La policy necessita quindi di più di s3:PutObject:

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": "s3:ListBucket",
      "Resource": "arn:aws:s3:::my-twenty-bucket"
    },
    {
      "Effect": "Allow",
      "Action": [
        "s3:PutObject",
        "s3:GetObject",
        "s3:DeleteObject",
        "s3:AbortMultipartUpload"
      ],
      "Resource": "arn:aws:s3:::my-twenty-bucket/*"
    }
  ]
}

s3:ListBucket viene usato per eliminare cartelle, ad esempio quando viene eliminato uno spazio di lavoro. Senza di esso, S3 risponde alle richieste di oggetti mancanti con accesso negato anziché oggetto non trovato, quindi il server non può distinguere un file mancante da un problema di autorizzazioni.

Endpoint e indirizzamento

Twenty utilizza sempre l’indirizzamento in stile percorso, pertanto le richieste vanno a https://endpoint/bucket/key. Per S3 AWS nativo, lasciare STORAGE_S3_ENDPOINT non impostato: l’SDK costruisce https://s3.{region}.amazonaws.com da STORAGE_S3_REGION, motivo per cui una regione digitata erroneamente si manifesta come errore DNS anziché come errore S3. Impostare l’endpoint solo per i servizi compatibili con S3 oppure quando il server raggiunge S3 tramite un endpoint di interfaccia VPC.

CORS

Quando STORAGE_S3_PRESIGNED_URL_ENABLED è true, i browser comunicano direttamente con il bucket. I download sono richieste GET e i caricamenti sono richieste PUT che includono un’intestazione Content-Type, facendo sì che il browser invii prima una richiesta di preflight. La policy CORS del bucket deve quindi consentire la tua origine Twenty, entrambi i metodi e tale intestazione:

[
  {
    "AllowedOrigins": ["https://crm.example.com"],
    "AllowedMethods": ["GET", "PUT"],
    "AllowedHeaders": ["Content-Type"],
    "MaxAgeSeconds": 3000
  }
]

Senza URL prefirmati, tutto il traffico dei file passa attraverso il server e il bucket non necessita di alcuna configurazione CORS.

Risoluzione dei problemi

Gli errori di caricamento raggiungono l’interfaccia utente come errore generico. L’errore S3 sottostante si trova nei log del server (docker compose logs server) e nella risposta GraphQL visibile nella scheda di rete del browser.

Funzioni logiche & interprete del codice

Twenty supporta le funzioni logiche per i workflow e l’interprete del codice per l’analisi dei dati con IA. Entrambi eseguono codice fornito dall’utente e richiedono una configurazione esplicita per motivi di sicurezza.

Impostazioni di sicurezza predefinite

In produzione (NODE_ENV=production): Sia le funzioni logiche sia l’interprete del codice hanno come impostazione predefinita Disabilitato. È necessario abilitarli esplicitamente con LOGIC_FUNCTION_TYPE e CODE_INTERPRETER_TYPE se queste funzionalità sono necessarie. In sviluppo (NODE_ENV=development): Entrambi sono impostati su LOCAL per comodità quando vengono eseguiti in locale.

Avviso di sicurezza: Il driver locale (LOGIC_FUNCTION_TYPE=LOCAL o CODE_INTERPRETER_TYPE=LOCAL) esegue il codice direttamente sull’host in un processo Node.js senza sandboxing. Dovrebbe essere utilizzato solo per codice attendibile in fase di sviluppo. Per le distribuzioni in produzione che gestiscono codice non affidabile, usa LOGIC_FUNCTION_TYPE=LAMBDA o CODE_INTERPRETER_TYPE=E2B (con sandboxing), oppure lasciali disabilitati.

Funzioni logiche - Driver disponibili

Driver	Variabile di ambiente	Caso d’uso	Livello di sicurezza
Disabilitato	`LOGIC_FUNCTION_TYPE=DISABLED`	Disabilita completamente le funzioni logiche	N/A
Locale	`LOGIC_FUNCTION_TYPE=LOCAL`	Ambienti di sviluppo e attendibili	Basso (nessuna sandbox)
Lambda	`LOGIC_FUNCTION_TYPE=LAMBDA`	Produzione con codice non attendibile	Alto (isolamento a livello hardware)

Funzioni logiche - Configurazione consigliata

Per lo sviluppo:

LOGIC_FUNCTION_TYPE=LOCAL  # default when NODE_ENV=development

Per la produzione (AWS):

LOGIC_FUNCTION_TYPE=LAMBDA
LOGIC_FUNCTION_LAMBDA_REGION=us-east-1
LOGIC_FUNCTION_LAMBDA_ROLE=arn:aws:iam::123456789:role/your-lambda-role
LOGIC_FUNCTION_LAMBDA_ACCESS_KEY_ID=your-access-key
LOGIC_FUNCTION_LAMBDA_SECRET_ACCESS_KEY=your-secret-key
LOGIC_FUNCTION_LAMBDA_LAYER_BUCKET=your-layer-bucket

Il driver Lambda carica il livello delle dipendenze di ciascuna app in LOGIC_FUNCTION_LAMBDA_LAYER_BUCKET, un bucket di tua proprietà nella stessa regione delle tue funzioni. Quando non è impostato, il driver utilizza il bucket di archiviazione (STORAGE_S3_NAME). Se nessuno dei due è impostato, le funzioni logiche hanno esito negativo con un errore di configurazione. Per disabilitare le funzioni logiche:

LOGIC_FUNCTION_TYPE=DISABLED  # default when NODE_ENV=production

Interprete del codice - Driver disponibili

Driver	Variabile di ambiente	Caso d’uso	Livello di sicurezza
Disabilitato	`CODE_INTERPRETER_TYPE=DISABLED`	Disabilita l’esecuzione del codice IA	N/A
Locale	`CODE_INTERPRETER_TYPE=LOCAL`	Solo per lo sviluppo	Basso (nessuna sandbox)
E2B	`CODE_INTERPRETER_TYPE=E_2_B`	Produzione con esecuzione in sandbox	Alta (sandbox isolata)

Quando si utilizza LOGIC_FUNCTION_TYPE=DISABLED o CODE_INTERPRETER_TYPE=DISABLED, qualsiasi tentativo di esecuzione restituirà un errore. Ciò è utile se si desidera eseguire Twenty senza queste funzionalità.

API e front-end su host separati

Rilevante solo se il back-end non serve il front-end. Le distribuzioni con la stessa origine non richiedono nulla qui. Dichiara tutte le origini del browser che comunicano con l’API, separate da virgole. SERVER_URL e FRONTEND_URL sono già considerate attendibili. Il server registra un avviso quando un browser lo chiama da origine non dichiarata.

AUTH_COOKIE_ALLOWED_ORIGINS=https://app.example.com

Il front-end invia le credenziali su ogni richiesta, e i browser rifiutano una risposta credenziale da un’origine non dichiarata, quindi l’applicazione non riesce a caricare fino a quando hai impostato questo.

Se i due host si trovano su domini registrabili diversi (non solo sottodomini diversi), imposta anche AUTH_COOKIE_SAME_SITE=none, che richiede HTTPS. Con multi-workspace abilitato, non elencare ogni sottodominio workspace qui. Invece, percorsi percorsi API (/graphql, /metadata, /rest, /auth/, /client-config, /file) al back-end su ogni hostname di workspace, quindi ogni workspace rimane la stessa origine — così funziona Twenty Cloud.

​Panoramica

​1. Configurazione del Pannello di Amministrazione (Predefinito)

​Chiavi di crittografia

​2. Configurazione Solo-Ambiente

​Modalità multi-workspace

​Modalità a workspace singolo (predefinita)

​Abilitare la modalità multi-workspace

​Configurazione DNS per la modalità multi-workspace

​Limitare la creazione di workspace

​Integrazione Gmail & Google Calendar

​Crea Progetto nel Google Cloud

​Configura OAuth

​Configura in Twenty

​Se la tua app è in modalità di test

​Integrazione Microsoft 365

​Crea un progetto in Microsoft Azure

​Abilita API

​URI di Riindirizzamento Autorizzati

​Configura in Twenty

​Configura scope

​Se la tua app è in modalità di test

​Lavori in Background per Calendario & Messaggistica

​Connessioni in uscita verso host interni

​Configurazione Email

​Archiviazione S3

​Credenziali

​Autorizzazioni del bucket

​Endpoint e indirizzamento

​CORS

​Risoluzione dei problemi

​Funzioni logiche & interprete del codice

​Impostazioni di sicurezza predefinite

​Funzioni logiche - Driver disponibili

​Funzioni logiche - Configurazione consigliata

​Interprete del codice - Driver disponibili

​API e front-end su host separati

Panoramica

1. Configurazione del Pannello di Amministrazione (Predefinito)

Chiavi di crittografia

2. Configurazione Solo-Ambiente

Modalità multi-workspace

Modalità a workspace singolo (predefinita)

Abilitare la modalità multi-workspace

Configurazione DNS per la modalità multi-workspace

Limitare la creazione di workspace

Integrazione Gmail & Google Calendar

Crea Progetto nel Google Cloud

Configura OAuth

Configura in Twenty

Se la tua app è in modalità di test

Integrazione Microsoft 365

Crea un progetto in Microsoft Azure

Abilita API

URI di Riindirizzamento Autorizzati

Configura in Twenty

Configura scope

Se la tua app è in modalità di test

Lavori in Background per Calendario & Messaggistica

Connessioni in uscita verso host interni

Configurazione Email

Archiviazione S3

Credenziali

Autorizzazioni del bucket

Endpoint e indirizzamento

CORS

Risoluzione dei problemi

Funzioni logiche & interprete del codice

Impostazioni di sicurezza predefinite

Funzioni logiche - Driver disponibili

Funzioni logiche - Configurazione consigliata

Interprete del codice - Driver disponibili

API e front-end su host separati