Distribuisca un sito statico nel Suo account Azure Static Web Apps

I vantaggi del collegamento

Collegare il Suo account Azure Static Web Apps Le consente di pubblicare un sito statico sul Suo account Azure Static Web Apps direttamente dalla dashboard di Zinn®. Lei mantiene la proprietà del progetto e della fatturazione; noi gestiamo il deploy, il dominio personalizzato e i record DNS.

Prima di iniziare

Una sottoscrizione Azure, un gruppo di risorse per i siti e un account GitHub, GitLab o Bitbucket collegato contenente il codice: Azure Static Web Apps esegue la compilazione a partire da un repository. Il piano gratuito di Azure consente l'uso commerciale e due domini personalizzati per app.

1. Creare la chiave su Azure Static Web Apps

Azure la definisce entità servizio (service principal). Nel centro di amministrazione di Microsoft Entra apra Entra ID → Registrazioni app → Nuova registrazione, assegni un nome e selezioni Registra. Nella pagina di panoramica dell'app copi l'ID applicazione (client) e l'ID directory (tenant). Successivamente, apra Certificati e segreti → Segreti client → Nuovo segreto client, scelga una durata e selezioni Aggiungi: copi immediatamente il valore del segreto, poiché Azure lo mostra una sola volta.

Nel portale di Azure, apra il gruppo di risorse che desidera farci utilizzare, quindi Controllo di accesso (IAM) → Aggiungi → Aggiungi assegnazione di ruolo. Scelga il ruolo Collaboratore (Contributor), lo assegni a Utente, gruppo o entità del servizio, cerchi l'app per nome e selezioni Rivedi e assegna. Prenda nota del nome del gruppo di risorse e dell'ID sottoscrizione a cui appartiene (cerchi Sottoscrizioni nel portale).

2. Effettuare il collegamento qui

Apra Integrazioni nella Sua dashboard e scelga Collega un account. Selezioni Hosting statico (Netlify, Vercel) come gruppo e Azure Static Web Apps come account, compili ID client, Segreto client, ID tenant, ID sottoscrizione e Gruppo di risorse, quindi prema Collega account.

Testiamo i dati incollati prima che venga salvato qualsiasi elemento. Una chiave non funzionante non viene mai memorizzata e la risposta indicherà l'errore riscontrato. Una chiave funzionante viene conservata crittografata nella nostra cassaforte dei segreti — mai nel nostro database — e non verrà mai più mostrata, nemmeno a Lei.

Cosa succede dopo

• Quando crea o sposta un sito statico, questo account compare come destinazione di

deploy. Azure Static Web Apps esegue la compilazione a partire da un repository — non dispone di una modalità per accettare una build caricata — pertanto il codice del sito deve provenire da un repository collegato GitHub, GitLab o Bitbucket. Se non l'ha ancora fatto, ne colleghi prima uno.

• Creiamo il servizio sul Suo account, lo indirizziamo al repository, colleghiamo il Suo dominio personalizzato

e avviamo i deploy. La pagina del dominio mostra tutti i record DNS richiesti da Azure Static Web Apps.

• L'utilizzo e la fatturazione rimangono a carico del Suo account, visibili nella Sua dashboard del fornitore.
• Un dominio apex viene verificato tramite un record TXT e un sottodominio tramite il rispettivo CNAME; la pagina del dominio mostra

quale dei due è richiesto per il Suo dominio.

Se il collegamento non riesce

Azure ha rifiutato l'entità servizio. Il segreto client è scaduto — scadono sempre, in base alla durata scelta — oppure l'app non dispone più del ruolo di Collaboratore sul gruppo di risorse. I due messaggi sono simili, pertanto verifichi l'assegnazione del ruolo prima di creare un nuovo segreto.

Non viene trovato alcun elemento. Verifichi che l'ID sottoscrizione e il Gruppo di risorse corrispondano a quelli su cui ha assegnato il ruolo e che l'ID tenant sia la directory in cui è registrata l'app.

Viene indicato che la chiave è stata rifiutata. Si tratta quasi sempre di una di queste tre cause: uno spazio o un'interruzione di riga copiati per errore, una chiave scaduta, oppure una chiave revocata o rigenerata dopo essere stata copiata. Ne crei una nuova e la incolli nuovamente.

Il collegamento riesce, ma un'operazione successiva fallisce. La chiave supera l'autenticazione ma non dispone di un permesso necessario per l'azione. Crei una nuova chiave con i permessi sopra indicati, quindi rimuova la vecchia connessione e colleghi la nuova chiave.

Disconnessione

Apra Integrazioni, individui l'account e prema Disconnetti. L'operazione elimina immediatamente la chiave memorizzata. Qualsiasi elemento che la utilizzava si arresterà all'azione successiva, e le schermate che dipendevano da essa lo segnaleranno espressamente, anziché fallire silenziosamente.

La disconnessione non annulla quanto già eseguito: record, distribuzioni o impostazioni da noi modificati sul Suo account rimangono invariati. Se ritiene che la chiave stessa possa essere stata compromessa, provveda a revocarla anche presso il fornitore; la disconnessione rimuove la nostra copia, non la loro.