Kentico Xperience REST服务：哈希认证访问自定义表时请求出错

问题概述 #

• 已按要求配置Hash参数完成哈希认证，访问根REST路径http://localhost:81/Admin_Site/rest正常
• 访问自定义表REST地址http://localhost:81/Admin_Site/rest/customtableitem.sitenamespace.tablename时触发请求错误，仅手动输入全局管理员凭据可正常访问

排查与修复步骤 #

1. 检查自定义表的REST权限配置 #

• 登录Kentico后台，找到目标自定义表，进入权限设置页面
• 确认已为哈希认证使用的用户（或其所属角色）分配该自定义表的REST访问权限，以及对应操作（如读取）的权限
• 确保自定义表本身已启用REST访问（在表属性中勾选“允许通过REST服务访问”）

2. 验证URL与哈希生成逻辑 #

• 核对自定义表URL中的sitenamespace和tablename是否与后台定义完全一致（Kentico对名称大小写敏感）
• 确认哈希参数生成时包含所有必填字段：siteName、userName、password、nonce、timestamp，且siteName与当前站点名称匹配
• 对比根REST路径和自定义表请求的哈希生成代码，确保逻辑完全一致，无参数遗漏或错误

3. 核对请求头信息 #

• 确保自定义表请求的HTTP头包含以下字段：
  • X-CMS-Hash：生成的哈希值
  • X-CMS-UserName：认证用户名称
  • X-CMS-Nonce：随机字符串（每次请求唯一）
  • X-CMS-Timestamp：请求的时间戳（需与服务器时间差在5分钟内，可在web.config调整CMSRESTServiceMaxTimeDifference参数）

4. 分析错误日志 #

• 查看Kentico后台的事件日志，找到对应请求的错误记录，日志会明确提示失败原因：
  • 若为“权限不足”：回到步骤1补全权限
  • 若为“哈希不匹配”：检查参数生成逻辑或时间戳偏差
  • 若为“资源不存在”：确认URL中的命名空间和表名正确

内容的提问来源于stack exchange，提问作者Irene Gunning