如何在ASP.NET MVC / WebAPI应用程序中支持HTTP OPTIONS动词

时间:2013-09-30 13:41:13

标签: asp.net ajax asp.net-web-api

我已经设置了一个以MVC 4 / Web API模板开头的ASP.NET Web应用程序。看起来好像工作得很好 - 我没有发现任何问题。我使用Chrome和Firefox浏览网站。我已经使用Fiddler进行了测试,所有的回复似乎都在钱上。

所以现在我继续编写一个简单的Test.aspx来使用这个新的Web API。脚本的相关部分:

<script type="text/javascript">
    $(function () {

        $.ajax({
            url: "http://mywebapidomain.com/api/user",
            type: "GET",
            contentType: "json",
            success: function (data) {

                $.each(data, function (index, item) {

                    ....

                    });
                }
                );

            },
            failure: function (result) {
                alert(result.d);
            },

            error: function (XMLHttpRequest, textStatus, errorThrown) {
                alert("An error occurred, please try again. " + textStatus);
            }

        });

    });
</script>

这会生成一个REQUEST标头:

OPTIONS http://host.mywebapidomain.com/api/user HTTP/1.1
Host: host.mywebapidomain.com
User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64; rv:24.0) Gecko/20100101 Firefox/24.0
Accept: text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8
Accept-Language: en-US,en;q=0.5
Accept-Encoding: gzip, deflate
Origin: http://mywebapidomain.com
Access-Control-Request-Method: GET
Access-Control-Request-Headers: content-type
Connection: keep-alive

原样,Web API返回405方法不允许。

HTTP/1.1 405 Method Not Allowed
Cache-Control: no-cache
Pragma: no-cache
Content-Type: application/xml; charset=utf-8
Expires: -1
Server: Microsoft-IIS/8.0
X-AspNet-Version: 4.0.30319
X-Powered-By: ASP.NET
Date: Mon, 30 Sep 2013 13:28:12 GMT
Content-Length: 96

<Error><Message>The requested resource does not support http method 'OPTIONS'.</Message></Error>

据我所知,OPTIONS动词默认情况下没有在Web API控制器中连接...所以,我将以下代码放在我的UserController.cs中:

// OPTIONS http-verb handler
public HttpResponseMessage OptionsUser()
{
    var response = new HttpResponseMessage();
    response.StatusCode = HttpStatusCode.OK;
    return response;
}

...这消除了405 Method Not Allowed错误,但响应完全为空 - 没有返回数据:

HTTP/1.1 200 OK
Cache-Control: no-cache
Pragma: no-cache
Expires: -1
Server: Microsoft-IIS/8.0
X-AspNet-Version: 4.0.30319
X-Powered-By: ASP.NET
Date: Mon, 30 Sep 2013 12:56:21 GMT
Content-Length: 0

必须有额外的逻辑...我不知道如何正确编码Options方法,或者控制器是否是放置代码的适当位置。奇怪(对我而言)从Firefox或Chrome查看时,Web API站点响应正常,但上面的.ajax调用错误。如何处理.ajax代码中的“预检”检查?也许我应该在客户端的.ajax逻辑上解决这个问题?或者,如果由于未处理OPTIONS动词而在服务器端出现问题。

有人可以帮忙吗?这一定是一个非常普遍的问题,如果在这里得到解答我会道歉。我搜索过但没有找到任何有帮助的答案。

更新 恕我直言,这是客户端问题,与上面的Ajax JQuery代码有关。我这样说是因为当我从Web浏览器访问mywebapidomain / api / user时,Fiddler没有显示任何405错误标题。我可以复制此问题的唯一地方是来自JQuery .ajax()调用。此外,上面相同的Ajax调用在服务器(同一域)上运行时工作正常。

我发现了另一篇帖子:Prototype AJAX request being sent as OPTIONS rather than GET; results in 501 error似乎与此相关,但我对他们的建议进行了修改但没有成功。显然,JQuery是编码的,如果一个Ajax请求是跨域的(我的是),它会添加一些标题,以某种方式触发OPTIONS标题。

'X-Requested-With': 'XMLHttpRequest',
'X-Prototype-Version': Prototype.Version,

似乎应该有一个比在JQuery中修改核心代码更好的解决方案...

下面提供的答案假设这是服务器端问题。也许,我想,但我倾向于客户并致电托管服务提供商并不会有所帮助。

