How To: Build Claims-Aware ASP.NET MVC Web Application Using WIF

适用于

Microsoft® Windows® Identity Foundation (WIF)
ASP.NET® MVC

总结

本操作说明提供了创建简单的声明感知 ASP.NET MVC Web 应用程序的详细分步过程。还提供关于如何测试简单的声明感知 ASP.NET MVC Web 应用程序以确保成功实现基于声明的身份验证的说明。本操作说明不包括如何创建安全令牌服务 (STS) 的详细说明，且假定你已配置 STS。

内容

目标
步骤摘要
步骤 1 – 创建简单的 ASP.NET MVC 应用程序
步骤 2 – 为基于声明的身份验证配置 ASP.NET MVC 应用程序
步骤 3 - 测试你的解决方案
相关项

目标

为基于声明的身份验证配置 ASP.NET MVC Web 应用程序
测试成功的声明感知 ASP.NET MVC Web 应用程序

步骤摘要

步骤 1 – 创建简单的 ASP.NET MVC 应用程序
步骤 2 – 为基于声明的身份验证配置 ASP.NET MVC 应用程序
步骤 3 - 测试你的解决方案

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

在此步骤中，将创建一个新的 ASP.NET MVC 应用程序。

创建简单的 ASP.NET MVC 应用程序

启动 Visual Studio，然后依次单击“文件”、“新建”和“项目”。
在“新建项目”窗口中，单击“ASP.NET MVC 3 Web 应用程序”。
在“名称”中，输入 TestApp，然后按“确定”。
在“新建 ASP.NET MVC 3 项目”对话框中，从可用模板中选择“Internet 应用程序”，确保将“视图引擎”设置为“Razor”，然后单击“确定”。
打开新建项目时，右键单击“解决方案资源管理器”中的“TestApp”项目，然后选择“属性面板”选项。
在项目的属性页上，单击左侧的“Web”选项卡，并确保选择了“使用本地 IIS Web 服务器”选项。

步骤 2 – 为基于声明的身份验证配置 ASP.NET MVC 应用程序

在此步骤中，将配置条目添加到 ASP.NET MVC Web 应用程序的 Web.config 配置文件中，以使其可感知声明。

为基于声明的身份验证配置 ASP.NET MVC 应用程序

将以下配置节定义添加到 Web.config 配置文件。它们定义 Windows Identity Foundation 所需的配置节。将定义紧随添加在 <configuration> 起始元素后：

XML复制

<configSections>  
    <section name="system.identityModel" type="System.IdentityModel.Configuration.SystemIdentityModelSection, System.IdentityModel, Version=4.0.0.0, Culture=neutral, PublicKeyToken=B77A5C561934E089" />  
    <section name="system.identityModel.services" type="System.IdentityModel.Services.Configuration.SystemIdentityModelServicesSection, System.IdentityModel.Services, Version=4.0.0.0, Culture=neutral, PublicKeyToken=B77A5C561934E089" />  
</configSections>

添加 <location> 元素，用于启用对应用程序的联合元数据的访问权限：

XML复制

<location path="FederationMetadata">  
    <system.web>  
        <authorization>  
            <allow users="*" />  
        </authorization>  
    </system.web>  
</location>

在 <system.web> 元素内添加以下配置条目以拒绝用户、禁用本机身份验证并启用 WIF 来管理身份验证。

XML复制
```
<authorization>  
    <deny users="?" />  
</authorization>  
<authentication mode="None" />  
```

添加以下 Windows Identity Foundation 相关配置条目，并确保 ASP.NET 应用程序的 URL 和端口号与 <audienceUris> 条目、<wsFederation> 元素的“realm”特性和 <wsFederation> 元素的“reply”特性中的值相匹配。还需确保“issuer”值与安全令牌服务 (STS) URL 相适应。

XML复制

<system.identityModel>  
    <identityConfiguration>  
        <audienceUris>  
            <add value="http://localhost:28503/" />  
        </audienceUris>  
        <issuerNameRegistry type="System.IdentityModel.Tokens.ConfigurationBasedIssuerNameRegistry, System.IdentityModel, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089">  
            <trustedIssuers>  
                <add thumbprint="1234567890ABCDEFGHIJKLMNOPQRSTUVWXYZ1234" name="YourSTSName" />  
            </trustedIssuers>   
        </issuerNameRegistry>  
        <certificateValidation certificateValidationMode="None" />  
    </identityConfiguration>  
</system.identityModel>  
<system.identityModel.services>  
    <federationConfiguration>  
        <cookieHandler requireSsl="false" />  
        <wsFederation passiveRedirectEnabled="true" issuer="http://localhost:13922/wsFederationSTS/Issue" realm="http://localhost:28503/" reply="http://localhost:28503/" requireHttps="false" />  
    </federationConfiguration>  
</system.identityModel.services>

将引用添加到 System.IdentityModel 程序集。
编译此解决方案，确保没有任何错误。

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

在此步骤中，将测试为基于声明的身份验证配置的 ASP.NET MVC Web 应用程序。若要执行基本测试，需添加用于在安全令牌服务 (STS) 颁发的令牌中显示声明的简单代码。

为基于声明的身份验证测试 ASP.NET MVC 应用程序

在“解决方案资源管理器”中，展开 Controllers 文件夹，并在编辑器中打开 HomeController.cs 文件。将以下代码添加到 Index 方法中：

C#复制
```
public ActionResult Index()  
{  
    ViewBag.ClaimsIdentity = Thread.CurrentPrincipal.Identity;  

    return View();  
}  
```

在“解决方案资源管理器”中，依次展开 Views 和 Home 文件夹，然后在编辑器中打开 Index.cshtml 文件。删除其内容并添加以下标记：

HTML复制

@{  
    ViewBag.Title = "Home Page";  
}  

<h2>Welcome: @ViewBag.ClaimsIdentity.Name</h2>  
<h3>Values from Identity</h3>  
<table>  
    <tr>  
        <th>  
            IsAuthenticated   
        </th>  
        <td>  
            @ViewBag.ClaimsIdentity.IsAuthenticated   
        </td>  
    </tr>  
    <tr>  
        <th>  
            Name   
        </th>          
        <td>  
            @ViewBag.ClaimsIdentity.Name  
        </td>          
    </tr>  
</table>  
<h3>Claims from ClaimsIdentity</h3>  
<table>  
    <tr>  
        <th>  
            Claim Type  
        </th>  
        <th>  
            Claim Value  
        </th>  
        <th>  
            Value Type  
        </th>  
        <th>  
            Subject Name  
        </th>          
        <th>  
            Issuer Name  
        </th>          
    </tr>  
        @foreach (System.Security.Claims.Claim claim in ViewBag.ClaimsIdentity.Claims ) {  
    <tr>  
        <td>  
            @claim.Type  
        </td>  
        <td>  
            @claim.Value  
        </td>  
        <td>  
            @claim.ValueType  
        </td>  
        <td>  
            @claim.Subject.Name  
        </td>  
        <td>  
            @claim.Issuer  
        </td>  
    </tr>  
}  
</table>

按 F5 键运行解决方案。
应当会看到在安全令牌服务颁发给你的令牌中显示声明的页面。