Browse Source

Merge pull request #21071 from abpframework/18588

Update documentation for relevant external login enhancements
pull/21072/head
Engincan VESKE 1 year ago
committed by GitHub
parent
commit
816cd0af05
No known key found for this signature in database GPG Key ID: B5690EEEBB952194
  1. BIN
      docs/en/images/my-externa-logins.png
  2. BIN
      docs/en/images/new-external-login.png
  3. BIN
      docs/en/images/require-local-password-on-social-account-linking.png
  4. 22
      docs/en/modules/account-pro.md

BIN
docs/en/images/my-externa-logins.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 172 KiB

BIN
docs/en/images/new-external-login.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 38 KiB

BIN
docs/en/images/require-local-password-on-social-account-linking.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 103 KiB

22
docs/en/modules/account-pro.md

@ -119,7 +119,7 @@ Follow the steps below to install a new external/social login. We will show Face
#### 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.
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`, `.AuthServer` (for tiered setup) or `.Host` project.
#### Configure the Provider
@ -194,12 +194,26 @@ context.Services.AddAuthentication()
context.Services.TryAddEnumerable(ServiceDescriptor.Singleton<IPostConfigureAccountExternalProviderOptions<OpenIdConnectOptions>, OpenIdConnectPostConfigureAccountExternalProviderOptions>());
````
#### For Tiered / Separate IdentityServer Solutions
#### For Tiered / Separate AuthServer Solutions
If your `.IdentityServer` is separated from the `.Host` project, then the `.Host` project should also be configured.
If your `.AuthServer` is separated from the `.Host` project, then the `.Host` project should also be configured.
* Add the [Microsoft.AspNetCore.Authentication.Facebook](https://www.nuget.org/packages/Microsoft.AspNetCore.Authentication.Facebook) package to your `.Host` project.
* Add `WithDynamicOptions<FacebookOptions>()` configuration into the `ConfigureServices` method of your module (just copy the all code above and remove the `.AddFacebook(...)` part since it is only needed in the IdentityServer side).
* Add `WithDynamicOptions<FacebookOptions>()` configuration into the `ConfigureServices` method of your module (just copy the all code above and remove the `.AddFacebook(...)` part since it is only needed in the AuthServer side).
## Manage External Logins
You can link an external login in `Account/ExternalLogins` page of `Account` module.
![my-externa-logins](../images/my-externa-logins.png)
![new-external-login](../images/new-external-login.png)
### Social Account Security Setting
Users who register via both local registration and external/social login using the same email address will be required to enter their local password on the first external/social login.
![require-local-password-on-social-account-linking](../images/require-local-password-on-social-account-linking.png)
## Internals

Loading…
Cancel
Save