# Integrazioni: account cloud, DNS, Git e storage dei backup

> Collega i tuoi account cloud, DNS, Git e storage in un'unica pagina. Un login serve per tutto ciò che può fare, come un token Hetzner per server e DNS.

**Integrazioni** è la pagina nelle impostazioni della tua organizzazione in cui colleghi gli account esterni con cui lavora Vimonto Deploy: provider cloud per creare server, provider DNS per far puntare i domini, host Git da cui fare il deploy e storage compatibile S3 per i backup dei database. La trovi in **Impostazioni** → **Integrazioni**.

Un login viene usato per tutto ciò che può fare. Un token di Hetzner Cloud, DigitalOcean, Vultr o Akamai, una chiave di accesso AWS o una chiave dell'account di servizio Google Cloud crea i server **e** gestisce il DNS dei domini di quell'account, così un dominio che aggiungi a un sito può puntare da solo al suo server. Solo lo storage dei backup chiede chiavi proprie, perché S3 usa chiavi di accesso separate.

![La pagina Integrazioni con il catalogo dei provider e gli account collegati](https://ops.vimonto.com/docs-media/it/integrations.webp?v=161e760d "Impostazioni → Integrazioni")

## Cosa c'è nella pagina?

- **Aggiungi un’integrazione**: un catalogo di tutto ciò che puoi collegare. Ogni scheda mostra, come badge, cosa copre un login lì: **Server**, **DNS**, **Backup** o **Git**, e un pulsante per collegarlo. Solo i membri che possono gestire le integrazioni vedono il catalogo.
- **Cloud e DNS**: i tuoi account cloud e DNS collegati. Vedi [account cloud e DNS](https://ops.vimonto.com/docs/it/connections/server-providers).
- **Git**: i tuoi account GitHub, GitLab e Bitbucket. Vedi [account Git](https://ops.vimonto.com/docs/it/connections/source-control).
- **Storage dei backup**: i bucket compatibili S3 per i backup dei database. Vedi [storage dei backup](https://ops.vimonto.com/docs/it/connections/storage-providers).

Le vecchie pagine delle impostazioni per provider di server, source control e storage ora aprono la sezione corrispondente di **Integrazioni**, quindi i segnalibri continuano a funzionare.

## Cosa copre un login?

| Account | Server | DNS | Backup | Come lo colleghi |
| --- | --- | --- | --- | --- |
| **Hetzner Cloud** | Sì | Sì | Hetzner Object Storage, con chiavi S3 proprie | Token API |
| **DigitalOcean** | Sì | Sì | DigitalOcean Spaces, con chiavi S3 proprie | Token API, oppure OAuth |
| **Vultr** | Sì | Sì | No | API key |
| **Akamai (Linode)** | Sì | Sì | No | Token API, oppure OAuth |
| **Amazon Web Services** | Sì | Sì (Route 53) | Amazon S3, con chiavi S3 proprie | Chiave di accesso |
| **Google Cloud** | Sì | Sì (Cloud DNS) | No | Chiave dell'account di servizio (JSON) |
| **Cloudflare** | No | Sì | Cloudflare R2, con chiavi S3 proprie | Token API |
| **GitHub**, **GitLab**, **Bitbucket** | No | No | No | OAuth (GitLab self-hosted: access token) |
| **Amazon S3**, **Scaleway**, **OVHcloud**, altro storage S3 | No | No | Sì | Chiavi di accesso |

OAuth viene offerto quando un amministratore della piattaforma lo ha configurato; fino ad allora ti colleghi con un token.

## Chi può gestire le integrazioni?

Ogni membro dell'organizzazione vede cosa è collegato. Per collegare, verificare, modificare e scollegare account serve il ruolo **Proprietario** o **Amministratore**; vedi [membri e ruoli](https://ops.vimonto.com/docs/it/organization/members-and-roles). Le modifiche vengono registrate nel [registro di audit](https://ops.vimonto.com/docs/it/organization/audit-log), senza token né chiavi.

## Collegare un account

1. Apri **Impostazioni** → **Integrazioni**.
2. Trova l'account sotto **Aggiungi un’integrazione** e scegli **Connetti**. Dove OAuth è disponibile, **Connetti** ti fa accedere presso il provider e **Usa un token API** apre invece il modulo del token.
3. Segui i passaggi nella finestra. Per un token, Vimonto Deploy lo verifica con il provider prima di salvare qualsiasi cosa.

Un host Git mostra **Configura** agli amministratori e **Prossimamente** a tutti gli altri finché la sua app OAuth non è registrata.

## Usare un account collegato per il DNS

Quando colleghi un account cloud o DNS, Vimonto Deploy recupera i domini (zone DNS) che gestisce. Ogni scheda account in **Cloud e DNS** mostra poi, accanto a **DNS**, quanti domini gestisce e i primi nomi. Quando in seguito aggiungi a un sito un dominio che si trova in una di quelle zone, Vimonto Deploy si offre di creare i record DNS per te, mostra esattamente cosa cambia e richiede l'HTTPS appena i record si risolvono. Vedi [domini e SSL](https://ops.vimonto.com/docs/it/sites/domains-and-ssl#fai-puntare-il-dominio-automaticamente-tramite-integrazione-dns).

- **Aggiorna i domini** nel menu dell'account recupera di nuovo l'elenco. Raramente ti serve: mentre digiti un dominio per un sito, Vimonto Deploy recupera gli elenchi in tempo reale, così trova anche un dominio appena aggiunto presso il provider.
- Un dominio che nessuno dei tuoi account ha ancora può essere aggiunto a uno di essi dalla finestra del dominio (**Aggiungi il dominio a un provider DNS**); poi imposti i nameserver del provider presso il tuo registrar. Su Cloudflare servono **Zone** → **Zone** → **Edit** e un token che raggiunga un solo account.
- Vimonto Deploy ricorda i record che crea e rimuove esattamente quelli quando rimuovi un dominio o elimini un sito. Non sovrascrive mai un record che non ha creato e che punta altrove, tranne quando confermi la modifica mentre aggiungi un dominio.
- **Nessun accesso DNS con queste credenziali.** significa che il token non può leggere il DNS. Il motivo è mostrato accanto, per esempio permessi mancanti. Puoi comunque creare server con quell'account; dai al token i permessi DNS (vedi sotto) o collega a parte il provider DNS.

### Collegare Cloudflare per il DNS

Cloudflare gestisce solo il DNS: qui non ospita server. Scegli **Connetti** nella scheda **Cloudflare** e incolla un token API:

1. Apri **My Profile** → **API Tokens** nella [dashboard di Cloudflare](https://dash.cloudflare.com/profile/api-tokens) e scegli **Create Token**.
2. Parti dal modello **Edit zone DNS** e aggiungi **Zone** → **Zone** → **Read**.
3. Scegli le zone (tutte, o quelle che usi) e copia il token.

Il token ha quindi bisogno di **Zone** → **Zone** → **Read** e **Zone** → **DNS** → **Edit**. I record che Vimonto Deploy crea su Cloudflare sono solo DNS (senza proxy), così i certificati HTTPS e gli indirizzi dei visitatori funzionano.

## Aggiungere lo storage dei backup a un account

Hetzner, DigitalOcean e Cloudflare hanno anche uno storage compatibile S3. Nella scheda di un account di questo tipo, **Backup** mostra il bucket collegato, oppure **Aggiungi storage per i backup** se non ce n'è uno. S3 ha bisogno di chiavi di accesso proprie, quindi si apre il modulo dello storage di quell'account (Hetzner Object Storage, DigitalOcean Spaces o Cloudflare R2), e il bucket che aggiungi appartiene poi a quell'account. Amazon S3, Scaleway, OVHcloud e altro storage compatibile S3 hanno schede proprie nel catalogo. Vedi [storage dei backup](https://ops.vimonto.com/docs/it/connections/storage-providers).

## Domande frequenti

### Mi serve un'integrazione DNS?

No. Senza, crei tu i record DNS presso il tuo provider DNS; la finestra **Configura** di un dominio li elenca. Un'integrazione DNS ti risparmia solo quel passaggio e richiede l'HTTPS per te.

### I miei domini sono su Cloudflare, ma i server su Hetzner. Funziona?

Sì. Collegali entrambi: Hetzner per i server, Cloudflare per il DNS. Vimonto Deploy usa l'account che gestisce la zona del dominio.

### Perché il mio account Akamai non ha accesso DNS?

Il token è stato creato senza il permesso **Domains**. Crea un token con lettura e scrittura per Linodes, IPs e Domains e incollalo con **Modifica nome o token**; oppure, per un collegamento OAuth, scegli **Riconnetti**.