Una de las ventajas que tiene .NET como plataforma de desarrollo, es la capacidad de
poder hacer prácticamente de todo a través de la línea de comandos, y en esta
oportunidad, será el primero de tres artículos para la publicación de un API REST
construido con .NET 7.0.
CORS
Algo que muchos desarrolladores obvian antes de publicar un API REST, es configurar
el CORS (CROSS ORIGIN RESOURCE SHARING), intercambio de recursos deW
origen cruzado, por sus siglas en inglés, es un mecanismo basado en cabeceras
HTTP que permite a un servidor indicar cualquier dominio, esquema o puerto con un
origen distinto del suyo desde el que un navegador debería permitir la carga de
recursos.
Para habilitarlo, en el archivo Program del API REST, debemos crear una constante
con el nombre de la configuración a crear.
const string corsConfiguration = «CorsAPI»;
Luego escribimos la configuración en la parte de servicios.
Por último, después de la línea var app = builder.Build(); escribimos esto:
app.UseCors(corsConfiguration);
Generar los archivos de publicación
Azure Boards
Literalmente con una sola línea de comandos podemos hacerlo, escribiremos lo
siguiente:
Para esta ocasión estoy usando una carpeta llamada C:\Servidor\ApiRest, esta
carpeta debe estar completamente fuera de la carpeta donde tenemos el código
fuente.
El contenido de la carpeta puede variar dependiendo de todas las referencias de tu
proyecto.
Instalación de Servidor de aplicaciones IIS
Hay ocasiones, en que no siempre el servidor de aplicaciones IIS (Internet Information
Services) está presente en nuestro equipo de desarrollo, pero habilitarlo es tan sencillo
como marcar un simple check, para ello escribiremos en la ventana de comandos
(CMD) o en la ventana de ejecutar (+ R) lo siguiente:
Una vez realizado, nos abrirá la siguiente ventana
Marcamos lo mostrado en la siguiente ventana, tal cual está, si gustas puedes marcar todas las
opciones, pero no se recomienda ya que sólo ocuparás espacio en el disco en vano,
antiguamente esto requería que insertes el disco de instalación de Windows, pero ahora tanto
con Windows 10 y 11, sólo es necesario que tengamos conexión a Internet y listo.
Requisitos previos para IIS
Ya que usaremos IIS para poder hospedar nuestra aplicación, lo primero que debemos instalar es el paquete Hosting Bundle de ASP.NET, ya que este último, instalará los
módulos necesarios en IIS para poder lograrlo.
Podemos descargarlo desde la web oficial de .NET y bajamos la versión conforme a la arquitectura de nuestro procesador y lo instalamos.
https://dotnet.microsoft.com/es-es/download/dotnet/7.0
Los pasos de instalación son tan sencillos como cualquier otro tutorial de instalaciones, después de ello, ya podremos configurar nuestra API REST.
Configurar el Sitio Web
En IIS, configurar un Sitio Web requiere que tengamos disponible un puerto en nuestra
computadora
Aquí expandiremos el nodo de servidor y escogemos la carpeta Sitios, hacemos click derecho y
escogemos la opción Agregar Sitio Web y llenamos los datos según esta pantalla:
Debemos definir un nombre para el sitio, el cual debe ser único por PC, en la sección que indica ruta de acceso física, colocamos la carpeta que hicimos en el proceso de publicación.
Donde indica puerto para este ejemplo utilizo el 9500, pero puedes escoger el que mejor te parezca. En el tipo de enlace lo dejamos por defecto por HTTP, ya que por ahora no estamos configurando ningún certificado digital, por lo cual no será necesario, lo mismo sucede con el nombre de host, ya que tampoco estamos configurando un dominio previamente adquirido.
Dejamos la marca de Iniciar sitio web inmediatamente y le damos click a Aceptar.
Probando el API REST
Ahora sólo nos queda probar el API REST en el navegador, para este caso usaremos
Firefox, e invocaremos a un método HTTP con el verbo GET, que es lo que hacen los
navegadores por default, y veremos la respuesta.
Ésta, al ser un API REST que se ha construido en base a un requerimiento específico puede ser
diferente al que uses tú, asi que aquí puedes usar el método que sea que hayas construido.
Debido a que en Firefox los resultados en JSON se estilizan de forma automática, se
puede apreciar el resultado formateado, el cual puede variar dependiendo del
navegador que utilices.
Espero que el artículo te haya servido de ayuda.
