Inicio de sesión único (SSO) de ASP.NET OAuth utilizando AWS Cognito como proveedor de OAuth

El módulo ASP.NET OAuth Single Sign-On (SSO) brinda la posibilidad de habilitar el inicio de sesión único OAuth para sus aplicaciones ASP.NET. Al utilizar el inicio de sesión único, puede utilizar solo una contraseña para acceder a su aplicación y servicios ASP.NET. Nuestro módulo es compatible con todos los proveedores de identidad compatibles con OAuth. Aquí repasaremos una guía paso a paso para configurar el inicio de sesión único (SSO) entre ASP.NET y AWS Cognito considerando a AWS Cognito como proveedor de OAuth.

Descargar y extraer paquete

• Descargar Módulo miniOrange ASP.NET OAuth 2.0.
• Para configurar el conector, extraiga el asp-net-oauth-sso-module.zip, encontrará un archivo DLL miniorange-oauth-sso.dll, un archivo de configuración oauthsso.config y integración.md archivo que contiene los pasos para agregar el módulo a su aplicación.

1. Agregue el conector en su aplicación.

• Agregar miniorange-oauth-sso.dll en la carpeta bin (donde existen sus otros archivos DLL) para su aplicación.
• Registrarse miniorangeoauthsso módulo en su aplicación de acuerdo con los pasos proporcionados en el integración.md .
• Agregue el archivo de configuración proporcionado oauthsso.config en el directorio raíz de su aplicación.
• Después de la integración, abra el navegador y explore el panel del conector con la siguiente URL:
  https:// <your-application-base-url>/?ssoaction=config
• Si aparece la página de registro o la página de inicio de sesión, ha agregado exitosamente el conector miniOrange oauth sso para su aplicación.

• Regístrese o para configurar el conector.

2. Configure Amazon Cognito como proveedor de OAuth

• En primer lugar, ve a Consola de Amazon y regístrese/inicie sesión en su cuenta para configurar AWS Cognito.

• Busque Cognito en el Servicios de AWS barra de búsqueda como se muestra a continuación.

• Haga clic en Administrar grupos de usuarios para ver la lista de sus grupos de usuarios.

• Haga clic en Crear un grupo de usuarios para crear un nuevo grupo de usuarios.

• Agregue un Nombre del grupo y haga clic en el ícono de Revisar valores predeterminados botón para continuar.

• Desplácese hacia abajo y haga clic en Agregar cliente de aplicación opción frente a Clientes de aplicaciones.

• Haga clic en Agregue un cliente de aplicación. Ingrese una Nombre del cliente de la aplicación y haga clic en Crear cliente de aplicación para crear un cliente de aplicación.

• Haga clic en Volver a los detalles de la piscina para volver a su configuración.

• Haga clic en Crear grupo para guardar su configuración y crear un grupo de usuarios.

• En la barra de navegación presente en el lado izquierdo, haga clic en el Configuración del cliente de la aplicación en la sección de Integración de aplicaciones .

• Habilitar proveedor de identidad como Grupo de usuarios de Cognito y entra tu URL de devolución de llamada/redireccionamiento del cual obtendrás Cliente miniOrange ASP.NET OAuth (Lazy section loading) bajo la sección URL de devolución de llamada campo de texto. Seleccionar Concesión del código de autorización casilla de verificación debajo de Flujos de OAuth permitidos y también seleccionar abierto y perfiles casillas de verificación debajo de Ámbitos de OAuth permitidos opción (consulte la imagen a continuación). Clickea en el Guardar Cambios botón para guardar sus configuraciones.

• Haga clic en Elija el nombre de dominio opción para establecer un nombre de dominio para su aplicación.

• Ingrese su nombre de dominio en Prefijo de dominio campo de texto y haga clic en el Guardar Cambios para guardar su nombre de dominio.

• Haga clic en Clientes de aplicaciones en la sección de Ajustes generales menú en la barra de navegación del lado izquierdo. Luego, haga clic en el Mostrar detalles para ver los detalles de su aplicación, como ID de cliente, secreto de cliente, etc.

• Copie los valores del campo de texto ID de la aplicación del cliente y Secreto de la aplicación del cliente que necesitará en Paso 3 para configurar Cliente miniOrange ASP.NET OAuth.

• Haga clic en Usuarios y grupos en la sección de Ajustes generales menú en la barra de navegación del lado izquierdo. Luego, haga clic en el Crear usuario botón para agregar un nuevo usuario.

• Complete todos los datos requeridos y haga clic en Crear usuario.

• Podrás ver el nuevo usuario creado.



Puntos finales y alcance de AWS Cognito:




Identificación del cliente :	Haga clic aquí
Secreto del cliente:	Haga clic aquí
Alcance:	abierto
Autorizar punto final:	https://<cognito-app-domain>/oauth2/authorize
Punto final del token de acceso:	https://<cognito-app-domain>/oauth2/token
Obtener punto final de información del usuario:	https://<cognito-app-domain>/oauth2/userInfo
URL de redireccionamiento personalizada después de cerrar sesión:[Opcional]	https://<cognito-app-domain>/logout?client_id=<Client-ID>&logout_uri=<Sign out URL configured in Cognito Portal>

3. Configurar el cliente miniOrange ASP.NET OAuth

• Después de configurar su proveedor de OAuth, le proporcionará ID de cliente, secreto de cliente, punto final autorizado, punto final de token de acceso y Obtener punto final de información de usuario. Configure estos valores en los campos respectivos.
• Complete todos los datos requeridos y haga clic en Guardar configuración.

4. Configuración de prueba

• Después de guardar la configuración, haga clic en el Configuración de prueba para verificar si ha configurado correctamente.
• Si la configuración es exitosa, obtendrá Nombre de los atributos y Valores de atributo en la ventana Configuración de prueba. La siguiente captura de pantalla muestra un resultado exitoso.
• 

5. Mapeo de atributos

• Asigne los nombres de atributos proporcionados por su servidor OAuth con los atributos de su aplicación ASP.NET que se encuentran en la sección Asignación de atributos y haga clic en Guardar asignación de atributos.

• Nota: Todos los atributos asignados se almacenarán en la sesión para que pueda acceder a ellos en su aplicación.

6. Código de integración

• Usted puede encontrar el código de integración en la pestaña Código de integración en el conector. Simplemente copie y pegue ese fragmento de código donde quiera acceder a los atributos del usuario.

7. Agregue el siguiente enlace en su solicitud de inicio de sesión único (SSO)

• Utilice la siguiente URL como enlace en su aplicación desde donde desea realizar SSO:
  http://base-url/?ssoaction=login
• Por ejemplo puedes usarlo como:
  <a href="http://base-url/?ssoaction=login”>Log in</a>"

Puede configurar el módulo de inicio de sesión único (SSO) ASP.NET SAML 2.0 con cualquier proveedor de identidades como ADFS, Azure AD, Bitium, Centrify, G Suite, JBoss Keycloak, Okta, OneLogin, Salesforce, AWS Cognito, OpenAM, Oracle, PingFederate, PingOne, RSA SecureID, Shibboleth-2, Shibboleth-3, SimpleSAML, WSO2 o incluso con su propio proveedor de identidades personalizado.