Implemente un sitio estático en su propia cuenta de Azure Static Web Apps

Qué ventajas le ofrece conectarlo

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 control de Zinn®. Usted es propietario del proyecto y de la facturación; 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 el uso comercial y dos dominios personalizados por aplicación.

1. Cree la clave en Azure Static Web Apps

Azure denomina a esto una 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 pulse Registrar. 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 pulse Agregar; copie el valor del secreto de inmediato, ya que Azure solo lo muestra una vez.

En Azure Portal, abra el grupo de recursos que desee que utilicemos y, después, vaya a Control de acceso (IAM) → Agregar → Agregar asignación de roles. Elija el rol Colaborador, asígnelo a Usuario, grupo o entidad de servicio, busque la aplicación por su nombre y pulse 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éctelo aquí

Abra Integraciones en su panel de control y elija Conectar una cuenta. Seleccione Alojamiento estático (Netlify, Vercel) como grupo y Azure Static Web Apps como cuenta, complete los campos Id. de cliente, Secreto de cliente, Id. de inquilino, Id. de suscripción y Grupo de recursos, y pulse Conectar cuenta.

Probamos lo que pega antes de guardar nada. Una clave que no funciona nunca se almacena, y la respuesta indica qué falló en ella. Una clave que funciona se conserva cifrada en nuestro baúl 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 transfiere un sitio estático, esta cuenta aparece como destino

de despliegue. Azure Static Web Apps compila a partir de un repositorio (no ofrece ninguna forma de aceptar una compilación subida), 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 vinculamos 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 son visibles en el panel de control de su propio proveedor.
• Los dominios ápice se verifican mediante un registro TXT y los subdominios mediante su CNAME; la página del dominio muestra

cuál de ellos necesita su dominio.

Si no se conecta

Azure rechazó la entidad de servicio. O bien el secreto de cliente ha caducado (siempre lo hacen, según la duración que haya elegido), o bien la aplicación ya no tiene el rol de Colaborador en el grupo de recursos. Ambos mensajes son similares, por lo que conviene comprobar 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 coincidan con aquellos en los que asignó el rol, y que el Id. de inquilino corresponda al 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: se copió un espacio o un salto de línea junto con ella, la clave ha caducado, o bien la clave se revocó o se regeneró después de que la copiara. Cree una nueva y péguela de nuevo.

Se conecta, pero más adelante se produce un error. La clave se autentica, pero carece de un permiso que la acción necesita. Cree una nueva clave con los permisos indicados anteriormente; a continuación, 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. Cualquier elemento que la estuviera utilizando se detendrá en su siguiente acción, y las pantallas que dependían de ella lo indicarán en lugar de fallar de manera silenciosa.

Desconectar no revierte lo que ya se haya realizado: los registros, despliegues o ajustes que hayamos modificado en su cuenta permanecerán tal como están. Si considera que la propia clave ha podido filtrarse, revóquela también en el proveedor; desconectarla elimina nuestra copia, no la suya.