c# - 带有特殊字符的 WOPI 文件名未在在线编辑器中打开文件
问题描述
有一个专门为其中一个Web应用程序设置的WOPI客户端和主机,当文件名正确且没有任何URL保留字符时,在线编辑器可以正常工作,但是当文件名包含+,#,&标志WOPI协议时路由将这些字符视为分隔符并提供 404 错误,因为该路由不适用于 GetFile、GetFileInfo 端点。
例子:
[Route("files/{fileName}/")]
[HttpGet]
public async Task<FileInfoBE> GetFileInfo(string fileName, string access_token)
{ //Logic here }
在上述端点调用中,如果文件名包含加号 (+) 并且对该端点的调用是 URL 编码的,则加号将转换为 %2b,理想情况下它应该命中端点,但在调用之前由webclient %2b 正在转换为 + 符号并给出 404 错误。
注意:自定义编码没有帮助,因为 OWA 服务器与 WOPI 服务交互。
解决方案
问题是路由属性参数不接受任何保留字符,即使它们是 URL 编码的:
这将起作用:
https://localhost:44349/files/?fileName=mydocument%2B%23%26.docx&access_token=test-token
[Route("files/")]
[HttpGet]
public async Task<string> GetFileInfo2(string fileName, string access_token)
{
return "Test";
}
这不起作用:
https://localhost:44349/files/mydocument%2B%23%26.docx?access_token=test-token
[Route("files/{fileName}/")]
[HttpGet]
public async Task<string> GetFileInfo(string fileName, string access_token)
{
return "Test";
}
使用 WebClient 代理调用从 Javascript 前端到 C# 后端的完整示例:
Javascript:
let fileName = encodeURIComponent('mydocument+#&.docx');
fetch(`files?fileName=${fileName}&access_token=test-token`)
.then(function (response) {
return response.json();
})
.then(function (myJson) {
console.log(JSON.stringify(myJson));
});
C#:
[Route("files/")]
[HttpGet]
public async Task<string> GetFileInfo(string fileName, string access_token)
{
using (WebClient client = new WebClient())
{
var host = $"{HttpContext.Current.Request.Url.Scheme}://{HttpContext.Current.Request.Url.Host}:{HttpContext.Current.Request.Url.Port}";
var data = client.DownloadString($"{host}/proxy/files/?fileName={HttpUtility.UrlEncode(fileName)}&access_token={HttpUtility.UrlEncode(access_token)}");
return data;
}
}
[AllowAnonymous]
[Route("proxy/files/")]
[HttpGet]
public async Task<string> ProxyGetFileInfo(string fileName, string access_token)
{
return "MyValues";
}
为什么不允许使用这些字符以及为什么需要首先处理它:
URI 语法中不允许使用的排除的 US-ASCII 字符:
control = <US-ASCII coded characters 00-1F and 7F hexadecimal>
space = <US-ASCII coded character 20 hexadecimal>
delims = "<" | ">" | "#" | "%" | <">
字符“#”被排除在外,因为它用于将 URI 与片段标识符分隔开。百分比字符“%”被排除在外,因为它用于转义字符的编码。换句话说,“#”和“%”是必须在特定上下文中使用的保留字符。
不明智的字符列表是允许的,但可能会导致问题:
unwise = "{" | "}" | "|" | "\" | "^" | "[" | "]" | "`"
在查询组件中保留的字符和/或在 URI/URL 中具有特殊含义的字符:
reserved = ";" | "/" | "?" | ":" | "@" | "&" | "=" | "+" | "$" | ","
上面的“保留”语法类是指在 URI 中允许使用但在通用 URI 语法的特定组件中可能不允许使用的那些字符。“保留”集中的字符并非在所有上下文中都保留。例如,主机名可以包含可选的用户名,因此它可能类似于ftp://user@hostname/
“@”字符具有特殊含义的地方。
资源:
推荐阅读
- puppeteer - 如何使用 Puppeteer 粘贴文本?
- matlab - 我应该怎么做未定义的函数'冒号'..?
- javascript - 如何在 D3 轴和图表之间应用填充?
- google-sheets - 是否可以在 Google 表格中添加带有小时和分钟的时间下拉列表?
- html - 如何用 HTML 中的图像填充文本?
- python - 在熊猫df的滚动窗口中计算重复行
- python - 如何在给定最大、最小和要生成的点数的情况下生成具有偏态分布的 numpy 数组
- ace-editor - 如何在 Ace Editor 的装订线中添加自定义错误?
- javascript - 将数组编号转换为与 HTML 类组合 #
- javascript - Javascript 代码未在 Wordpress 页面中运行