11 个答案:

答案 0 :(得分:87)

Mike Goodwin的答案很棒但是当我尝试它的时候,似乎是针对MVC5 / WebApi 2.1。 Microsoft.AspNet.WebApi.Cors的依赖项与我的MVC4项目不兼容。

使用MVC4在WebApi上启用CORS的最简单方法如下:

请注意,我已允许所有内容,我建议您将Origin限制为您希望API投放的客户端。允许一切都存在安全风险。

的Web.config:

<system.webServer>
    <httpProtocol>
      <customHeaders>
        <add name="Access-Control-Allow-Origin" value="*" />
        <add name="Access-Control-Allow-Methods" value="GET, PUT, POST, DELETE, HEAD" />
        <add name="Access-Control-Allow-Headers" value="Origin, X-Requested-With, Content-Type, Accept" />
      </customHeaders>
    </httpProtocol>
</system.webServer>

BaseApiController.cs:

我们这样做是为了允许OPTIONS http动词

 public class BaseApiController : ApiController
  {
    public HttpResponseMessage Options()
    {
      return new HttpResponseMessage { StatusCode = HttpStatusCode.OK };
    }
  }

答案 1 :(得分:46)

正如Daniel A. White在评论中所说,OPTIONS请求很可能是由客户端创建的,作为跨域JavaScript请求的一部分。这是由符合跨域资源共享(CORS)的浏览器自动完成的。该请求是在实际AJAX请求之前发出的初步或飞行前请求,以确定CORS支持哪些请求谓词和标头。服务器可以选择支持无动词,全部或部分HTTP动词。

为了完成图片,AJAX请求有一个额外的“Origin”标题,用于标识托管JavaScript的原始页面的位置。服务器可以选择支持来自任何来源的请求,或仅支持一组已知的可信来源。允许任何来源是一种安全风险,因为这会增加跨站点请求伪造(CSRF)的风险。

因此,您需要启用CORS。

这是一个解释如何在ASP.Net Web API中执行此操作的链接

http://www.asp.net/web-api/overview/security/enabling-cross-origin-requests-in-web-api#enable-cors

在那里描述的实现允许您指定

  • 基于每个操作,每个控制器或全局的CORS支持
  • 支持的来源
  • 启用CORS a控制器或全局级别时,支持的HTTP谓词
  • 服务器是否支持发送具有跨源请求的凭据

通常,这样可以正常工作,但您需要确保知道安全风险,特别是如果您允许来自任何域的跨源请求。在允许之前要仔细考虑。

就哪些浏览器支持CORS而言,维基百科称以下引擎支持CORS:

  • Gecko 1.9.1(FireFox 3.5)
  • WebKit(Safari 4,Chrome 3)
  • MSHTML / Trident 6(IE10),在IE8和9
  • 中具有部分支持
  • Presto(Opera 12)

http://en.wikipedia.org/wiki/Cross-origin_resource_sharing#Browser_support

答案 2 :(得分:22)

只需将此添加到您的Application_OnBeginRequest方法(这将为您的应用程序全局启用CORS支持)并“处理”预检请求:

var res = HttpContext.Current.Response;
var req = HttpContext.Current.Request;
res.AppendHeader("Access-Control-Allow-Origin", req.Headers["Origin"]);
res.AppendHeader("Access-Control-Allow-Credentials", "true");
res.AppendHeader("Access-Control-Allow-Headers", "Content-Type, X-CSRF-Token, X-Requested-With, Accept, Accept-Version, Content-Length, Content-MD5, Date, X-Api-Version, X-File-Name");
res.AppendHeader("Access-Control-Allow-Methods", "POST,GET,PUT,PATCH,DELETE,OPTIONS");

// ==== Respond to the OPTIONS verb =====
if (req.HttpMethod == "OPTIONS")
{
    res.StatusCode = 200;
    res.End();
}

*安全性:请注意,这将从您的服务器的任何位置启用ajax请求(如果您愿意,您可以只允许以逗号分隔的起源/网址列表)。

我使用的是当前客户端来源而不是*,因为这将允许凭据=&gt;将Access-Control-Allow-Credentials设置为true将启用跨浏览器会话管理

您还需要在webconfig部分system.webServer中启用delete和put,patch和options谓词,否则IIS会阻止它们:

