Tutorials

Tutorials

Parte 5 – Agregar Swagger a GestaProject.WebAPI

Parte 5 – Agregar Swagger a GestaProject.WebAPI

 

 

 

 

 

 

 

Parte​​ 5​​ ​​ Agregar Swagger a GestaProject.WebAPI.

 

En el proyecto de GestaProject.WebAPI, necesitamos agregar algunas librerías y hacer unas pocas configuraciones en el código.

 

Swashbuckle.AspNetCore​​ ver. 4.0.1

Swashbuckle.AspNetCore.Swagger​​ ver. 4.0.1

Swashbuckle.AspNetCore.SwaggerGen​​ ver. 4.0.1

Swashbuckle.AspNetCore.SwaggerUI​​ ver. 4.0.1

 

Parar instalar esos paquetes, damos click derecho en el projecto GestaProject.WebAPI y seleccionamos Management Nuget Packages.

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Buscamos los paquetes y los instalamos.

 

Nota: es muy importante que instales la versión 4.0.1

 

Ahora tenemos que editar el archivo Startup.cs del proyecto.​​ 

 

En​​ ConfigureServices, agregamos las siguientes líneas:

 

services.AddMvc().SetCompatibilityVersion(CompatibilityVersion.Version_2_2)

                .AddJsonOptions(options => options.SerializerSettings.ContractResolver = new DefaultContractResolver());

​​ 

            services.AddSwaggerGen(options =>

            {

                options.SwaggerDoc("v1"new Swashbuckle.AspNetCore.Swagger.Info { Title = "GestaProject Web API", Version = "v1" });

            });

 

 

 

 

 

 

En​​ Configure​​ agregamos las siguientes líneas:

 

app.UseSwagger();

​​ 

            app.UseSwaggerUI(c =>

            {

                c.SwaggerEndpoint("/swagger/v1/swagger.json""GestaProject Web API v1");

            });

 

Quedando algo así:

 

 

 

En​​ ValuesController, haremos un cambio:

 

 

 

 

 

Y por​​ último​​ cambiamos la opción de Lanch browser del proyecto.

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Y si todo, les sale bien, ejecutan la solución y verán la siguiente vista.

 

Read More

Parte 4 – Crear solución y proyectos

Parte 4 – Crear solución y proyectos

 

 

 

 

 

 

Parte​​ 4​​ ​​ Crear​​ solución y proyectos.

 

Vamos a crear los siguientes proyectos:

 

GestaProject.WebUI: que es la interfaz gráfica de la aplicación.

GestaProject.WebAPI: que es la aplicación que contendrá los microservicios.

GestaProject.Data: que es la capa de datos.

GestaProject.Business: es la capa de la lógica del negocio o proyecto.

 

Abrir la carpeta GestaProject\dev-source en tu repositorio de archivos.

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Desde Visual Studio crear una solución en blanco. La solución se llamará​​ GestaProject​​ y guardarlo en la ruta​​ C:\Projects\GestaProject\dev-source.

 

Así es como debe de quedar la estructura inicial de los archivos.

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Ahora vamos a crear un nuevo proyecto que será la interfaz web de la aplicación. Para eso agregamos otro proyecto en la solución.​​ Este​​ proyecto se​​ llamará​​ GestaProject.WebUI

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Seleccionar .NET Core y ASP .NET Core 2.2​​ click en Web Application (Model-View-Controller).

 

Después​​ de agregar GestaProject.WebUI,​​ revisamos la estructura de los archivos y​​ que la aplicación funciones sin problemas.

 

 

 

 

 

 

 

 

 

 

 

 

 

Para la aplicación de los microservicios, vamos a crear el proyecto GestaProject.WebAPI, así como lo hicimos con GestaProject.WebUI, pero seleccionaremos API como template.

 

 

 

 

 

 

 

 

 

En las propiedades de la solución GestaProject, seleccionaremos Multiple startup projects y debe de quedar como se muestra en la siguiente imagen.

 

Al proyecto GestaProject.WebAPI le asigaremos el puerto 60000 y a GestaProject.WebUI el puerto 60010.

 

 

 

 

 

Ejecutamos el proyecto y nos saldrán las siguientes páginas.

 

 

 

 

 

 

 

 

 

 

Para la capa de datos y la capa de negocio agregaremos dos librerías de clases, las llamaremos GestaProject.Data y GestaProject.Business

 

 

Te muestro la estructura final en Visual Studio y en el explorar de Windows; el cual debe tener el proyecto.

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Read More

¿Como verificar si un email es verdadero o falso?

¿Como verificar si un email es verdadero o falso?

 

 

 

 

 

 

 

¿Como verificar si un email es verdadero o falso?

 

Primero un poco de teoría:

 

El phishing es el intento fraudulento de obtener información confidencial, como nombres de usuario, contraseñas y detalles de tarjetas de crédito, disfrazándose como una entidad confiable en una comunicación electrónica.​​ Por lo general, se realiza mediante falsificación de correo electrónico​​ o mensajería instantánea, a menudo dirige a los usuarios a ingresar información personal en un sitio web falso que coincide con el aspecto del sitio legítimo.

 

El phishing es un ejemplo de técnicas de ingeniería social que se utilizan para engañar a los usuarios. A menudo, los usuarios se sienten atraídos por las comunicaciones que pretenden ser de partes confiables, como sitios web sociales, sitios de subastas, bancos, procesadores de pagos en línea o administradores de TI.

 

Fuente obtenida de https://es.wikipedia.org

 

Si has recibido algún email de algún banco, empresa o persona donde te pide tus datos personales, y tienes dudas si ese email es verídico o solo es una forma de querer robar tus datos (técnica de Phishing), lee este tutorial donde te explico cómo validarlo.

 

Abre el email que te llego, los buzones de correos te muestran la cabecera (Header) del email.

 

 

 

 

​​ 

 

 

 

Por​​ ejemplo,​​ para ver las cabeceras de un email en Gmail, debes seleccionar el email y en la opción Mostrar Original (Show original):

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Veras una información en solo texto como en la siguiente imagen.​​ La cabecera de los emails contiene​​ mucha información. Como​​ quien esta mandando el email, la dirección IP y el puerto de la computadora de donde se mando el email, el proveedor de internet, en este caso es infinitum.com.mx, contiene el servidor SMTP que se uso para mandar el email (mail.alvenicloud.com), el proveedor de sitios web (hosgator.com) que es donde esta hospedado el sitio web a-score.mx.​​ ¿Con toda esta información que sigue?

 

Abre tu navegador de internet y abre al sitio web.

 

¡Boom!, en este preciso momento te das cuenta de que el email es falso, porque el sitio web de donde proviene no esta activo. Pero vamos investigando un poco más. Abre la siguiente página en tu navegador web y escribe el siguiente link ​​ https://mxtoolbox.com/. Ve a la opción Analyze Heders, copia y pega los datos de cabeceras que tienes en tu email, haz click on Analyze Header.

 

 

¡Otra vez Boom!, el servidor SMTP mail.alvenicould.com de donde se mando el mail esta dentro de la lista negra (Black List) de servidores.

Pero como somos un poco curiosos y esto te esta gustando entonces vamos a buscar más información de este email. Para esto abre en tu navegador web el link​​ https://www.iplocation.net/.

 

Copia y pega​​ la dirección​​ IP que se muestra en la columna de From, “187.152.220.135”, y has clics en IP Lookup.

 

 

 

 

 

 

Estoy seguro de que en este preciso momento quieres saber que podemos hacer con esos datos.​​ Abre Google maps, y copia y pega los datos de Latitud y Longitud con el siguiente formato:​​ 20.6667,-103.3333