ASP.NET OAuth Single Sign-On (SSO) usando WHMCS como provedor OAuth
O módulo ASP.NET OAuth Single Sign-On (SSO) oferece a capacidade de habilitar o OAuth Single Sign-On para seus aplicativos ASP.NET. Usando o Single Sign-On, você pode usar apenas uma senha para acessar seus aplicativos e serviços ASP.NET. Nosso módulo é compatível com todos os provedores de identidade compatíveis com OAuth. Aqui, apresentaremos um guia passo a passo para configurar o Single Sign-On (SSO) entre ASP.NET e WHMCS, considerando o WHMCS como provedor OAuth.
Para configurar o conector, extraia o
asp-net-oauth-sso-module.zip, você encontrará um arquivo DLL
miniorange-oauth-sso.dll, um arquivo de configuração
oauthsso.config e uma integração.md arquivo que contém as etapas para adicionar o módulo ao seu aplicativo.
Etapas para configurar o login único (SSO) do WHMCS no ASP.NET
1. Adicione o conector em seu aplicativo
Adicione miniorange-oauth-sso.dll na pasta bin (onde estão seus outros arquivos DLL) para seu aplicativo.
Registrar-se miniorangeoauthsso módulo em sua aplicação de acordo com as etapas fornecidas no integração.md arquivo.
Adicione o arquivo de configuração fornecido oauthsso.config no diretório raiz do seu aplicativo.
Após a integração, abra o navegador e navegue até o painel do conector com a URL abaixo: https:// <your-application-base-url>/?ssoaction=config
Se aparecer a página de registro ou de login, você adicionou com sucesso o conector miniOrange oauth sso para seu aplicativo.
Registrar ou Entrar para configurar o conector.
2. Configurar WHMCS como provedor OAuth
Primeiro, acesse seu domínio WHMCS e faça login na sua conta de administrador do WHMCS.
A seguinte tela será apresentada a você. Vá para
instalação OpenID Connect
na barra de navegação superior.
Clique em
Gerar novas credenciais de API do cliente botão.
Você será redirecionado para a página de detalhes do aplicativo. Preencha os dados necessários e insira URIs de redirecionamento autorizados da
Cliente ASP.NET OAuth miniOrange e clique em
Gerar credenciais.
Você será levado para a página de detalhes do aplicativo. Aqui, você pode encontrar
ID do cliente e Segredo do cliente que você vai precisar em Etapa 3 para configurar
Cliente ASP.NET OAuth miniOrange.
Depois de configurar seu provedor OAuth, ele fornecerá a você
ID do cliente, segredo do cliente, endpoint de autorização, endpoint de token de acesso
e Obter ponto final de informações do usuário. Configure esses valores nos respectivos campos.
Preencha todos os detalhes necessários e clique em
Salvar configuração.
4. Configuração de teste
Após salvar a configuração, clique em
Configuração de Teste botão para verificar se você configurou corretamente.
Com a configuração bem-sucedida, você obterá
Nome dos atributos e Valores de Atributo na janela Configuração de Teste. A captura de tela abaixo mostra um resultado bem-sucedido.
5. Mapeamento de Atributos
Nomes de atributos do mapa fornecidos pelo seu servidor OAuth com os atributos do seu aplicativo ASP.NET fornecidos na seção Mapeamento de atributos e clique em
Salvar mapeamento de atributos.
Observação: todos os atributos mapeados serão armazenados na sessão para que você possa acessá-los em seu aplicativo.
6. Código de Integração
Você pode encontrar o código de integração na aba Código de Integração do conector. Basta copiar e colar esse trecho de código onde quiser para acessar os atributos do usuário.
7. Adicione o seguinte link em seu aplicativo para Single Sign-On (SSO)
Use a seguinte URL como um link no seu aplicativo de onde você deseja executar o SSO: http://base-url/?ssoaction=login
Por exemplo, você pode usá-lo como: <a href="http://base-url/?ssoaction=login”>Log in</a>"
Você pode configurar o módulo ASP.NET SAML 2.0 Single Sign-On (SSO) com qualquer provedor de identidade, 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 ou até mesmo com seu próprio provedor de identidade personalizado.
