Pubblica un sito statico sul Suo account Azure Static Web Apps

Che cosa fa questa connessione per Lei

Collegare il proprio account Azure Static Web Apps consente di pubblicare un sito statico sul suo account Azure Static Web Apps direttamente dalla dashboard di Zinn®. Lei è proprietario del progetto e della fattura; noi gestiamo la distribuzione, il dominio personalizzato e i record DNS.

Prima di iniziare

Un abbonamento Azure, un gruppo di risorse per i siti e un account GitHub, GitLab o Bitbucket collegato che contenga il codice: Azure Static Web Apps effettua la compilazione a partire da un repository. Il piano gratuito di Azure consente l'uso commerciale e due domini personalizzati per applicazione.

1. Creare la chiave in Azure Static Web Apps

Azure definisce questo elemento entità servizio (service principal). Nell'interfaccia di amministrazione di Microsoft Entra, apra Entra ID → Registrazioni app → Nuova registrazione, assegni un nome e faccia clic su Registra. Nella pagina di panoramica dell'app, copi l'ID applicazione (client) e l'ID directory (tenant). Apra quindi Certificati e segreti → Segreti client → Nuovo segreto client, scelga una durata e lo Aggiunga: copi subito il valore del segreto, poiché Azure lo mostra una sola volta.

Nel portale di Azure, apra il gruppo di risorse che desidera utilizziamo, quindi vada su Controllo dell'accesso (IAM) → Aggiungi → Aggiungi assegnazione ruolo. Scelga il ruolo Collaboratore, lo assegni a Utente, gruppo o entità 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, inserisca ID client, Segreto client, ID tenant, ID sottoscrizione e Gruppo di risorse, quindi prema Collega account.

Verifichiamo ciò che incolla prima che venga salvato qualsiasi elemento. Una chiave che non funziona non viene mai memorizzata e il messaggio di risposta indica qual è il problema riscontrato. Una chiave funzionante viene conservata in forma crittografata nel nostro caveau dei segreti (mai nel nostro database) e non viene mai mostrata di nuovo, nemmeno a Lei.

Cosa succede dopo

• Quando crea o sposta un sito statico, questo account viene visualizzato come destinazione

di distribuzione. Azure Static Web Apps esegue la compilazione a partire da un repository e non dispone di alcun metodo per accettare una build caricata; pertanto, il codice del sito deve provenire da un repository GitHub, GitLab o Bitbucket collegato. Se non ne ha ancora uno, ne colleghi uno per primo.

• Creiamo il servizio sul suo account, lo puntiamo al repository, vi associamo il suo dominio personalizzato

e avviamo le distribuzioni. La pagina del dominio mostra tutti i record DNS necessari ad Azure Static Web Apps.

• L'utilizzo e la fatturazione fanno capo al suo account e sono visibili nella dashboard del suo provider.
• Un dominio di primo livello viene verificato tramite un record TXT e un sottodominio tramite il relativo CNAME; la pagina del dominio indica

quale dei due è richiesto dal suo dominio.

Se il collegamento non riesce

Azure ha rifiutato l'entità servizio. Il segreto client è scaduto (questo accade sempre, in base alla durata selezionata) oppure l'app non dispone più del ruolo di Collaboratore sul gruppo di risorse. Poiché i due messaggi sono simili, 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 l'app è registrata.

Viene segnalato che la chiave è stata rifiutata. Nella quasi totalità dei casi si tratta di una di queste tre situazioni: la presenza di uno spazio o di un'interruzione di riga copiati insieme alla chiave, una chiave scaduta oppure una chiave revocata o rigenerata dopo che è stata copiata. Ne crei una nuova e la incolli di nuovo.

Il collegamento riesce, ma si verifica un errore in un secondo momento. La chiave viene autenticata ma non dispone di un'autorizzazione necessaria all'azione. Crei una nuova chiave con le autorizzazioni elencate in precedenza, quindi disconnetta la vecchia connessione e colleghi la nuova chiave.

Disconnessione

Apri Integrazioni, trovi l'account e prema Disconnetti. Questa operazione elimina immediatamente la chiave memorizzata. Qualsiasi elemento che la stesse utilizzando si interromperà all'azione successiva e le schermate che dipendevano da essa lo segnaleranno anziché restituire un errore silenzioso.

La disconnessione non annulla le operazioni già eseguite: i record, le distribuzioni o le impostazioni che abbiamo modificato sul suo account rimangono inalterati. Se ritiene che la chiave stessa possa essere stata compromessa, la revochi anche presso il provider; la disconnessione rimuove la nostra copia, non la loro.