Единый вход (SSO) ASP.NET OAuth с использованием WHMCS в качестве поставщика OAuth

Модуль ASP.NET OAuth Single Sign-On (SSO) позволяет включить единый вход OAuth для ваших приложений ASP.NET. Используя единый вход, вы можете использовать только один пароль для доступа к вашему приложению и сервисам ASP.NET. Наш модуль совместим со всеми поставщиками идентификации, поддерживающими OAuth. Здесь мы рассмотрим пошаговое руководство по настройке единого входа (SSO) между ASP.NET и WHMCS, рассматривая WHMCS в качестве поставщика OAuth.

Предварительные условия: загрузка и установка

• Скачать Модуль miniOrange ASP.NET OAuth 2.0.
• Для настройки коннектора извлеките... asp-net-oauth-sso-module.zipВы найдете DLL-файл. miniorange-oauth-sso.dll, файл конфигурации oauthsso.config и интеграция.мд файл, содержащий пошаговые инструкции по добавлению модуля в ваше приложение.

Шаги по настройке единого входа (SSO) WHMCS в ASP.NET

1. Добавьте коннектор в ваше приложение.

• Добавить miniorange-oauth-sso.dll в папке bin (где находятся другие ваши DLL-файлы) для вашего приложения.
• Зарегистрировать филиал miniorangeoauthsso встройте модуль в ваше приложение, следуя инструкциям, приведенным в руководстве. интеграция.мд .
• Добавьте предоставленный конфигурационный файл. oauthsso.config в корневом каталоге вашего приложения.
• После интеграции откройте браузер и перейдите на панель управления коннектором по указанному ниже URL-адресу:
  https:// <your-application-base-url>/?ssoaction=config
• Если отобразится страница регистрации или страница входа в систему, значит, вы успешно добавили коннектор miniOrange OAuth SSO для своего приложения.

• Зарегистрируйтесь или войдите для настройки коннектора.

2. Настройте WHMCS в качестве поставщика аутентификации OAuth.

• Для начала перейдите в свой домен WHMCS и войдите в свою учетную запись администратора WHMCS.
• Вы увидите следующий экран. Перейдите по ссылке: Установка OpenID Connect на панели навигации вверху.

• Нажмите на Сгенерировать новые учетные данные API клиента .

• Вы будете перенаправлены на страницу с подробной информацией о приложении. Заполните необходимые данные и введите их. Авторизованные URI перенаправления от miniOrange ASP.NET OAuth Client и нажмите на Создать учетные данные.

• Вы будете перенаправлены на страницу с подробной информацией о приложении. Здесь вы сможете найти идентификатор клиента и Секрет клиента который вам понадобится в Шаг 3 настроить miniOrange ASP.NET OAuth Client.



Конечные точки и область действия WHMCS:




Идентификатор клиента:	Кликните сюда
Секрет клиента:	Кликните сюда
Объем:	электронная почта профиля OpenID
Авторизовать конечную точку:	https://{yourWHMCSdomain}/oauth/authorize.php
Конечная точка токена доступа:	https://{yourWHMCSdomain}/oauth/token.php
Конечная точка для получения информации о пользователе:	https://{yourWHMCSdomain}/oauth/userinfo.php

3. Настройка клиента miniOrange ASP.NET OAuth

• После настройки вашего OAuth-провайдера вам будет предоставлена ​​следующая информация: Идентификатор клиента, секретный ключ клиента, конечная точка авторизации, конечная точка токена доступа и Получить конечную точку информации о пользователеНастройте эти значения в соответствующих полях.
• Заполните все необходимые данные и нажмите кнопку. Сохранить конфигурацию.

4. Тестовая конфигурация

• После сохранения настроек нажмите на кнопку. Тестовая конфигурация Нажмите кнопку, чтобы проверить правильность настройки.
• После успешной настройки вы получите Имя атрибута и Значения атрибутов В окне «Конфигурация теста». На скриншоте ниже показан успешный результат.
• 

5. Сопоставление атрибутов

• Сопоставьте имена атрибутов, предоставленные вашим OAuth-сервером, с атрибутами вашего ASP.NET-приложения, указанными в разделе «Сопоставление атрибутов». Нажмите на соответствующую кнопку. Сохранить сопоставление атрибутов.

• Примечание: Все сопоставленные атрибуты будут сохранены в сессии, чтобы вы могли получить к ним доступ в своем приложении.

6. Интеграционный код

• Вы можете найти код интеграции На вкладке «Код интеграции» в коннекторе просто скопируйте и вставьте этот фрагмент кода туда, где вы хотите получить доступ к атрибутам пользователя.

7. Добавьте следующую ссылку в ваше приложение для единого входа (SSO):

• Используйте следующий URL-адрес в качестве ссылки в вашем приложении, откуда вы хотите выполнить единый вход (SSO):
  http://base-url/?ssoaction=login
• Например, вы можете использовать его как:
  <a href="http://base-url/?ssoaction=login”>Log in</a>"

Модуль единого входа (SSO) ASP.NET SAML 2.0 можно настроить с любым поставщиком идентификации, таким как 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 или даже с собственным пользовательским поставщиком идентификации.