使用API token访问CPanel UAPI返回access denied错误咨询

操作存在的核心问题 #

• curl命令的Header参数格式错误：-H参数与后续请求头内容之间缺少空格，会导致curl无法正确识别并发送Authorization认证头，服务端收不到鉴权信息必然返回权限错误。
• 未确认API Token的权限范围：cPanel生成API Token时支持精细化配置接口访问权限，若生成Token时未勾选Email模块的操作权限，即使Token本身有效也会被拒绝访问。
• Authorization头内的用户名易填错：该位置需要填写登录cPanel面板的主账户用户名，不是邮箱前缀、代理商账户名，填错会直接导致鉴权失败。
• 接口请求参数不全：当前调用的Email/add_pop接口除邮箱前缀、密码外，还必须传入邮箱绑定的域名、邮箱配额参数，参数缺失即使鉴权通过也无法正常执行。
• 可能存在IP访问限制：如果cPanel开启了API调用IP白名单，发起请求的IP不在白名单内时，会直接返回access denied，和Token是否有效无关。

分步解决方法 #

1. 首先修正curl命令的基础格式，补全必填参数，参考如下正确命令模板：

curl -H 'Authorization: cpanel 你的cPanel登录用户名:你的API Token' 'https://你的域名:2083/execute/Email/add_pop?email=newuser&domain=邮箱绑定的主域名&password=符合强度要求的密码&quota=500'

说明：quota参数单位为MB，传0代表不限制邮箱容量；密码需要满足cPanel配置的密码强度要求，否则后续会报参数错误。如果服务器使用自签SSL证书，可在curl命令中加-k参数跳过证书校验。

2. 核对Authorization头内的用户名：必须和你登录cPanel面板时输入的主账户用户名完全一致，不要使用邮箱前缀、WHM代理商账号替换。
3. 检查API Token权限：登录cPanel面板进入API Token管理页，找到你正在使用的Token，确认其权限范围包含Email模块的操作权限，测试阶段可以先开放全部权限，验证通后再收窄权限范围。
4. 检查IP访问限制：如果cPanel配置了API访问IP白名单，将你发起请求的本地/服务器IP加入白名单，同时确认请求端可以正常连通服务器2083端口，没有被本地或服务器防火墙拦截。
5. 鉴权问题排查：先用同样的认证头请求无权限要求的基础测试接口/execute/Variables/get_session_information，如果该接口也返回access denied，说明还是认证头、用户名、Token有效性、IP限制的问题；如果该接口能正常返回数据，再针对性检查Email接口的参数和Token对应模块的权限。

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