mirror of https://github.com/abpframework/abp.git
2 changed files with 37 additions and 31 deletions
@ -1,32 +1,3 @@ |
|||||
# Social/External Logins |
# 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. |
> This document has been moved. See the [Account Module](../Modules/Account.md) documentation. |
||||
|
|
||||
## 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. |
|
||||
|
|
||||
## Angular UI |
|
||||
|
|
||||
Beginning from the v3.1, the Angular UI 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. |
|
||||
@ -1,3 +1,38 @@ |
|||||
# Account Module |
# Account Module |
||||
|
|
||||
TODO |
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. |
||||
Loading…
Reference in new issue