FacebookOptions 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
FacebookHandler的配置选项。
public ref class FacebookOptions : Microsoft::AspNetCore::Authentication::OAuth::OAuthOptionspublic class FacebookOptions : Microsoft.AspNetCore.Authentication.OAuth.OAuthOptionstype FacebookOptions = class
inherit OAuthOptionsPublic Class FacebookOptions
Inherits OAuthOptions- 继承
构造函数
| FacebookOptions() |
初始化新的 FacebookOptions。 |
属性
| AccessDeniedPath |
获取或设置用户代理重定向到的可选路径（如果用户未批准远程服务器请求的授权要求）。 默认情况下不设置此属性。 在这种情况下，如果远程授权服务器返回access_denied响应，则会引发异常。 (继承自 RemoteAuthenticationOptions) |
| AdditionalAuthorizationParameters |
获取将包含在授权请求中的其他参数。 (继承自 OAuthOptions) |
| AppId |
获取或设置 Facebook 分配的应用 ID。 |
| AppSecret |
获取或设置 Facebook 分配的应用机密。 |
| AuthorizationEndpoint |
获取或设置客户端将重定向到进行身份验证的 URI。 (继承自 OAuthOptions) |
| Backchannel |
用于与远程标识提供者通信。 (继承自 RemoteAuthenticationOptions) |
| BackchannelHttpHandler |
用于与远程标识提供者通信的 HttpMessageHandler。 这不能与 BackchannelCertificateValidator 同时设置，除非该值可以向下转换为 WebRequestHandler。 (继承自 RemoteAuthenticationOptions) |
| BackchannelTimeout |
获取或设置与远程标识提供者的反向通道通信的超时值（以毫秒为单位）。 (继承自 RemoteAuthenticationOptions) |
| CallbackPath |
将返回用户代理的应用程序基路径中的请求路径。 当中间件到达时，中间件将处理此请求。 (继承自 RemoteAuthenticationOptions) |
| ClaimActions |
声明操作的集合，用于从 json 用户数据中选择值并创建声明。 (继承自 OAuthOptions) |
| ClaimsIssuer |
获取或设置应用于所创建的任何声明的颁发者 (继承自 AuthenticationSchemeOptions) |
| ClientId |
获取或设置提供程序分配的客户端 ID。 (继承自 OAuthOptions) |
| ClientSecret |
获取或设置提供程序分配的客户端密码。 (继承自 OAuthOptions) |
| CorrelationCookie |
确定用于在将 Cookie 添加到响应之前创建相关 Cookie 的设置。 (继承自 RemoteAuthenticationOptions) |
| DataProtectionProvider |
获取或设置用于保护数据的类型。 (继承自 RemoteAuthenticationOptions) |
| Events |
获取或设置用于处理身份验证事件的 OAuthEvents。 (继承自 OAuthOptions) |
| EventsType |
如果已设置，将用作服务类型来获取事件实例而不是属性。 (继承自 AuthenticationSchemeOptions) |
| Fields |
要从 UserInformationEndpoint 检索的字段列表。 |
| ForwardAuthenticate |
如果已设置，则指定此方案应将 AuthenticateAsync 调用转发到的目标方案。 例如 Context.AuthenticateAsync（“ThisScheme”） => Context.AuthenticateAsync（“ForwardAuthenticateValue”）：将目标设置为当前方案以禁用转发并允许正常处理。 (继承自 AuthenticationSchemeOptions) |
| ForwardChallenge |
如果设置，则指定此方案应将 ChallengeAsync 调用转发到的目标方案。 例如 Context.ChallengeAsync（“ThisScheme”） => Context.ChallengeAsync（“ForwardChallengeValue”）：将目标设置为当前方案以禁用转发并允许正常处理。 (继承自 AuthenticationSchemeOptions) |
| ForwardDefault |
如果设置，则指定一个默认方案，身份验证处理程序应默认将所有身份验证操作转发到该方案。 默认转发逻辑将首先检查最具体的 ForwardAuthenticate/Challenge/Forbid/SignIn/SignOut 设置，然后检查 ForwardDefaultSelector，后跟 ForwardDefault。 第一个非 null 结果将用作要转发的目标方案。 (继承自 AuthenticationSchemeOptions) |
| ForwardDefaultSelector |
用于为当前请求选择默认方案，身份验证处理程序应默认将所有身份验证操作转发到该方案。 默认转发逻辑将首先检查最具体的 ForwardAuthenticate/Challenge/Forbid/SignIn/SignOut 设置，然后检查 ForwardDefaultSelector，后跟 ForwardDefault。 第一个非 null 结果将用作要转发的目标方案。 (继承自 AuthenticationSchemeOptions) |
| ForwardForbid |
如果已设置，则指定此方案应将 ForbidAsync 调用转发到的目标方案。 例如 Context.ForbidAsync（“ThisScheme”） => Context.ForbidAsync（“ForwardForbidValue”）;将目标设置为当前方案以禁用转发并允许正常处理。 (继承自 AuthenticationSchemeOptions) |
| ForwardSignIn |
如果已设置，则指定此方案应将 SignInAsync 调用转发到的目标方案。 例如 Context.SignInAsync（“ThisScheme”） => Context.SignInAsync（“ForwardSignInValue”）;将目标设置为当前方案以禁用转发并允许正常处理。 (继承自 AuthenticationSchemeOptions) |
| ForwardSignOut |
如果已设置，则指定此方案应将 SignOutAsync 调用转发到的目标方案。 例如 Context.SignOutAsync（“ThisScheme”） => Context.SignOutAsync（“ForwardSignOutValue”）;将目标设置为当前方案以禁用转发并允许正常处理。 (继承自 AuthenticationSchemeOptions) |
| RemoteAuthenticationTimeout |
获取或设置完成身份验证流的时间限制（默认情况下为 15 分钟）。 (继承自 RemoteAuthenticationOptions) |
| ReturnUrlParameter |
获取或设置参数的名称，该参数用于在远程质询触发到访问被拒绝页面之前传达用户的原始位置。 仅当显式指定 AccessDeniedPath 时，才使用此属性。 (继承自 RemoteAuthenticationOptions) |
| SaveTokens |
定义在成功授权后是否应将访问和刷新令牌存储在 AuthenticationProperties 中。
默认情况下，此属性设置为 |
| Scope |
获取要请求的权限列表。 (继承自 OAuthOptions) |
| SendAppSecretProof |
获取或设置是否应生成 |
| SignInScheme |
获取或设置与负责在成功身份验证后保留用户标识的中间件对应的身份验证方案。 此值通常对应于 Startup 类中注册的 Cookie 中间件。 省略时，DefaultSignInScheme 用作回退值。 (继承自 RemoteAuthenticationOptions) |
| StateDataFormat |
获取或设置用于保护中间件处理的数据的类型。 (继承自 OAuthOptions) |
| TimeProvider |
用于测试。 (继承自 AuthenticationSchemeOptions) |
| TokenEndpoint |
获取或设置中间件将访问以交换 OAuth 令牌的 URI。 (继承自 OAuthOptions) |
| UsePkce |
启用或禁用对代码交换（PKCE）标准的证明密钥的使用。 请参阅 https://tools.ietf.org/html/rfc7636。
默认值是 |
| UserInformationEndpoint |
获取或设置中间件将访问以获取用户信息的 URI。 此值未在默认实现中使用，用于 OnCreatingTicket的自定义实现。 (继承自 OAuthOptions) |
方法
| Validate() |
检查选项是否有效。 如果情况不正常，应引发异常。 |
| Validate(String) |
检查选项是否对特定方案有效 (继承自 RemoteAuthenticationOptions) |