大网数据广告活动
.NET 与 C# 开发

如何:转换传入声明

· 52CE 我爱测

5. 在“解决方案资源管理器”下,右键单击“TestApp”项目,然后选择“标识和访问”。

适用于

  • Microsoft® Windows® Identity Foundation (WIF)

  • ASP.NET® Web 窗体

总结

本指南提供了创建简单的声明感知 ASP.NET Web 窗体应用程序和转换传入声明的详细分步过程。 它还提供关于如何测试应用程序的说明,以便验证当应用程序运行时是否呈现已转换声明。

内容

  • 目标

  • 概述

  • 步骤摘要

  • 步骤 1 – 创建简单的 ASP.NET Web 窗体应用程序

  • 步骤 2 – 使用自定义 ClaimsAuthenticationManager 实现声明转换

  • 步骤 3 - 测试你的解决方案

目标

  • 配置 ASP.NET Web 窗体应用程序实现基于声明的身份验证

  • 通过添加管理员角色声明转换传入声明

  • 测试 ASP.NET Web 窗体应用程序,了解它是否正常工作

概述

WIF 公开名为 xref:System.Security.Claims.ClaimsAuthenticationManager 的类,使用户在声明呈现给信赖方 (RP) 应用程序之前能够进行修改。 xref:System.Security.Claims.ClaimsAuthenticationManager 可用于分离身份验证和基础应用程序代码之间的问题。 以下示例演示如何在传入的 xref:System.Security.Claims.ClaimsPrincipal 中向声明添加 RP 可能需要的角色。

步骤摘要

  • 步骤 1 – 创建简单的 ASP.NET Web 窗体应用程序

  • 步骤 2 – 使用自定义 ClaimsAuthenticationManager 实现声明转换

  • 步骤 3 - 测试你的解决方案

步骤 1 – 创建简单的 ASP.NET Web 窗体应用程序

在此步骤中,将创建一个新的 ASP.NET Web 窗体应用程序。

创建一个简单 ASP.NET 应用程序
  1. 以管理员身份在提升模式下启动 Visual Studio。

  2. 在 Visual Studio 中,单击“文件”,再单击“新建”,然后单击“项目”。

  3. 在“新建项目”窗口中,单击“ASP.NET Web 窗体应用程序”。

  4. 在“名称”中,输入 TestApp,然后按“确定”。

  5. 在“解决方案资源管理器”下,右键单击“TestApp”项目,然后选择“标识和访问”。

  6. “标识和访问”窗口随即出现。 在“提供程序”下,选择“使用本地开发 STS 测试应用程序”,然后单击“应用”。

  7. 在 Default.aspx 文件中,将现有标记替换为以下内容,然后保存文件:

    <%@ Page Title="Home Page" Language="C#" MasterPageFile="~/Site.Master" AutoEventWireup="true"  
        CodeBehind="Default.aspx.cs" Inherits="TestApp._Default" %>  
    
    <asp:Content runat="server" ID="BodyContent" ContentPlaceHolderID="MainContent">  
          <h3>Your Claims</h3>  
        <p>  
            <asp:GridView ID="ClaimsGridView" runat="server" CellPadding="3">  
                <AlternatingRowStyle BackColor="White" />  
                <HeaderStyle BackColor="#7AC0DA" ForeColor="White" />  
            </asp:GridView>  
        </p>  
    </asp:Content>  
    
  8. 打开名为 Default.aspx.cs 的代码隐藏文件。 用以下内容替换现有代码,然后保存文件:

    using System;  
    using System.Web.UI;  
    using System.Security.Claims;  
    
    namespace TestApp  
    {  
        public partial class _Default : Page  
        {  
            protected void Page_Load(object sender, EventArgs e)  
            {  
                ClaimsPrincipal claimsPrincipal = Page.User as ClaimsPrincipal;  
                this.ClaimsGridView.DataSource = claimsPrincipal.Claims;  
                this.ClaimsGridView.DataBind();  
            }  
        }  
    }  
    

步骤 2 – 使用自定义 ClaimsAuthenticationManager 实现声明转换

此步骤将覆盖 xref:System.Security.Claims.ClaimsAuthenticationManager 类中的默认功能,向传入主体添加管理员角色。

使用自定义 ClaimsAuthenticationManager 实现声明转换
  1. 在 Visual Studio 中,右键单击解决方案,单击“添加”,然后单击“新建项目”。

  2. 在“添加新建项目”窗口中从“Visual C#”模板列表选择“类库”,输入 ClaimsTransformation,然后按“确定”。 系统将在你的解决方案文件夹中创建新项目。

  3. 在“ClaimsTransformation”项目下右键单击“引用”,然后单击“添加引用”。

  4. 在“引用管理器”窗口选择“System.IdentityModel”,然后单击“确定”。

  5. 打开“Class1.cs”或若它不存在,右键单击“ClaimsTransformation”,再依次单击“添加”、“类…”

  6. 使用指令将以下内容添加到代码文件:

    using System.Security.Claims;  
    using System.Security.Principal;  
    
  7. 在代码文件中添加以下类和方法。

    WARNING 以下代码仅用于演示目的;请确保验证了生产代码中的预期权限。

    public class ClaimsTransformationModule : ClaimsAuthenticationManager  
    {  
        public override ClaimsPrincipal Authenticate(string resourceName, ClaimsPrincipal incomingPrincipal)  
        {  
            if (incomingPrincipal != null && incomingPrincipal.Identity.IsAuthenticated == true)  
            {  
               ((ClaimsIdentity)incomingPrincipal.Identity).AddClaim(new Claim(ClaimTypes.Role, "Admin"));  
            }  
    
            return incomingPrincipal;  
        }  
    }  
    
  8. 保存文件并生成 ClaimsTransformation 项目。

  9. 在 TestApp ASP.NET 项目中,右键单击“引用”,然后单击“添加引用”。

  10. 在“引用管理器”窗口中从左侧菜单选择“解决方案”,然后从填充选项中选择“ClaimsTransformation”,再单击“确定”。

  11. 在根目录 Web.config 文件中,导航到 <system.identityModel> 条目。 在 <identityConfiguration> 元素内,添加以下行并保存文件:

    <claimsAuthenticationManager type="ClaimsTransformation.ClaimsTransformationModule, ClaimsTransformation" />  
    

步骤 3 - 测试你的解决方案

此步骤中将测试 ASP.NET Web 窗体应用程序,并验证用户使用 Forms 身份验证登录时是否呈现声明。

为使用 Forms 身份验证的声明测试 ASP.NET Web 窗体应用程序
  1. 按 F5 生成并运行该应用程序。 将看到 Default.aspx。

  2. 在 Default.aspx 页,在“你的声明”标题下应看到一个表格,包括有关帐户的颁发者、原始颁发者、类型、值以及值类型声明信息。 最后一行应以下面的方式显示:

    本地机构 本地机构 http://schemas.microsoft.com/ws/2008/06/identity/claims/role 管理员 https://www.w3.org/2001/XMLSchema#string

历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者(原始作者元数据 BrucePerlerMS)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体、发布器占位标签和导航标记。

资料来源与适用范围

资料来源
Microsoft / .NET 中文文档历史快照
适用范围
历史中文快照 2019-08-18;详见原文产品版本;文档日期 03/30/2017
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。