Authentification unique (SSO) ASP.NET OAuth utilisant WHMCS comme fournisseur OAuth

Le module ASP.NET OAuth Single Sign-On (SSO) permet d'activer l'authentification unique OAuth pour vos applications ASP.NET. Grâce à l'authentification unique, vous ne pouvez utiliser qu'un seul mot de passe pour accéder à votre application et à vos services ASP.NET. Notre module est compatible avec tous les fournisseurs d'identité compatibles OAuth. Ici, nous allons passer en revue un guide étape par étape pour configurer l'authentification unique (SSO) entre ASP.NET et WHMCS en considérant WHMCS comme fournisseur OAuth.

Pré-requis : Téléchargement Et Installation

• Télécharger Module miniOrange ASP.NET OAuth 2.0.
• Pour la mise en place du connecteur, extrayez le asp-net-oauth-sso-module.zip, vous trouverez un fichier DLL miniorange-oauth-sso.dll, un fichier de configuration oauthsso.config et intégration.md fichier qui contient les étapes d’ajout du module dans votre application.

Étapes pour configurer la connexion WHMCS Single Sign-On (SSO) à ASP.NET

1. Ajoutez le connecteur dans votre application

• Ajouter miniorange-oauth-sso.dll dans le dossier bin (où existent vos autres fichiers DLL) pour votre application.
• Inscription miniorangeoauthsso module dans votre application selon les étapes fournies dans le intégration.md fichier.
• Ajoutez le fichier de configuration fourni oauthsso.config dans le répertoire racine de votre application.
• Après l'intégration, ouvrez le navigateur et parcourez le tableau de bord du connecteur avec l'URL ci-dessous :
  https:// <your-application-base-url>/?ssoaction=config
• Si la page d'inscription ou la page de connexion apparaît, vous avez ajouté avec succès le connecteur sso oauth miniOrange pour votre application.

• Inscrivez-vous ou Connectez-vous pour configurer le connecteur.

2. Configurer WHMCS en tant que fournisseur OAuth

• Tout d'abord, accédez à votre domaine WHMCS et connectez-vous à votre compte administrateur WHMCS.
• L’écran suivant vous sera présenté. Aller à installation OpenID Connect sur la barre de navigation en haut.

• Cliquez sur Générer de nouveaux identifiants d'API client .

• Vous serez redirigé vers la page de détails de l'application. Remplissez les informations requises et entrez URI de redirection autorisés de Client OAuth miniOrange ASP.NET et cliquez sur Générer des identifiants.

• Vous serez redirigé vers la page de détails de l'application. Ici, vous pouvez trouver identité du client ainsi que Secret client dont vous aurez besoin dans Étape 3 configurer Client OAuth miniOrange ASP.NET.



Paramètres et portée du WHMCS :




Identité du client :	Cliquez ici
Secret client :	Cliquez ici
Portée:	email de profil openid
Autoriser le point de terminaison :	https://{yourWHMCSdomain}/oauth/authorize.php
Point de terminaison du jeton d’accès :	https://{yourWHMCSdomain}/oauth/token.php
Obtenir le point de terminaison des informations utilisateur :	https://{yourWHMCSdomain}/oauth/userinfo.php

3. Configurer le client OAuth miniOrange ASP.NET

• Après avoir configuré votre fournisseur OAuth, il vous fournira ID client, secret client, autoriser le point de terminaison, point de terminaison du jeton d'accès ainsi que Obtenir le point de terminaison des informations utilisateur. Configurez ces valeurs dans les champs respectifs.
• Remplissez tous les détails requis et cliquez sur Enregistrer la configuration.

4. Configuration des tests

• Après avoir enregistré la configuration, cliquez sur le Configuration du test bouton pour vérifier si vous avez configuré correctement.
• En cas de configuration réussie, vous obtiendrez Nom des attributs ainsi que Valeurs d'attribut dans la fenêtre Configuration du test. La capture d'écran ci-dessous montre un résultat réussi.
• 

5. Cartographie des attributs

• Mappez les noms d'attributs fournis par votre serveur OAuth avec les attributs de votre application ASP.NET indiqués dans la section Mappage d'attributs et cliquez sur Enregistrer le mappage d'attributs.

• Remarque : Tous les attributs mappés seront stockés dans la session afin que vous puissiez y accéder dans votre application.

6. Code d'intégration

• Vous pouvez trouver code d'intégration dans l'onglet Code d'intégration du connecteur. Copiez-collez simplement cet extrait de code là où vous souhaitez accéder aux attributs utilisateur.

7. Ajoutez le lien suivant dans votre demande d'authentification unique (SSO)

• Utilisez l'URL suivante comme lien dans votre application à partir de laquelle vous souhaitez effectuer le SSO :
  http://base-url/?ssoaction=login
• Par exemple, vous pouvez l'utiliser comme :
  <a href="http://base-url/?ssoaction=login”>Log in</a>"

Vous pouvez configurer le module d'authentification unique (SSO) ASP.NET SAML 2.0 avec n'importe quel fournisseur d'identité tel que 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 ou même avec votre propre fournisseur d'identité personnalisé.