<handlers>
  <remove name="ExtensionlessUrlHandler-ISAPI-4.0_32bit" />
  <remove name="ExtensionlessUrlHandler-ISAPI-4.0_64bit" />
  <remove name="ExtensionlessUrlHandler-Integrated-4.0" />
  <add name="ExtensionlessUrlHandler-ISAPI-4.0_32bit" path="*." verb="GET,HEAD,POST,DEBUG,PUT,DELETE,PATCH,OPTIONS" modules="IsapiModule" scriptProcessor="%windir%\Microsoft.NET\Framework\v4.0.30319\aspnet_isapi.dll" preCondition="classicMode,runtimeVersionv4.0,bitness32" responseBufferLimit="0" />
  <add name="ExtensionlessUrlHandler-ISAPI-4.0_64bit" path="*." verb="GET,HEAD,POST,DEBUG,PUT,DELETE,PATCH,OPTIONS" modules="IsapiModule" scriptProcessor="%windir%\Microsoft.NET\Framework64\v4.0.30319\aspnet_isapi.dll" preCondition="classicMode,runtimeVersionv4.0,bitness64" responseBufferLimit="0" />
  <add name="ExtensionlessUrlHandler-Integrated-4.0" path="*." verb="GET,HEAD,POST,DEBUG,PUT,DELETE,PATCH,OPTIONS" type="System.Web.Handlers.TransferRequestHandler" preCondition="integratedMode,runtimeVersionv4.0" />
</handlers>

希望这会有所帮助

答案 3 :(得分:15)

在Web API 2项目中遇到相同的问题(并且由于不值得进入的原因而无法使用标准CORS包),我能够通过实现自定义DelagatingHandler解决此问题:

public class AllowOptionsHandler : DelegatingHandler
{
    protected override async Task<HttpResponseMessage> SendAsync(
        HttpRequestMessage request, CancellationToken cancellationToken)
    {
        var response = await base.SendAsync(request, cancellationToken);

        if (request.Method == HttpMethod.Options &&
            response.StatusCode == HttpStatusCode.MethodNotAllowed)
        {
            response = new HttpResponseMessage(HttpStatusCode.OK);
        }

        return response;
    }
}

对于Web API配置:

config.MessageHandlers.Add(new AllowOptionsHandler());

请注意,我也在Web.config中启用了CORS标头,类似于此处发布的其他一些答案:

<system.webServer>
  <modules runAllManagedModulesForAllRequests="true">
    <remove name="WebDAVModule" />
  </modules>

  <httpProtocol>
    <customHeaders>
      <add name="Access-Control-Allow-Origin" value="*" />
      <add name="Access-Control-Allow-Headers" value="accept, cache-control, content-type, authorization" />
      <add name="Access-Control-Allow-Methods" value="GET, POST, PUT, DELETE, OPTIONS" />
    </customHeaders>
  </httpProtocol>

  <handlers>
    <remove name="ExtensionlessUrlHandler-Integrated-4.0" />
    <remove name="TRACEVerbHandler" />
    <add name="ExtensionlessUrlHandler-Integrated-4.0" path="*." verb="*" type="System.Web.Handlers.TransferRequestHandler" preCondition="integratedMode,runtimeVersionv4.0" />
  </handlers>
</system.webServer>

请注意,我的项目不包括MVC,只包含Web API 2.

答案 4 :(得分:8)

我已经成功克服了飞行前ajax选项请求中抛出的405和404错误,只能通过global.asax中的自定义代码

protected void Application_BeginRequest()
    {            
        HttpContext.Current.Response.AddHeader("Access-Control-Allow-Origin", "*");
        if (HttpContext.Current.Request.HttpMethod == "OPTIONS")
        {
            //These headers are handling the "pre-flight" OPTIONS call sent by the browser
            HttpContext.Current.Response.AddHeader("Access-Control-Allow-Methods", "GET, OPTIONS");
            HttpContext.Current.Response.AddHeader("Access-Control-Allow-Headers", "Content-Type, Accept");
            HttpContext.Current.Response.AddHeader("Access-Control-Max-Age", "1728000");
            HttpContext.Current.Response.End();
        }
    }

PS:在允许所有内容时考虑安全问题*。

我必须禁用CORS,因为它正在返回&#39; Access-Control-Allow-Origin&#39;标头包含多个值。

在web.config中也需要这个:

