mirror of https://github.com/abpframework/abp.git
ozermzn
4 years ago
52 changed files with 323 additions and 75 deletions
@ -0,0 +1,68 @@ |
|||||
|
# How to Use the Weixin Authentication for MVC / Razor Page Applications |
||||
|
|
||||
|
This guide demonstrates how to integrate Weixin to an ABP application that enables users to sign in using OAuth 2.0 with credentials. |
||||
|
|
||||
|
## Create a sandbox account |
||||
|
|
||||
|
If you don't have a production account, you can create a sendbox account for testing: https://mp.weixin.qq.com/debug/cgi-bin/sandboxinfo?action=showinfo&t=sandbox/index |
||||
|
|
||||
|
In this article we will use the sandbox account. |
||||
|
|
||||
|
> You should configure the callback domain name on the Weixin open platform |
||||
|
|
||||
|
## AddWeixin |
||||
|
|
||||
|
You need to install `AspNet.Security.OAuth.Weixin` package to your **.Web** project. |
||||
|
|
||||
|
In your **.Web** project, locate your **ApplicationWebModule** and modify `ConfigureAuthentication` method with the following: |
||||
|
|
||||
|
```csharp |
||||
|
private void ConfigureAuthentication(ServiceConfigurationContext context) |
||||
|
{ |
||||
|
var configuration = context.Services.GetConfiguration(); |
||||
|
context.Services.ForwardIdentityAuthenticationForBearer(OpenIddictValidationAspNetCoreDefaults.AuthenticationScheme); |
||||
|
context.Services.AddAuthentication() |
||||
|
.AddWeixin(options => |
||||
|
{ |
||||
|
options.ClientId = configuration["Weixin:ClientId"]; |
||||
|
options.ClientSecret = configuration["Weixin:ClientSecret"]; |
||||
|
}); |
||||
|
} |
||||
|
``` |
||||
|
|
||||
|
Updating `appsettings.json` to add `Weixin` section: |
||||
|
|
||||
|
````json |
||||
|
"Weixin": { |
||||
|
"ClientId": "<your-app-id>", |
||||
|
"ClientSecret": "<your-app-secret>" |
||||
|
} |
||||
|
```` |
||||
|
|
||||
|
## Web page authorization |
||||
|
|
||||
|
Now you can run the application to login with Weixin. |
||||
|
|
||||
|
 |
||||
|
|
||||
|
It will redirect to weixin platform to scan the QR code. |
||||
|
|
||||
|
> The sandbox account lacks the necessary scope, so it may not work properly. |
||||
|
|
||||
|
## Official account authorization |
||||
|
|
||||
|
Updating `AddWeixin`: |
||||
|
|
||||
|
```csharp |
||||
|
context.Services.AddAuthentication() |
||||
|
.AddWeixin(options => |
||||
|
{ |
||||
|
options.ClientId = configuration["Weixin:ClientId"]; |
||||
|
options.ClientSecret = configuration["Weixin:ClientSecret"]; |
||||
|
options.AuthorizationEndpoint = "https://open.weixin.qq.com/connect/oauth2/authorize"; |
||||
|
}); |
||||
|
``` |
||||
|
|
||||
|
Now you can use WeChat app to open the web application URL to login with weixin. |
||||
|
|
||||
|
 |
