Déployez un site statique sur votre propre compte Azure Static Web Apps

Ce que cette connexion vous apporte

Connecter votre propre compte Azure Static Web Apps vous permet de publier un site statique sur votre compte Azure Static Web Apps depuis votre tableau de bord Zinn®. Vous êtes propriétaire du projet et de la facturation ; nous gérons le déploiement, le domaine personnalisé et les enregistrements DNS.

Avant de commencer

Un abonnement Azure, un groupe de ressources pour les sites, et un compte GitHub, GitLab ou Bitbucket connecté contenant le code — Azure Static Web Apps effectue les builds à partir d’un dépôt. Le forfait gratuit d’Azure autorise une utilisation commerciale et deux domaines personnalisés par application.

1. Créer la clé sur Azure Static Web Apps

Azure appelle cela un principal de service. Dans le centre d’administration Microsoft Entra, ouvrez Entra ID → Inscriptions d’applications → Nouvelle inscription, donnez-lui un nom et cliquez sur S’inscrire. Sur la page de vue d’ensemble de l’application, copiez l'ID d’application (client) et l'ID de l’annuaire (locataire). Ouvrez ensuite Certificats & secrets → Secrets client → Nouveau secret client, choisissez une durée et cliquez sur Ajouter — copiez immédiatement la valeur du secret, Azure ne l’affiche qu’une seule fois.

Dans le portail Azure, ouvrez le groupe de ressources que vous souhaitez que nous utilisions, puis Contrôle d’accès (IAM) → Ajouter → Ajouter une attribution de rôle. Choisissez le rôle Contributeur, attribuez-le à Utilisateur, groupe ou principal de service, recherchez l’application par son nom, puis cliquez sur Vérifier + attribuer. Notez le nom du groupe de ressources et l'ID d’abonnement auquel il appartient (recherchez Abonnements dans le portail).

2. Le connecter ici

Ouvrez Intégrations dans votre tableau de bord et choisissez Connecter un compte. Sélectionnez Hébergement statique (Netlify, Vercel) comme groupe et Azure Static Web Apps comme compte, renseignez ID client, Secret client, ID de locataire, ID d’abonnement et Groupe de ressources, puis appuyez sur Connecter le compte.

Nous testons ce que vous collez avant que quoi que ce soit ne soit enregistré. Une clé qui ne fonctionne pas n’est jamais stockée, et la réponse indique le problème rencontré. Une clé fonctionnelle est conservée sous forme chiffrée dans notre coffre-fort de secrets — jamais dans notre base de données — et n’est plus jamais affichée, même à vous.

Que se passe-t-il ensuite

• Lorsque vous créez ou déplacez un site statique, ce compte apparaît comme une cible de déploiement.

Azure Static Web Apps effectue les builds à partir d’un dépôt — il ne peut pas accepter de build téléversé — le code du site doit donc provenir d’un dépôt GitHub, GitLab ou Bitbucket connecté. Connectez-en un d’abord si vous ne l’avez pas encore fait.

• Nous créons le service sur votre compte, le faisons pointer vers le dépôt, lui associons votre domaine personnalisé et déclenchons les déploiements. La page du domaine affiche tous les enregistrements DNS requis par Azure Static Web Apps.
• L’utilisation et la facturation sont sur votre compte, visibles dans votre propre tableau de bord fournisseur.
• Un domaine apex est vérifié par un enregistrement TXT et un sous-domaine par son CNAME ; la page du domaine indique celui dont votre domaine a besoin.

En cas d’échec de la connexion

Azure a refusé le principal de service. Soit le secret client a expiré — ils expirent toujours, selon la durée que vous avez choisie — soit l’application n’a plus le rôle de Contributeur sur le groupe de ressources. Les deux messages se ressemblent, vérifiez donc l’attribution de rôle avant de créer un nouveau secret.

Rien n’est trouvé. Vérifiez que l'ID d’abonnement et le Groupe de ressources sont bien ceux auxquels vous avez attribué le rôle, et que l'ID de locataire correspond à l’annuaire dans lequel l’application est inscrite.

La clé est indiquée comme rejetée. Il s’agit presque toujours de l’une de ces trois choses : un espace ou un saut de ligne copié avec la clé, une clé expirée, ou une clé révoquée ou régénérée après que vous l’avez copiée. Créez-en une nouvelle et collez-la à nouveau.

La connexion réussit, mais une erreur survient plus tard. La clé s’authentifie mais ne dispose pas d’une permission requise par l’action. Créez une nouvelle clé avec les permissions listées ci-dessus, puis déconnectez l’ancienne connexion et connectez la nouvelle clé.

Déconnexion

Ouvrez Intégrations, trouvez le compte et appuyez sur Déconnecter. Cela supprime immédiatement la clé stockée. Tout ce qui l’utilisait s’arrête à sa prochaine action, et les écrans qui en dépendaient l’indiquent clairement au lieu d’échouer silencieusement.

La déconnexion n’annule pas ce qui a déjà été fait — les enregistrements, déploiements ou paramètres que nous avons modifiés sur votre compte restent inchangés. Si vous pensez que la clé elle-même a pu fuiter, révoquez-la également auprès du fournisseur ; la déconnexion supprime notre copie, pas la leur.