{"id":1956,"date":"2015-12-16T19:28:46","date_gmt":"2015-12-16T19:28:46","guid":{"rendered":"https:\/\/www.couchbase.com\/blog\/?p=1956"},"modified":"2025-10-09T07:26:48","modified_gmt":"2025-10-09T14:26:48","slug":"the-couchbase-asp-net-identity-storage-provider-part-1","status":"publish","type":"post","link":"https:\/\/www.couchbase.com\/blog\/es\/the-couchbase-asp-net-identity-storage-provider-part-1\/","title":{"rendered":"El proveedor de almacenamiento de identidad ASP.NET de Couchbase: Parte 1"},"content":{"rendered":"

En Sistema de identidad ASP.NET <\/a>es una nueva colecci\u00f3n de componentes de software para la autenticaci\u00f3n en aplicaciones ASP.NET. Proporciona mejoras significativas sobre los anteriores ASP.NET Membership y Simple Membership y pretende facilitar el soporte de almacenes de respaldo no relacionales, como Couchbase Server. Adem\u00e1s de la autenticaci\u00f3n y la autorizaci\u00f3n, proporciona un almac\u00e9n de perfiles, autorizaci\u00f3n basada en funciones y reclamaciones, compatibilidad con inicios de sesi\u00f3n sociales como Facebook y Twitter y compatibilidad con OWIN... ya no depende del espacio de nombres System.Web.<\/p>\n

Couchbase ASP.NET Identity Provider pretende ser un proveedor \"completo\" que soporte casi todas, si no todas, las caracter\u00edsticas de ASP.NET Identity API. En esta Developer Preview (DP) s\u00f3lo se ha probado la parte de autenticaci\u00f3n; en versiones posteriores se a\u00f1adir\u00e1 la autorizaci\u00f3n basada en roles y reclamaciones, as\u00ed como la integraci\u00f3n con proveedores de medios sociales de terceros a trav\u00e9s de Single Sign-On (SSO), adem\u00e1s de caracter\u00edsticas como la autenticaci\u00f3n de dos factores por SMS y correo electr\u00f3nico. En este post<\/p>\n

le mostraremos c\u00f3mo integrar el Proveedor de Identidad ASP.NET DP de Couchbase con una Aplicaci\u00f3n Web ASP.NET MVC.<\/p>\n

Primeros pasos<\/h2>\n

El paquete est\u00e1 disponible en NuGet o puedes construirlo t\u00fa mismo desde el repositorio en Github que se encuentra aqu\u00ed. Para este blog vamos a utilizar los paquetes publicados a trav\u00e9s de NuGet.<\/p>\n

Usando Visual Studio 2013 (o quiz\u00e1s 2015), crea una nueva Aplicaci\u00f3n Web MVC como sigue:<\/p>\n

<\/p>\n

Puedes ponerle el nombre que quieras; yo lo llam\u00e9 CouchbaseIdentity. Haz clic en \"Aceptar\" y selecciona MVC en el siguiente cuadro de di\u00e1logo.<\/p>\n

<\/p>\n

Haga clic en \"Aceptar\" de nuevo y Visual Studio crear\u00e1 el proyecto MVC para usted. Por defecto, Visual Studio utilizar\u00e1 el proveedor de identidad de Entity Framework. Como queremos utilizar el proveedor de identidad de Couchbase, tenemos que eliminar la dependencia del paquete del proveedor de Entity Framework, a\u00f1adir la referencia al paquete Couchbase Identity y luego reemplazar todas las referencias a using Microsoft.AspNet.Identity.EntityFramework; con Couchbase.AspNet.Identity.<\/p>\n

Para cambiar la dependencia del paquete, abra el Gestor de paquetes NuGet y localice el paquete Microsoft ASP.NET Identity EntityFramework y desinst\u00e1lelo:<\/p>\n

<\/p>\n

En este punto tendr\u00e1s que reiniciar Visual Studio. A continuaci\u00f3n, ve a la pesta\u00f1a \"Online\", cambia el men\u00fa desplegable a \"Include Prerelease\" y escribe \"couchbase\" en el cuadro de texto de b\u00fasqueda:<\/p>\n

<\/p>\n

Seleccione Couchbase ASP.NET Identity y haga clic en \"Instalar\" y \"Cerrar\" para cerrar el cuadro de di\u00e1logo.<\/p>\n

Actualizaci\u00f3n de las dependencias de los paquetes<\/h2>\n

Ahora que has cambiado los paquetes por defecto del Proveedor de Identidad de Entity Framework y lo has reemplazado por las dependencias y el paquete de Identidad ASP.NET de Couchbase, necesitas actualizar el proyecto para usar el nuevo proveedor.<\/p>\n

En primer lugar, sustituya todas las referencias a using Microsoft.AspNet.Identity.EntityFramework; <\/em><\/strong>con usando Couchbase.AspNet.Identity<\/strong><\/em>;. La forma m\u00e1s f\u00e1cil de hacerlo es una simple b\u00fasqueda y reemplazo (Ctrl F).<\/p>\n

A continuaci\u00f3n, en IdentityModels.cs, cambia la clase ApplicationDbContext para que derive de ThrowableBucket en lugar de IdentityDbContext y, a continuaci\u00f3n, anula el constructor base para que se pase el Bucket que elegiste para almacenar la informaci\u00f3n de identidad. Yo eleg\u00ed almacenar mi informaci\u00f3n de Identidad en el bucket \"por defecto\"; puedes crear un bucket separado si lo deseas:<\/p>\n

<\/p>\n

Ten en cuenta que \"ThrowableBucket\" es una envoltura alrededor de algunos m\u00e9todos CRUD de CouchbaseBucket que cambia ligeramente el comportamiento del SDK; los fallos de operaci\u00f3n son lanzados. En futuras versiones, esto puede cambiar.<\/p>\n

Por \u00faltimo, abra el archivo Global.asax y a\u00f1ada el c\u00f3digo para inicializar el SDK de Couchbase, que utiliza el proveedor de identidad ASP.NET de Couchbase:<\/p>\n

<\/p>\n

El ClusterHelper es una clase de ayuda para el SDK .NET de Couchbase que facilita la gesti\u00f3n de buckets y referencias. Se recomienda inicializar el ClusterHelper en Application_Start y cerrarlo en Application_End. Una vez completado este paso, \u00a1la aplicaci\u00f3n web est\u00e1 lista para usar Couchbase como almac\u00e9n de respaldo para identidades y perfiles!<\/p>\n

\u00a1Prob\u00e1ndolo!<\/h2>\n

Una vez completados los pasos anteriores, puede probar la integraci\u00f3n ejecutando la aplicaci\u00f3n (bot\u00f3n derecho>debug=>Start new instance) y navegando hasta la p\u00e1gina de registro:<\/p>\n

<\/p>\n

Introduzca su direcci\u00f3n de correo electr\u00f3nico y su contrase\u00f1a, conf\u00edrmela y haga clic en \"Registrarse\".<\/p>\n

<\/p>\n

Suponiendo que todo ha ido bien, deber\u00eda ser redirigido de nuevo a la p\u00e1gina de inicio y deber\u00eda ver un mensaje \"Hola ....\". Ya est\u00e1s autenticado.<\/p>\n

<\/p>\n

C\u00f3mo se modela el perfil en Couchbase<\/h2>\n

El proveedor de identidad por defecto se basa en una serie de tablas relacionales con claves externas que enlazan los datos. El proveedor ASP.NET de Couchbase adopta el enfoque NoSQL y almacena los datos como documentos JSON y utiliza \"\u00edndices manuales\" para los \u00edndices secundarios en los casos en que la clave para obtener los datos no es un \u00edndice primario.<\/p>\n

El documento primario tiene la siguiente estructura:<\/p>\n

<\/p>\n

Se trata de un documento bastante sencillo; en casi todos los casos utilizamos la \"incrustaci\u00f3n\" para almacenar relaciones como Roles y Reclamaciones (las repasaremos en una entrada posterior del blog). Para realizar una b\u00fasqueda en un campo de este documento, creamos un segundo documento binario que asocia la direcci\u00f3n de correo electr\u00f3nico del perfil con la clave primaria (914dc..); esto es similar a un concepto de modelado llamado \"referencia\".<\/p>\n

<\/p>\n

Podr\u00edamos haber utilizado consultas N1QL que har\u00edan obsoletos los \u00edndices secundarios \"manuales\", pero la intenci\u00f3n es soportar Couchbase Server 3.0 y superiores; N1QL ser\u00e1 una caracter\u00edstica de Couchbase Server 4.0 que se lanzar\u00e1 a finales de este a\u00f1o.<\/p>\n

C\u00f3mo conseguirlo:<\/h2>\n

Couchbase ASP.NET Identity Provider est\u00e1 disponible como paquete en NuGet o puede ser construido directamente desde el c\u00f3digo fuente usando el repositorio de Github. Si deseas contribuir, los pull requests son siempre bienvenidos. Si encuentras un bug, puedes crear un ticket en Jira y ser\u00e1s notificado de su estado actual.<\/p>\n