<handlers>
  <remove name="ExtensionlessUrlHandler-Integrated-4.0"/>
  <remove name="OPTIONSVerbHandler"/>
  <remove name="TRACEVerbHandler"/>
  <add name="ExtensionlessUrlHandler-Integrated-4.0" path="*." verb="*" type="System.Web.Handlers.TransferRequestHandler" preCondition="integratedMode,runtimeVersionv4.0"/>
</handlers>

app.pool需要设置为集成模式。

答案 5 :(得分:7)

我有同样的问题。对我来说,修复是从jQuery AJAX调用中删除自定义内容类型。自定义内容类型会触发转机前请求。我发现了这个:

  

如果满足以下条件,浏览器可以跳过预检请求:

     

请求方法为GETHEADPOST

     

除了AcceptAccept-LanguageContent-LanguageContent-TypeLast-Event-ID

     

Content-Type标头(如果已设置)是以下之一:

     
      
  • application/x-www-form-urlencoded
  •   
  • multipart/form-data
  •   
  • text/plain
  •   

从此页面:http://www.asp.net/web-api/overview/security/enabling-cross-origin-requests-in-web-api(在“预检请求”下)

答案 6 :(得分:3)

在ASP.NET web api 2中,添加了CORS支持。请检查链接[http://www.asp.net/web-api/overview/security/enabling-cross-origin-requests-in-web-api]

答案 7 :(得分:2)

    protected void Application_EndRequest()
    {
        if (Context.Response.StatusCode == 405 && Context.Request.HttpMethod == "OPTIONS" )
        {
            Response.Clear();
            Response.StatusCode = 200;
            Response.End();
        }
    }

答案 8 :(得分:1)

我也遇到了同样的问题。

按照以下步骤解决浏览器中(CORS)合规性的问题。

使用Cors参考在您的解决方案中包含REDRock。 包括WebActivatorEx对Web API解决方案的引用。

然后在Web API App_Start文件夹中添加文件CorsConfig。

[assembly: PreApplicationStartMethod(typeof(WebApiNamespace.CorsConfig), "PreStart")]

namespace WebApiNamespace
{
    public static class CorsConfig
    {
        public static void PreStart()
        {
            GlobalConfiguration.Configuration.MessageHandlers.Add(new RedRocket.WebApi.Cors.CorsHandler());
        }
    }
}

完成这些更改后,我可以在所有浏览器中访问webapi。

答案 9 :(得分:1)

我遇到了同样的问题,这就是我修复它的方法:

把它扔进你的web.config:

<system.webServer>
    <modules>
      <remove name="WebDAVModule" />
    </modules>

    <httpProtocol>
      <customHeaders>
        <add name="Access-Control-Expose-Headers " value="WWW-Authenticate"/>
        <add name="Access-Control-Allow-Origin" value="*" />
        <add name="Access-Control-Allow-Methods" value="GET, POST, OPTIONS, PUT, PATCH, DELETE" />
        <add name="Access-Control-Allow-Headers" value="accept, authorization, Content-Type" />
        <remove name="X-Powered-By" />
      </customHeaders>
    </httpProtocol>

    <handlers>
      <remove name="WebDAV" />
      <remove name="ExtensionlessUrlHandler-Integrated-4.0" />
      <remove name="TRACEVerbHandler" />
      <add name="ExtensionlessUrlHandler-Integrated-4.0" path="*." verb="*" type="System.Web.Handlers.TransferRequestHandler" preCondition="integratedMode,runtimeVersionv4.0" />
    </handlers>
</system.webServer>

答案 10 :(得分:0)

//In the Application_OnBeginRequest method in GLOBAL.ASX add the following:-  

var res = HttpContext.Current.Response;  
var req = HttpContext.Current.Request;  
res.AppendHeader("Access-Control-Allow-Origin", "*");  
res.AppendHeader("Access-Control-Allow-Credentials", "true");  
res.AppendHeader("Access-Control-Allow-Headers", "Authorization");  
res.AppendHeader("Access-Control-Allow-Methods", "POST,GET,PUT,PATCH,DELETE,OPTIONS");  

    // ==== Respond to the OPTIONS verb =====
    if (req.HttpMethod == "OPTIONS")
    {
        res.StatusCode = 200;
        res.End();
    }

//Remove any entries in the custom headers as this will throw an error that there's to  
//many values in the header.  

<httpProtocol>
    <customHeaders>
    </customHeaders>
</httpProtocol>