mirror of https://github.com/abpframework/abp
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
38 lines
2.1 KiB
38 lines
2.1 KiB
# Account Module
|
|
|
|
This module provides necessary UI pages/components to make the user login and register to the application.
|
|
|
|
> This document is incomplete.
|
|
|
|
## Social/External Logins
|
|
|
|
The [Account Module](../Modules/Account.md) has already configured to handle social or external logins out of the box. You can follow the ASP.NET Core documentation to add a social/external login provider to your application.
|
|
|
|
### Example: Facebook Authentication
|
|
|
|
Follow the [ASP.NET Core Facebook integration document](https://docs.microsoft.com/en-us/aspnet/core/security/authentication/social/facebook-logins) to support the Facebook login for your application.
|
|
|
|
#### Add the NuGet Package
|
|
|
|
Add the [Microsoft.AspNetCore.Authentication.Facebook](https://www.nuget.org/packages/Microsoft.AspNetCore.Authentication.Facebook) package to your project. Based on your architecture, this can be `.Web`, `.IdentityServer` (for tiered setup) or `.Host` project.
|
|
|
|
#### Configure the Provider
|
|
|
|
Use the `.AddFacebook(...)` extension method in the `ConfigureServices` method of your [module](../Module-Development-Basics.md), to configure the client:
|
|
|
|
````csharp
|
|
context.Services.AddAuthentication()
|
|
.AddFacebook(facebook =>
|
|
{
|
|
facebook.AppId = "...";
|
|
facebook.AppSecret = "...";
|
|
facebook.Scope.Add("email");
|
|
facebook.Scope.Add("public_profile");
|
|
});
|
|
````
|
|
|
|
> It would be a better practice to use the `appsettings.json` or the ASP.NET Core User Secrets system to store your credentials, instead of a hard-coded value like that. Follow the [Microsoft's document](https://docs.microsoft.com/en-us/aspnet/core/security/authentication/social/facebook-logins) to learn the user secrets usage.
|
|
|
|
### Other UI Types
|
|
|
|
Beginning from the v3.1, the [Angular UI](../UI/Angular/Quick-Start.md) uses authorization code flow (as a best practice) to authenticate the user by redirecting to the MVC UI login page. So, even if you are using the Angular UI, social/external login integration is same as explained above and it will work out of the box. As similar, The [Blazor UI](../UI/Blazor/Overall.md) also uses the MVC UI to logic. |