Qué le aporta esta conexión
Conectar su propia cuenta de Azure Static Web Apps le permite publicar un sitio estático en su cuenta de Azure Static Web Apps desde su panel de Zinn®. Usted es propietario del proyecto y de la factura; nosotros nos encargamos del despliegue, del dominio personalizado y de los registros DNS.
Antes de empezar
Una suscripción de Azure, un grupo de recursos para los sitios y una cuenta conectada de GitHub, GitLab o Bitbucket que contenga el código: Azure Static Web Apps compila a partir de un repositorio. El plan gratuito de Azure permite uso comercial y dos dominios personalizados por aplicación.
1. Cree la clave en Azure Static Web Apps
Azure llama a esto entidad de servicio. En el centro de administración de Microsoft Entra, abra Entra ID → Registros de aplicaciones → Nuevo registro, asígnele un nombre y Regístrese. En la página de información general de la aplicación, copie el ID de aplicación (cliente) y el ID de directorio (inquilino). A continuación, abra Certificados y secretos → Secretos de cliente → Nuevo secreto de cliente, elija una duración y Agréguelo: copie el valor del secreto de inmediato, ya que Azure solo lo muestra una vez.
En el portal de Azure, abra el grupo de recursos que desea que utilicemos y, a continuación, Control de acceso (IAM) → Agregar → Agregar asignación de roles. Elija el rol de Colaborador, asígnelo a Usuario, grupo o entidad de servicio, busque la aplicación por su nombre y seleccione Revisar y asignar. Anote el nombre del grupo de recursos y el ID de suscripción al que pertenece (busque Suscripciones en el portal).
2. Conéctela aquí
Abra Integraciones en su panel y elija Conectar una cuenta. Seleccione Alojamiento estático (Netlify, Vercel) como grupo y Azure Static Web Apps como cuenta, introduzca el ID de cliente, el Secreto de cliente, el ID de inquilino, el ID de suscripción y el Grupo de recursos, y pulse Conectar cuenta.
Probamos lo que pega antes de que se guarde nada. Una clave que no funciona nunca se almacena, y el mensaje indica qué fallaba en ella. Una clave válida se mantiene cifrada en nuestro cofre de secretos —nunca en nuestra base de datos— y no se vuelve a mostrar jamás, ni siquiera a usted.
Qué ocurre después
- Cuando crea o mueve un sitio estático, esta cuenta aparece como destino de
despliegue. Azure Static Web Apps compila a partir de un repositorio (no tiene forma de aceptar una compilación cargada), por lo que el código del sitio debe provenir de un repositorio conectado de GitHub, GitLab o Bitbucket. Conecte uno primero si aún no lo ha hecho.
- Creamos el servicio en su cuenta, lo apuntamos al repositorio, asociamos su dominio personalizado
y activamos los despliegues. La página del dominio muestra cualquier registro DNS que Azure Static Web Apps necesite.
- El uso y la facturación corresponden a su cuenta y se pueden ver en el panel de su propio proveedor.
- Un dominio raíz se verifica mediante un registro TXT y un subdominio mediante su CNAME; la página del dominio indica
cuál de los dos necesita su dominio.
Si no se conecta
Azure ha rechazado la entidad de servicio. O bien el secreto de cliente ha caducado (siempre lo hacen en función de la duración que haya elegido) o la aplicación ya no tiene el rol de Colaborador en el grupo de recursos. Los dos mensajes son similares, así que compruebe la asignación de roles antes de crear un nuevo secreto.
No se encuentra nada. Compruebe que el ID de suscripción y el Grupo de recursos son aquellos en los que asignó el rol, y que el ID de inquilino es el directorio en el que está registrada la aplicación.
Indica que se ha rechazado la clave. Casi siempre se debe a una de estas tres causas: un espacio o un salto de línea copiado junto con ella, una clave que ha caducado o una clave que fue revocada o regenerada después de haberla copiado. Cree una nueva y vuelva a pegarla.
Se conecta, pero algo falla más adelante. La clave se autentica pero carece de un permiso que la acción necesita. Cree una nueva clave con los permisos indicados anteriormente, desconecte la conexión antigua y conecte la nueva clave.
Desconexión
Abra Integraciones, busque la cuenta y pulse Desconectar. Esto elimina la clave almacenada de inmediato. Todo lo que la estuviera utilizando se detiene en su siguiente acción, y las pantallas que dependían de ella lo notifican en lugar de fallar silenciosamente.
Desconectar no deshace lo que ya se había hecho; los registros, los despliegues o la configuración que hayamos modificado en su cuenta se mantendrán tal como están. Si cree que la clave en sí pudo haberse filtrado, revóquela también en el proveedor; la desconexión elimina nuestra copia, no la de ellos.