||||
|
After Width: | Height: | Size: 22 KiB |
|
After Width: | Height: | Size: 25 KiB |
@ -0,0 +1,66 @@ |
|||||
|
using System; |
||||
|
using System.Collections.Generic; |
||||
|
using Microsoft.Extensions.Localization; |
||||
|
using Volo.Abp.DependencyInjection; |
||||
|
|
||||
|
namespace Volo.Abp.Localization; |
||||
|
|
||||
|
public class AbpEnumLocalizer : IAbpEnumLocalizer, ITransientDependency |
||||
|
{ |
||||
|
protected readonly IStringLocalizerFactory StringLocalizerFactory; |
||||
|
|
||||
|
public AbpEnumLocalizer(IStringLocalizerFactory stringLocalizerFactory) |
||||
|
{ |
||||
|
StringLocalizerFactory = stringLocalizerFactory; |
||||
|
} |
||||
|
|
||||
|
public virtual string GetString(Type enumType, object enumValue) |
||||
|
{ |
||||
|
return GetStringInternal(enumType, enumValue, StringLocalizerFactory.CreateDefaultOrNull()); |
||||
|
} |
||||
|
|
||||
|
public virtual string GetString(Type enumType, object enumValue, params IStringLocalizer[] specifyLocalizers) |
||||
|
{ |
||||
|
return GetStringInternal(enumType, enumValue, specifyLocalizers); |
||||
|
} |
||||
|
|
||||
|
protected virtual string GetStringInternal(Type enumType, object enumValue, params IStringLocalizer[] specifyLocalizers) |
||||
|
{ |
||||
|
var memberName = enumType.GetEnumName(enumValue); |
||||
|
var localizedString = GetStringOrNull( |
||||
|
specifyLocalizers, |
||||
|
new[] |
||||
|
{ |
||||
|
$"Enum:{enumType.Name}.{enumValue}", |
||||
|
$"Enum:{enumType.Name}.{memberName}", |
||||
|
$"{enumType.Name}.{enumValue}", |
||||
|
$"{enumType.Name}.{memberName}", |
||||
|
memberName |
||||
|
} |
||||
|
); |
||||
|
|
||||
|
return localizedString ?? memberName; |
||||
|
} |
||||
|
|
||||
|
protected virtual string GetStringOrNull(IStringLocalizer[] localizers, IEnumerable<string> keys) |
||||
|
{ |
||||
|
foreach (var key in keys) |
||||
|
{ |
||||
|
foreach (var l in localizers) |
||||
|
{ |
||||
|
if (l == null) |
||||
|
{ |
||||
|
continue; |
||||
|
} |
||||
|
|
||||
|
var localizedString = l[key]; |
||||
|
if (!localizedString.ResourceNotFound) |
||||
|
{ |
||||
|
return localizedString.Value; |
||||
|
} |
||||
|
} |
||||
|
} |
||||
|
|
||||
|
return null; |
||||
|
} |
||||
|
} |
||||
@ -0,0 +1,19 @@ |
|||||
|
using System; |
||||
|
using Microsoft.Extensions.Localization; |
||||
|
|
||||
|
namespace Volo.Abp.Localization; |
||||
|
|
||||
|
public static class AbpEnumLocalizerExtensions |
||||
|
{ |
||||
|
public static string GetString<TEnum>(this IAbpEnumLocalizer abpEnumLocalizer, object enumValue) |
||||
|
where TEnum : Enum |
||||
|
{ |
||||
|
return abpEnumLocalizer.GetString(typeof(TEnum), enumValue); |
||||
|
} |
||||
|
|
||||
|
public static string GetString<TEnum>(this IAbpEnumLocalizer abpEnumLocalizer, object enumValue, IStringLocalizer[] specifyLocalizers) |
||||
|
where TEnum : Enum |
||||
|
{ |
||||
|
return abpEnumLocalizer.GetString(typeof(TEnum), enumValue, specifyLocalizers); |
||||
|
} |
||||
|
} |
||||
@ -0,0 +1,11 @@ |
|||||
|
using System; |
||||
|
using Microsoft.Extensions.Localization; |
||||
|
|
||||
|
namespace Volo.Abp.Localization; |
||||
|
|
||||
|
public interface IAbpEnumLocalizer |
||||
|
{ |
||||
|
string GetString(Type enumType, object enumValue); |
||||
|
|
||||
|
string GetString(Type enumType, object enumValue, IStringLocalizer[] specifyLocalizers); |
||||
|
} |
||||
@ -0,0 +1,47 @@ |
|||||
|
using Microsoft.Extensions.Localization; |
||||
|
using Shouldly; |
||||
|
using Volo.Abp.Localization.TestResources.Base.Validation; |
||||
|
using Volo.Abp.Testing; |
||||
|
using Xunit; |
||||
|
|
||||
|
namespace Volo.Abp.Localization; |
||||
|
|
||||
|
public class AbpEnumLocalizer_Tests : AbpIntegratedTest<AbpLocalizationTestModule> |
||||
|
{ |
||||
|
private readonly IAbpEnumLocalizer _enumLocalizer; |
||||
|
|
||||
|
public AbpEnumLocalizer_Tests() |
||||
|
{ |
||||
|
_enumLocalizer = GetRequiredService<IAbpEnumLocalizer>(); |
||||
|
} |
||||
|
|
||||
|
[Fact] |
||||
|
public void GetString_Test() |
||||
|
{ |
||||
|
using (CultureHelper.Use("en")) |
||||
|
{ |
||||
|
_enumLocalizer.GetString<BookType>(BookType.Undefined).ShouldBe("Undefined"); |
||||
|
_enumLocalizer.GetString<BookType>(BookType.Adventure).ShouldBe("Adventure"); |
||||
|
_enumLocalizer.GetString<BookType>(0).ShouldBe("Undefined with value 0"); |
||||
|
_enumLocalizer.GetString<BookType>(1).ShouldBe("Adventure with value 1"); |
||||
|
_enumLocalizer.GetString<BookType>(BookType.Biography).ShouldBe("Biography"); |
||||
|
|
||||
|
var specifyLocalizer = new[] |
||||
|
{ |
||||
|
GetRequiredService<IStringLocalizerFactory>().Create<LocalizationTestValidationResource>() |
||||
|
}; |
||||
|
_enumLocalizer.GetString<BookType>(BookType.Undefined, specifyLocalizer).ShouldBe("Undefined from ValidationResource"); |
||||
|
_enumLocalizer.GetString<BookType>(BookType.Adventure, specifyLocalizer).ShouldBe("Adventure from ValidationResource"); |
||||
|
_enumLocalizer.GetString<BookType>(0, specifyLocalizer).ShouldBe("Undefined with value 0 from ValidationResource"); |
||||
|
_enumLocalizer.GetString<BookType>(1, specifyLocalizer).ShouldBe("Adventure with value 1 from ValidationResource"); |
||||
|
_enumLocalizer.GetString<BookType>(BookType.Biography, specifyLocalizer).ShouldBe("Biography from ValidationResource"); |
||||
|
} |
||||
|
} |
||||
|
} |
||||
|
|
||||
|
enum BookType |
||||
|
{ |
||||
|
Undefined, |
||||
|
Adventure, |
||||
|
Biography, |
||||
|
} |
||||
Loading…
Reference in new issue