通过管理门户管理 AWS 上的 MATLAB Web App Server

支持的平台：Linux^® 上的 MATLAB^® Web App Server™

在 Amazon^® Web Services 中部署 MATLAB Web App Server 参考架构并在云中配置许可后，请使用 MATLAB Web App Server 管理门户编辑服务器设置，配置用户对 Web App 的访问权限以及查看服务器日志。

有关在 AWS^® 上部署参考架构的信息，请参阅 MATLAB Web App Server 在亚马逊网络服务上的部署指南。有关设置 MATLAB Web App Server 许可证以在云中使用的详细信息，请参阅配置在云上使用的 MATLAB Web App Server 许可证。

连接并登录管理门户

注意

如果托管服务器的 EC2 实例使用私有 IP 地址，则可以从与 EC2 实例属于同一虚拟私有云 (VPC) 的虚拟机连接到该 EC2 实例。

在您的栈的栈详细信息中，点击输出选项卡。

查找名为 AdminPortalUrl 的键值，并点击 value 下列出的对应 URL。这将打开管理门户的 Overview 页面。

首次访问管理员门户时，可使用以下信息登录：

用户名	`matlab-webapps-admin`
密码	`matlab-webapps-admin`

登录后，系统会提示您更改密码。有关用户身份验证的详细信息，请参阅为 AWS 上的 MATLAB Web App Server 配置身份验证。

查看有关服务器的信息

要查看部署在 AWS 上的 MATLAB Web App Server 实例信息，请在管理门户导航菜单中点击 Overview。您可以查看服务器 URL、上次服务器重启时间以及服务器上安装的 MATLAB Runtime 版本。

右上角显示服务器状态。点击图标可启动、重启或关闭服务器。

The admin portal overview page that displays the server URL, the time of the last server restart, and MATLAB Runtime versions installed on the server.

编辑服务器配置

通过点击导航菜单中的配置，编辑 MATLAB Production Server™ 配置属性。更新属性后，点击保存以保存更改。您必须重启服务器才能应用更改。

您可以修改以下配置属性。

常规

属性	描述
网络许可证主机名	网络许可证管理器的主机名。
网络许可证端口	网络许可证管理器所在的端口。默认端口为 27000。

服务器日志

属性	描述
记录级别	设置日志记录的粒度级别。选择“最小”、“正常”或“详尽”。
日志存档最大大小 (MB)	日志目录中所有日志文件的最大大小（以兆字节 (MB) 为单位）。指定为正整数。
日志轮转大小 (MB)	日志文件在转为另一个文件之前的最大大小（以兆字节 (MB) 为单位）。指定为正整数。

会话设置

属性	描述
显示页脚	指定是否向特定用户显示 App 会话页脚和日志。
全屏模式	指定 App 会话是否以全屏模式启动。

App 会话

属性	描述
最大会话数	MATLAB Web App Server 支持的最大会话数。使用正整数，或输入 `-1` 以每可用内存 1 GB 分配 1 个会话。
App 会话空闲超时 (分钟)	空闲时终止会话前的超时时间（以分钟为单位）。指定为正整数。
App 会话启动超时 (秒)	启动新会话时的超时时间（以秒为单位）。指定为正整数。

自定义 MATLAB Web App Server App 主页

在自定义页面中，您可以更改您的 MATLAB Web App Server App 主页的外观。您可以自定义以下功能：

App 主页中横幅的标题、背景颜色、字体类型和字体大小。
在 App 页眉和浏览器选项卡中添加自定义徽标图像。

管理 App 访问控制、机密和用户信息

注意

要创建用户信息属性并使用用户身份验证来控制 App 访问权限，您必须在服务器上启用身份验证。默认情况下，用户身份验证通过 Keycloak 进行管理。有关详细信息，请参阅为 AWS 上的 MATLAB Web App Server 配置身份验证。

App 管理页面允许您为特定 App 或文件夹设置访问控制、机密和用户信息。点击 App 旁边的管理按钮，即可管理 App 属性。

访问控制

