The open alternative to Salesforce, designed for AI.
TypeScript crmcrm-systemcustomergood-first-issuegraphqlhacktoberfestjavascriptmarketingmonoreponestjsopen-sourcepostgresqlreactreactjssalestypescriptweb
---
title: Configurare
description: Configurați douăzeci din panoul de administrare sau cu variabilele de mediu.
---
import { PageBanner } from "/snippets/page-banner.mdx"
## Prezentare generală
<Warning>
**Prima instalare?** Urmați [ghidul de instalare Docker Compose](/ro/developers/self-host/capabilities/docker-compose) pentru a rula Twenty, apoi reveniți aici pentru configurare.
</Warning>
Twenty oferă **două moduri de configurare** pentru a se potrivi nevoilor diferite de implementare:
**Acces la panoul de administrare:** Doar utilizatorii cu privilegii de administrator (`canAccessFullAdminPanel: true`) pot accesa interfața de configurare.
## 1. Configurare Panou Admin (Implicită)
```bash
IS_CONFIG_VARIABLES_IN_DB_ENABLED=true # default
```
**Majoritatea configurărilor se fac prin UI** după instalare:
1. Accesați instanța dumneavoastră Twenty (de obicei `http://localhost:3000`)
2. Mergeți la **Setări / Panou Admin / Variabile de Configurare**
3. Configurați integrările, e-mailul, stocarea și multe altele
4. Schimbările intră în vigoare imediat (în termen de 15 secunde pentru implementări cu mai multe containere)
<Warning>
**Implementări Multi-Container:** Când utilizați configurarea bazei de date (`IS_CONFIG_VARIABLES_IN_DB_ENABLED=true`), atât serverul cât și containerele worker citesc din aceeași bază de date. Modificările din panoul de administrare afectează ambele automat, eliminând necesitatea duplicării variabilelor de mediu între containere (cu excepția variabilelor de infrastructură).
</Warning>
**Ce puteți configura prin panoul de administrare:**
* **Autentificare** - OAuth Google/Microsoft, setări parole
* **E-mail** - setări SMTP, șabloane, verificare
* **Stocare** - configurație S3, căi stocare locală
* **Integrări** - Gmail, Google Calendar, servicii Microsoft
* **Flux de lucru și limitarea ratei** - limite de execuție, limitarea ratei pentru API
* **Și multe altele...**

