如何修改WSO2 APIM-3.2.0与IS-5.10.0的管理员密码并解决APIM登录内部服务器错误问题

我之前也碰到过一模一样的情况，核心原因是只修改了IS的管理员密码，但APIM内部关联IS的配置还保留着旧密码，导致APIM调用IS的身份验证服务时失败，进而触发Internal Server Error。下面是完整的修复流程，按顺序操作就能解决：

一、先确认IS侧密码修改的完整性 #

虽然你已经能登录IS控制台，但还是要做个二次确认：

• 登录IS管理控制台，进入Main > Identity > Users and Roles > Users，找到admin用户，重新验证新密码是否生效（可以再修改一次确保没有遗漏）。

二、同步更新APIM侧关联IS的密码配置 #

APIM有几个关键配置文件需要同步新的IS管理员密码，因为APIM需要调用IS的管理服务完成登录验证、租户管理等操作：

1. 修改APIM的deployment.toml核心配置 #

找到APIM安装目录下的<APIM_HOME>/repository/conf/deployment.toml，定位以下配置项，把旧密码替换为新的IS管理员密码：

[apim.key_manager]
service_url = "https://<IS_HOST>:9443/services/"
username = "admin"
password = "<NEW_IS_ADMIN_PASSWORD>"

[identity_mgt]
service_url = "https://<IS_HOST>:9443/services/"
username = "admin"
password = "<NEW_IS_ADMIN_PASSWORD>"

[tenant_mgt]
service_url = "https://<IS_HOST>:9443/services/"
username = "admin"
password = "<NEW_IS_ADMIN_PASSWORD>"

提示：如果IS和APIM部署在同一台机器，<IS_HOST>填localhost即可；不同机器则填IS的实际IP或域名。

2. 检查并更新api-manager.xml（防止旧配置未被覆盖） #

部分旧版配置可能还保留在<APIM_HOME>/repository/conf/api-manager.xml中，找到以下节点更新密码：

<KeyManager>
    <ServerURL>https://<IS_HOST>:9443/services/</ServerURL>
    <Username>admin</Username>
    <Password><NEW_IS_ADMIN_PASSWORD></Password>
</KeyManager>

<IdentityManagement>
    <ServerURL>https://<IS_HOST>:9443/services/</ServerURL>
    <Username>admin</Username>
    <Password><NEW_IS_ADMIN_PASSWORD></Password>
</IdentityManagement>

<TenantManagement>
    <ServerURL>https://<IS_HOST>:9443/services/</ServerURL>
    <Username>admin</Username>
    <Password><NEW_IS_ADMIN_PASSWORD></Password>
</TenantManagement>

3. 清理APIM和IS的缓存 #

为了确保新配置完全生效，需要清理缓存文件：

• 先停止APIM和IS服务
• 删除APIM目录下的<APIM_HOME>/repository/tmp和<APIM_HOME>/repository/carbonapps文件夹
• 删除IS目录下的<IS_HOME>/repository/tmp和<IS_HOME>/repository/carbonapps文件夹

三、重启服务并验证 #

1. 先启动IS服务，确认IS管理控制台能正常用新密码登录
2. 再启动APIM服务
3. 尝试登录APIM的发布者（https://<APIM_HOST>:9443/publisher）和开发者门户（https://<APIM_HOST>:9443/devportal），用新的IS管理员密码登录，此时应该能正常访问了。

四、若仍有问题的排查方向 #

• 查看APIM的日志文件<APIM_HOME>/repository/logs/wso2carbon.log，搜索Internal Server Error相关的堆栈信息，定位具体是调用IS哪个服务失败，针对性检查配置
• 确认IS的9443端口是开放的，APIM服务器能正常访问IS的服务地址
• 检查IS的用户存储配置，确保admin用户存在且密码无误

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