在 App 管理/访问控制选项卡上，允许特定用户和组访问 App 或文件夹。只有特定用户和用户组才能访问MATLAB Web App Server上的 App 和文件夹。只有特定的用户和组才能访问这些资源。您可以通过单击 Add User 并指定用户或组 ID 来为用户或组添加权限。用户或组名称必须与您的身份验证提供商提供的用户或组相符。然后，您可以为 App 或文件夹授予执行或上传/删除权限。

机密

在 App Management/Secrets 选项卡上创建密钥，以实现对敏感数据的安全灵活访问。每个密钥由名称（以明文形式存储）和值（加密后存储于 MATLAB Web App Server 保险库）组成。

要向 App 添加新密钥，请点击 Create Secret。输入密钥名称和密钥值。在您的 Web App 中，调用 getSecret (MATLAB) 并传入密钥名称，即可返回您指定的密钥值。有关创建和使用密钥的详细信息，请参阅处理已部署 App 中的敏感信息。

用户信息

允许 App 访问 App 管理/用户信息选项卡上的用户信息属性。

要允许特定 App 访问用户信息属性，请点击 App 名称旁边的添加属性。您可以选择现有属性，或输入新的属性名称-值。直接添加到 App 的新用户信息属性会添加到用户信息页面的属性列表中。

要创建、修改或删除用户信息属性，请导航至 User Info 页面。

管理用户信息属性

注意

要创建和使用用户信息属性，必须先在服务器上启用身份验证。默认情况下，用户身份验证通过 Keycloak 进行管理。有关详细信息，请参阅为 AWS 上的 MATLAB Web App Server 配置身份验证。

在服务器上创建、修改或删除用户信息属性。用户信息属性允许您根据登录用户的身份自定义 Web App 的行为。例如，您可以在应用程序代码中访问当前登录用户的用户 ID、显示名称或电子邮件。

默认存在两个属性。

WebAppsRole - 用户角色，可以是作者或用户。
WebAppsDisplayName - 用户在网页 App 首页显示的用户名。

您可以为服务器全局创建额外的用户信息属性，也可以为每个 App 单独创建。例如，要允许 App 使用用户的电子邮件，您可以创建一个名为 email 新用户信息属性。该值必须是身份提供方用于识别电子邮件的值，例如 mail。在 Web App 代码中，您引用了 email 属性，服务器返回了声明 mail。

要允许特定 App 访问用户信息属性，请导航至 App 管理页面。

访问服务器和启动程序日志

在服务器日志和 Launcher Logs 页面上，您可以查看、搜索和下载包含服务器运行服务信息的日志。服务器生成多个日志文件，每个文件都有不同的用途。根据您遇到的问题，您可能需要查看一个或多个日志文件。您可以在配置页面上更改日志详细程度。

服务器日志

您可以在服务器日志页面访问以下日志。

日志文件名	目的
`webapps_<timestamp>.log`	运行服务器的服务的日志文件。
`webapps_service_start.err`	当运行服务器的服务启动失败时捕获错误的日志文件。
`webapps_service_start.out`	当运行服务器的服务启动失败时捕获标准输出的日志文件。

启动程序日志

您可以在启动程序日志页面访问以下日志。

日志文件名	目的
`webapps_launcher_service_start.err`	捕获与启动运行 App 的服务相关的错误的日志文件。
`webapps_launcher_service_start.out`	当运行 App 的服务启动失败时捕获标准输出的日志文件。
`webapps_service_start.err`	当运行服务器的服务启动失败时捕获错误的日志文件。

更新管理门户证书

要更新管理门户使用的证书和密钥，请连接到服务器计算机。然后，将新的证书 (.pem) 和密钥 (.pem) 文件放置在 /local/MathWorks/webapps/<release>/config/webapps_private 下。

在命令行中，重启管理门户服务以使更改生效。

sudo systemctl restart mw-adminportal-gateway.service
sudo systemctl restart mw-adminportal-manager.service
sudo systemctl restart mw-adminportal-authn.service
sudo systemctl restart mw-adminportal-workspace.service
sudo systemctl restart mw-adminportal-ui.service

有关 SSL 证书的更多详细信息，请参阅在 MATLAB Web App Server 上启用 SSL。