<Warning>
Fiecare variabilă este documentată cu descrieri în panoul dvs. de administrare la **Setări → Panou Admin → Variabile de Configurare**.
Unele setări de infrastructură, cum ar fi conexiunile la baze de date (`PG_DATABASE_URL`), URL-urile serverului (`SERVER_URL`) și secretele (`ENCRYPTION_KEY`, `FALLBACK_ENCRYPTION_KEY`) pot fi configurate doar prin fișierul `.env`.
[Referință tehnică completă →](https://github.com/twentyhq/twenty/blob/main/packages/twenty-server/src/engine/core-modules/twenty-config/config-variables.ts)
</Warning>
## Chei de criptare
Twenty folosește două chei de criptare disponibile doar prin variabile de mediu:
| Variabilă | Scop | Obligatoriu |
| ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- |
| `ENCRYPTION_KEY` | Cheia principală folosită pentru a cripta secretele în repaus (token-uri OAuth, variabile de aplicație, chei private de semnare, secrete TOTP, valori de configurare sensibile). | Da, pentru instalările noi (instalările vechi se pot baza în schimb pe `APP_SECRET` — vezi mai jos) |
| `FALLBACK_ENCRYPTION_KEY` | Cheie folosită doar pentru verificare. Setată în timpul unei rotații la *precedenta* `ENCRYPTION_KEY` astfel încât rândurile existente să rămână decriptabile. | Doar în timpul rotației |
Pentru compatibilitate cu versiunile anterioare, dacă `ENCRYPTION_KEY` nu este setată, Twenty revine la `APP_SECRET` pentru criptarea în repaus — respectând comportamentul moștenit pentru implementările mai vechi. Instalările noi ar trebui să seteze întotdeauna o `ENCRYPTION_KEY` dedicată.
Generează valori cu `openssl rand -base64 32` și stochează-le într-un loc sigur (un manager de secrete, configurație sigilată etc.). Pierderea `ENCRYPTION_KEY` înseamnă pierderea accesului la fiecare secret stocat în baza de date.
Pentru a roti `ENCRYPTION_KEY` fără timp de nefuncționare, vezi [Ghidul de rotație a cheilor](/ro/developers/self-host/capabilities/key-rotation).
## 2. Configurare Doar Mediu
```bash
IS_CONFIG_VARIABLES_IN_DB_ENABLED=false
```
**Toate configurațiile gestionate prin fișiere `.env`:**
1. Setați `IS_CONFIG_VARIABLES_IN_DB_ENABLED=false` în fișierul dvs. `.env`
2. Adăugați toate variabilele de configurare în fișierul dvs. `.env`
3. Reporniți containerele pentru ca schimbările să aibă efect
4. Panoul de administrare va afișa valorile curente, dar nu le poate modifica
## Mod cu mai multe spații de lucru
În mod implicit, Twenty rulează în **modul cu un singur spațiu de lucru** — ideal pentru majoritatea implementărilor auto-găzduite în care aveți nevoie de o singură instanță CRM pentru organizația dvs.
### Modul cu un singur spațiu de lucru (implicit)
```bash
IS_MULTIWORKSPACE_ENABLED=false # default
```
* Un spațiu de lucru pentru fiecare instanță Twenty
* Primul utilizator devine automat administrator cu privilegii complete (`canImpersonate` și `canAccessFullAdminPanel`)
* Înregistrările noi sunt dezactivate după crearea primului spațiu de lucru
* Structură URL simplă: `https://your-domain.com`
### Activarea modului cu mai multe spații de lucru
```bash
IS_MULTIWORKSPACE_ENABLED=true
DEFAULT_SUBDOMAIN=app # default value
```
Activați modul cu mai multe spații de lucru pentru implementări de tip SaaS, în care mai multe echipe independente au nevoie de propriile spații de lucru pe aceeași instanță Twenty.
**Diferențe cheie față de modul cu un singur spațiu de lucru:**
* Pe aceeași instanță pot fi create mai multe spații de lucru
* Fiecare spațiu de lucru primește propriul subdomeniu (de ex., `sales.your-domain.com`, `marketing.your-domain.com`)
* Utilizatorii se înregistrează și se autentifică la `{DEFAULT_SUBDOMAIN}.your-domain.com` (de ex., `app.your-domain.com`)
* Fără privilegii administrative automate — primul utilizator din fiecare spațiu de lucru este un utilizator obișnuit
* Setări specifice spațiului de lucru, precum subdomeniu și domeniu personalizat, devin disponibile în setările spațiului de lucru
<Warning>
**Setare exclusiv de mediu:** `IS_MULTIWORKSPACE_ENABLED` poate fi configurată doar prin fișierul `.env` și necesită o repornire. Nu poate fi modificată prin panoul de administrare.
</Warning>
### Configurarea DNS pentru modul cu mai multe spații de lucru
Când folosiți modul cu mai multe spații de lucru, configurați DNS-ul cu o înregistrare wildcard pentru a permite crearea dinamică de subdomenii:
```
*.your-domain.com -> your-server-ip
```
Acest lucru permite rutarea automată a subdomeniilor pentru spațiile de lucru noi, fără configurare DNS manuală.
### Restricționarea creării de spații de lucru
În modul cu mai multe spații de lucru, este posibil să doriți să limitați cine poate crea spații de lucru noi:
```bash
IS_WORKSPACE_CREATION_LIMITED_TO_SERVER_ADMINS=true
```
Când este activată, doar utilizatorii cu `canAccessFullAdminPanel` pot crea spații de lucru suplimentare. Utilizatorii își pot crea în continuare primul spațiu de lucru în timpul înregistrării inițiale.
## Integrare Gmail & Google Calendar
### Creați Proiect Google Cloud
1. Mergeți la [Google Cloud Console](https://console.cloud.google.com/)
2. Creați un proiect nou sau selectați unul existent
3. Activați aceste API-uri:
* [Gmail API](https://console.cloud.google.com/apis/library/gmail.googleapis.com)
* [Google Calendar API](https://console.cloud.google.com/apis/library/calendar-json.googleapis.com)
* [People API](https://console.cloud.google.com/apis/library/people.googleapis.com)
### Configurați OAuth
1. Mergeți la [Credentials](https://console.cloud.google.com/apis/credentials)
2. Creați Client ID OAuth 2.0
3. Adăugați aceste URI-uri de redirecționare:
* `https://{your-domain}/auth/google/redirect` (pentru SSO)
* `https://{your-domain}/auth/google-apis/get-access-token` (pentru integrări)
### Configurați în Twenty
1. Mergeți la **Setări → Panou Admin → Variabile de Configurare**
2. Găsiți secțiunea **Autentificare Google**
3. Setați aceste variabile:
* `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`
<Warning>
**Mod doar pentru mediu:** Dacă setați `IS_CONFIG_VARIABLES_IN_DB_ENABLED=false`, adăugați aceste variabile în fișierul dvs. `.env` în schimb.
</Warning>
**Domenii necesare** (configurate automat):
[Consultați codul sursă relevant](https://github.com/twentyhq/twenty/blob/main/packages/twenty-server/src/engine/core-modules/auth/utils/get-google-apis-oauth-scopes.ts#L4-L10)
* `https://www.googleapis.com/auth/calendar.events`
* `https://www.googleapis.com/auth/gmail.readonly`
* `https://www.googleapis.com/auth/profile.emails.read`
### Dacă aplicația dvs. este în modul de test
Dacă aplicația dvs. este în modul de test, va trebui să adăugați utilizatori de test în proiectul dvs.
În [ecranul de consimțământ OAuth](https://console.cloud.google.com/apis/credentials/consent), adăugați utilizatorii dvs. de test în secțiunea "Utilizatori de test".
## Integrare Microsoft 365
<Warning>
Utilizatorii trebuie să aibă un [Licență Microsoft 365](https://admin.microsoft.com/Adminportal/Home) pentru a putea utiliza API-ul Calendar și Mesagerie. Nu vor putea sincroniza contul lor pe Twenty fără una.
</Warning>
### Creați un proiect în Microsoft Azure
Va trebui să creați un proiect în [Microsoft Azure](https://portal.azure.com/#view/Microsoft_AAD_IAM/AppGalleryBladeV2) și să obțineți acreditările.
### Activați API-urile
În Microsoft Azure Console activați următoarele API-uri în "Permisiuni":
* Graph Microsoft: Mail.ReadWrite
* Graph Microsoft: Mail.Send
* Graph Microsoft: Calendars.ReadWrite
* Graph Microsoft: User.Read
* Graph Microsoft: openid
* Graph Microsoft: email
* Graph Microsoft: profile
* Graph Microsoft: offline_access
<Note>
Toate aceste permisiuni sunt necesare, chiar dacă doriți doar să sincronizați e-mailuri și evenimente din calendar. Twenty solicită întotdeauna "Mail.ReadWrite", "Mail.Send" și "Calendars.ReadWrite" atunci când un utilizator își conectează contul, astfel încât permisiunile doar de citire, precum "Mail.Read" sau "Calendars.Read", nu sunt suficiente.
</Note>
<Note>
Dacă entitatea dvs. găzduită nu le permite utilizatorilor obișnuiți să consimtă la aceste permisiuni, aceștia vor vedea eroarea AADSTS90094 atunci când își conectează contul. Un administrator poate remedia acest lucru făcând clic pe "Grant admin consent for {your-tenant}" în pagina "API permissions" a înregistrării aplicației.
</Note>
### URIs de redirecționare autorizate
Trebuie să adăugați următoarele URI-uri de redirecționare în proiectul dvs:
* `https://{your-domain}/auth/microsoft/redirect` dacă doriți să utilizați SSO Microsoft
* `https://{your-domain}/auth/microsoft-apis/get-access-token`
### Configurați în Twenty
1. Mergeți la **Setări → Panou Admin → Variabile de Configurare**
2. Găsiți secțiunea **Autentificare Microsoft**
3. Setați aceste variabile:
* `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`
<Warning>
**Mod doar pentru mediu:** Dacă setați `IS_CONFIG_VARIABLES_IN_DB_ENABLED=false`, adăugați aceste variabile în fișierul dvs. `.env` în schimb.
</Warning>
### Configurați scopurile
[Consultați codul sursă relevant](https://github.com/twentyhq/twenty/blob/main/packages/twenty-server/src/engine/core-modules/auth/utils/get-microsoft-apis-oauth-scopes.ts#L2-L11)
* 'openid'
* 'email'
* 'profil'
* 'offline_access'
* 'Mail.ReadWrite'
* 'Mail.Send'
* 'Calendars.ReadWrite'
* 'User.Read'
### Dacă aplicația dvs. este în modul de test
Dacă aplicația dvs. este în modul de test, va trebui să adăugați utilizatori de test în proiectul dvs.
Adăugați utilizatorii de test în secțiunea "Utilizatori și grupuri".
## Procese în fundal pentru Calendar și Mesagerie
După configurarea integrărilor Gmail, Google Calendar, sau Microsoft 365, trebuie să porniți joburile de fundal care sincronizează datele.
Înregistrați următoarele joburi recurente în containerul dvs. worker:
```bash
# 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
```
## Conexiuni de ieșire către gazde interne
În mod implicit, Twenty refuză conexiunile de ieșire către adrese IP private/interne (protecție SSRF). Aceasta acoperă acțiunile fluxurilor de lucru HTTP, webhookurile, furnizorii de identitate SSO și conexiunile IMAP/SMTP/CalDAV. Dacă furnizorul de identitate, serverul de e-mail sau serverul de calendar rulează într-o rețea privată, enumerați numele de gazdă sau literalul IP al acestuia:
```bash
OUTBOUND_HTTP_ALLOWED_INTERNAL_HOSTS=keycloak,mail.internal,192.168.1.10
```
Intrările sunt potrivite numai pe baza numelui de gazdă, fără metacaractere: pentru un emitent OIDC precum `http://keycloak:8080/realms/twenty`, enumerați `keycloak`. Orice altă adresă privată rămâne blocată și chiar și o gazdă permisă nu poate accesa niciodată intervalul de adrese pentru metadatele cloud. Setați variabila la `*` pentru a dezactiva complet protecția, lucru adecvat doar în rețele izolate, de încredere.
`OUTBOUND_HTTP_SAFE_MODE_ENABLED` este depreciată. Cât timp este setată la `false`, protecția rămâne complet dezactivată, iar `OUTBOUND_HTTP_ALLOWED_INTERNAL_HOSTS` este ignorată, așa că eliminați-o când migrați la listă.
Această listă nu acoperă atașamentele de fișiere AI: imaginile și PDF-urile ajung la model ca linkuri create din `SERVER_URL`, preluate fie de furnizorul AI, fie de AI SDK în worker, care refuză adresele private. Pentru ca atașamentele să funcționeze, `SERVER_URL` trebuie să fie public; cu un `SERVER_URL` localhost sau privat, conversațiile și agenții AI funcționează doar cu text.
## Configurare Email
1. Mergeți la **Setări → Panou Admin → Variabile de Configurare**
2. Găsiți secțiunea **Email**
3. Configurați setările dvs. SMTP:
<Tabs>
<Tab title="Gmail">
Va trebui să provisionați o [Parolă de Aplicație](https://support.google.com/accounts/answer/185833).
* EMAIL_DRIVER=smtp
* EMAIL_SMTP_HOST=smtp.gmail.com
* EMAIL_SMTP_PORT=465
* EMAIL_SMTP_USER=gmail_email_address
* EMAIL_SMTP_PASSWORD='gmail_app_password'
</Tab>
<Tab title="Office365">
**smtp4dev** este un server SMTP fals pentru dezvoltare și testare.
* EMAIL_DRIVER=smtp
* EMAIL_SMTP_HOST=smtp.office365.com
* EMAIL_SMTP_PORT=587
* EMAIL_SMTP_USER=office365_email_address
* EMAIL_SMTP_PASSWORD='office365_password'
</Tab>
<Tab title="smtp4dev">
**smtp4dev** este un server SMTP fals pentru dezvoltare și testare.
* Rulați imaginea smtp4dev: `docker run --rm -it -p 8090:80 -p 2525:25 rnwood/smtp4dev`
* Accesați interfața smtp4dev aici: [http://localhost:8090](http://localhost:8090)
* Setați următoarele variabile:
* EMAIL_DRIVER=smtp
* EMAIL_SMTP_HOST=localhost
* EMAIL_SMTP_PORT=2525
</Tab>
</Tabs>
<Warning>
**Mod doar pentru mediu:** Dacă setați `IS_CONFIG_VARIABLES_IN_DB_ENABLED=false`, adăugați aceste variabile în fișierul dvs. `.env` în schimb.
</Warning>
## Stocare S3
<Warning>
În mod implicit, Twenty stochează fișierele încărcate în sistemul de fișiere local. Pentru implementări în producție, utilizați S3 sau un serviciu compatibil cu S3 (MinIO, DigitalOcean Spaces etc.). pentru a vă asigura că fișierele persistă între repornirile containerelor și se scalează pe mai multe instanțe de server.
</Warning>
Setați `STORAGE_TYPE=S_3` și configurați variabilele `STORAGE_S3_*` prin panoul de administrare sau `.env`.
| Variabilă | Obligatoriu | Descriere |
| ------------------------------------- | ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `STORAGE_S3_REGION` | Da | Regiunea bucketului: o regiune AWS precum `eu-west-3` sau un slug specific furnizorului, precum `fr-par` pentru Scaleway. |
| `STORAGE_S3_NAME` | Da | Numele bucketului. |
| `STORAGE_S3_ACCESS_KEY_ID` | Nu | Cheia de acces a unui utilizator IAM. Lăsați nesetat pentru a utiliza lanțul de acreditări implicit AWS (consultați [Acreditări](#credentials)). |
| `STORAGE_S3_SECRET_ACCESS_KEY` | Nu | Secretul pentru cheia de acces de mai sus. Obligatoriu când `STORAGE_S3_ACCESS_KEY_ID` este setat. |
| `STORAGE_S3_ENDPOINT` | Nu | URL endpoint personalizat. Numai pentru servicii compatibile cu S3, precum `http://minio:9000`, sau pentru un endpoint de interfață AWS VPC. Lăsați nesetat pentru AWS S3 nativ, unde SDK-ul derivă endpointul din regiune. |
| `STORAGE_S3_PRESIGNED_URL_ENABLED` | Nu | Când este `true`, descărcările sunt redirecționate către URL-uri presemnate, iar browserele încarcă direct în bucket în loc să treacă prin server. Valoarea implicită este `false`. |
| `STORAGE_S3_PRESIGNED_URL_BASE` | Nu | Endpoint public de utilizat în URL-uri presemnate când `STORAGE_S3_ENDPOINT` este o adresă internă la care browserele nu pot ajunge, de exemplu MinIO în Docker. |
| `STORAGE_S3_PRESIGNED_URL_EXPIRES_IN` | Nu | Durata de valabilitate a URL-urilor presemnate, în secunde. Valoarea implicită este `900`. |
Un fișier `.env` minimal pentru AWS S3 cu un utilizator IAM:
```ini
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=...
```
<Note>
Fișierul Docker Compose transmite `STORAGE_TYPE`, `STORAGE_S3_REGION`, `STORAGE_S3_NAME`, `STORAGE_S3_ENDPOINT` și cele două variabile de acreditări din `.env`. Setați variabilele pentru URL-uri presemnate în panoul de administrare sau adăugați-le în blocul `environment` al serviciilor `server` și `worker`.
</Note>
### Acreditări
Când `STORAGE_S3_ACCESS_KEY_ID` este nesetat, serverul rezolvă acreditările prin lanțul implicit al SDK-ului AWS: variabilele de mediu `AWS_ACCESS_KEY_ID` și `AWS_SECRET_ACCESS_KEY`, un fișier de acreditări partajat, un rol de sarcină ECS, un rol de cont de serviciu EKS (IRSA) sau un profil de instanță EC2.
<Warning>
**Profiluri de instanță EC2 și Docker:** profilul de instanță este furnizat de serviciul de metadate al instanței, iar un container din rețeaua bridge implicită a Docker este la un salt de rețea mai departe de acesta decât gazda. Cu limita implicită de salt IMDSv2 de 1, containerul nu primește niciodată acreditările, chiar dacă AWS CLI funcționează pe gazdă. Măriți limita la 2 pe instanță sau utilizați acreditări statice.
</Warning>
```bash
aws ec2 modify-instance-metadata-options --instance-id i-0123456789abcdef0 --http-put-response-hop-limit 2
```
Când nu pot fi găsite acreditări, serverul înregistrează `CredentialsProviderError: Could not load credentials from any providers` la prima încărcare, în timp ce interfața afișează doar o eroare generică.
### Permisiuni pentru bucket
O încărcare este mai întâi scrisă într-o cale în așteptare, validată, apoi copiată în calea sa finală, iar obiectul în așteptare este șters. Prin urmare, politica necesită mai mult decât `s3:PutObject`:
```json
{
"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` este utilizat pentru a șterge foldere, de exemplu când un spațiu de lucru este șters. Fără acesta, S3 răspunde solicitărilor pentru obiecte lipsă cu acces refuzat în loc de negăsit, astfel încât serverul nu poate distinge un fișier lipsă de o problemă de permisiuni.
### Endpoint și adresare
Twenty utilizează întotdeauna adresarea în stil cale, astfel încât solicitările ajung la `https://endpoint/bucket/key`. Pentru AWS S3 nativ, lăsați `STORAGE_S3_ENDPOINT` nesetat: SDK-ul construiește `https://s3.{region}.amazonaws.com` din `STORAGE_S3_REGION`, motiv pentru care o regiune introdusă greșit apare ca o eroare DNS, nu ca o eroare S3. Setați endpointul numai pentru servicii compatibile cu S3 sau când serverul accesează S3 printr-un endpoint de interfață VPC.
### CORS
Când `STORAGE_S3_PRESIGNED_URL_ENABLED` este `true`, browserele comunică direct cu bucketul. Descărcările sunt solicitări `GET`, iar încărcările sunt solicitări `PUT` care conțin un antet `Content-Type`, ceea ce face ca browserul să trimită mai întâi o solicitare preflight. Prin urmare, politica CORS a bucketului trebuie să permită originea Twenty, ambele metode și acel antet:
```json
[
{
"AllowedOrigins": ["https://crm.example.com"],
"AllowedMethods": ["GET", "PUT"],
"AllowedHeaders": ["Content-Type"],
"MaxAgeSeconds": 3000
}
]
```
Fără URL-uri presemnate, tot traficul de fișiere trece prin server, iar bucketul nu necesită configurare CORS.
### Depanare
Eșecurile de încărcare ajung în interfață ca o eroare generică. Eroarea S3 subiacentă se află în jurnalele serverului (`docker compose logs server`) și în răspunsul GraphQL vizibil în fila de rețea a browserului.
## Funcții logice și interpretor de cod
Twenty acceptă funcții logice pentru fluxuri de lucru și interpretorul de cod pentru analiza datelor cu AI. Ambele rulează cod furnizat de utilizator și necesită o configurare explicită din motive de securitate.
### Valori implicite de securitate
**În producție (NODE_ENV=production):** Atât funcțiile logice, cât și interpretorul de cod au implicit valoarea **Dezactivat**. Trebuie să le activezi explicit cu `LOGIC_FUNCTION_TYPE` și `CODE_INTERPRETER_TYPE` dacă ai nevoie de aceste funcționalități.
**În dezvoltare (NODE_ENV=development):** Ambele au implicit valoarea **LOCAL** pentru comoditate când rulezi local.
<Warning>
**Atenționare de securitate:** Driverul local (`LOGIC_FUNCTION_TYPE=LOCAL` sau `CODE_INTERPRETER_TYPE=LOCAL`) rulează codul direct pe gazdă într-un proces Node.js, fără sandboxing. Ar trebui utilizat doar pentru cod de încredere, în dezvoltare. Pentru implementări în producție care gestionează cod neverificat, folosiți `LOGIC_FUNCTION_TYPE=LAMBDA` sau `CODE_INTERPRETER_TYPE=E2B` (cu sandboxing) ori păstrați-le dezactivate.
</Warning>
### Funcții logice - Drivere disponibile
| Driver | Variabilă de mediu | Caz de utilizare | Nivel de securitate |
| ---------- | ------------------------------ | ------------------------------------- | -------------------------------------- |
| Dezactivat | `LOGIC_FUNCTION_TYPE=DISABLED` | Dezactivează complet funcțiile logice | N/A |
| Local | `LOGIC_FUNCTION_TYPE=LOCAL` | Dezvoltare și medii de încredere | Scăzut (fără sandboxing) |
| Lambda | `LOGIC_FUNCTION_TYPE=LAMBDA` | Producție cu cod neverificat | Ridicat (izolare la nivel de hardware) |
### Funcții logice - Configurare recomandată
**Pentru dezvoltare:**
```bash
LOGIC_FUNCTION_TYPE=LOCAL # default when NODE_ENV=development
```
**Pentru producție (AWS):**
```bash
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
```
Driverul Lambda încarcă stratul de dependențe al fiecărei aplicații în `LOGIC_FUNCTION_LAMBDA_LAYER_BUCKET`, un bucket pe care îl dețineți în aceeași regiune cu funcțiile dvs. Când nu este setat, driverul utilizează bucket-ul de stocare (`STORAGE_S3_NAME`). Dacă niciuna nu este setată, funcțiile logice eșuează cu o eroare de configurare.
**Pentru a dezactiva funcțiile logice:**
```bash
LOGIC_FUNCTION_TYPE=DISABLED # default when NODE_ENV=production
```
### Interpretor de cod - Drivere disponibile
| Driver | Variabilă de mediu | Caz de utilizare | Nivel de securitate |
| ---------- | -------------------------------- | ---------------------------------------- | ------------------------ |
| Dezactivat | `CODE_INTERPRETER_TYPE=DISABLED` | Dezactivați execuția codului de către AI | N/A |
| Local | `CODE_INTERPRETER_TYPE=LOCAL` | Doar pentru dezvoltare | Scăzut (fără sandboxing) |
| E2B | `CODE_INTERPRETER_TYPE=E_2_B` | Producție cu execuție în sandbox | Ridicat (sandbox izolat) |
<Note>
Când utilizați `LOGIC_FUNCTION_TYPE=DISABLED` sau `CODE_INTERPRETER_TYPE=DISABLED`, orice încercare de execuție va returna o eroare. Acest lucru este util dacă doriți să rulați Twenty fără aceste capabilități.
</Note>
## API și interfața front-end pe gazde separate
Este relevant doar dacă nu lași back-end-ul să servească front-end-ul. Implementările cu aceeași origine
nu au nevoie de nimic aici.
Declară fiecare origine de browser care comunică cu API-ul, separate prin virgulă. `SERVER_URL`
și `FRONTEND_URL` sunt deja de încredere. Serverul înregistrează un avertisment în jurnale atunci când un browser
îl apelează dintr-o origine nedeclarată.
```bash
AUTH_COOKIE_ALLOWED_ORIGINS=https://app.example.com
```
<Warning>
Partea de front-end trimite datele de autentificare la fiecare cerere, iar browserele resping un răspuns cu date de autentificare
provenit de la o origine nedeclarată, astfel încât aplicația nu se încarcă până când nu configurați această opțiune.
</Warning>
Dacă cele două gazde se află pe domenii înregistrabile diferite (nu doar pe
subdomenii diferite), setați, de asemenea, `AUTH_COOKIE_SAME_SITE=none`, ceea ce necesită HTTPS.
Cu multi-workspace activat, nu listați aici fiecare subdomeniu de workspace.
În schimb, direcționați căile API (`/graphql`, `/metadata`, `/rest`, `/auth/`,
`/client-config`, `/file`) către back-end pe fiecare hostname de workspace, astfel încât fiecare
workspace să rămână de aceeași origine — acesta este modul în care rulează Twenty Cloud.
<PageBanner illustration="dev-self-host" />