1.3. JBoss EAP 管理

JBoss EAP 使用简化的配置，每个单机服务器或受管域有一个配置文件。单机服务器的默认配置存储在 EAP_HOME/standalone/configuration/standalone.xml 文件中，受管域的默认配置则存储在 EAP_HOME/domain/configuration/domain.xml 文件中。此外，主机控制器的默认配置存储在 EAP_HOME/domain/configuration/host.xml 文件中。

可以使用命令行管理 CLI、基于 Web 的管理控制台、Java API 或 HTTP API 来配置 JBoss EAP。使用这些管理接口所做的更改将自动保留，并且管理 API 将覆盖 XML 配置文件。管理 CLI 和管理控制台是首选的方法，不建议手动编辑 XML 配置文件。

1.3.1. 管理用户

默认 JBoss EAP 配置提供本地身份验证，让用户可以访问本地主机上的管理 CLI，而无需身份验证。

但是，如果您要远程访问管理 CLI，则必须添加管理用户，或使用管理控制台，即使流量来自本地主机上也被视为远程访问。如果在添加管理用户之前尝试访问管理控制台，您会收到错误消息。

如果使用图形安装程序安装 JBoss EAP，则在安装过程中创建管理用户。

本指南介绍了使用 add-user 脚本对 JBoss EAP 进行简单的用户管理，此脚本可用于将新用户添加到用于开箱即用身份验证的属性文件中。

有关更高级的身份验证和授权选项，如 LDAP 或基于角色的访问控制(RBAC)，请参见 JBoss EAP 安全架构的核心管理身份验证部分 。

1.3.1.1. 添加管理用户

  1. 运行 add-user 实用程序脚本并按照提示进行操作。 

    $ EAP_HOME/bin/add-user.sh
    注意

    对于 Windows Server，请使用 EAP_HOME\bin\add-user.bat 脚本。

  2. 按 ENTER，选择默认选项 a 以添加管理用户。

    此用户将添加到 ManagementRealm 中，并将获得使用管理控制台或管理控制台执行管理操作的授权。另一个选择 b 将用户添加到 ApplicationRealm 中，该应用程序用于应用程序，不提供任何特定权限。

  3. 输入所需的用户名和密码。系统将提示您确认密码。

    注意

    用户名只能以任何数字和顺序包含以下字符：

    • 字母数字字符（a-z、A-Z、0-9）
    • 短划线(-)、句点(.)、逗号(@)
    • 反斜杠(\)
    • Equals (=)

    默认情况下，JBoss EAP 允许弱密码，但会发出警告。

    如需了解有关更改此默认行为的详细信息，请参阅 JBoss EAP 配置指南的设置 https://access.redhat.com/documentation/en-us/red_hat_jboss_enterprise_application_platform/7.3/html-single/configuration_guide/#add_user_password_restrictions 附加用户实用程序密码限制一节。

  4. 输入用户所属组的逗号分隔列表。如果您不希望用户属于任何组，请按 ENTER 将它留空。
  5. 检查信息并输入 yes 进行确认。

  6. 确定此用户是否代表远程 JBoss EAP 服务器实例。对于基本管理用户，请输入 no.

    可能需要添加到 ManagementRealm 的一种用户是代表另一个 JBoss EAP 实例的用户，它必须能够进行身份验证以作为群集成员加入。如果出现这种情况，则在此提示中回答 yes，系统会为您提供一个表示用户密码的散列化机密值，该值需要添加到其他配置文件中。

也可以通过向 add-user 脚本传递参数，以非交互方式创建用户。共享系统上不建议使用此方法，因为密码将在日志和历史记录文件中可见。如需更多信息，请参阅非活动运行 Add-User 实用程序。

1.3.1.2. 主动运行 Add-User 实用程序

您可以通过在命令行中传递参数，以非交互方式运行 add-user 脚本。必须至少提供用户名和密码。

警告

共享系统上不建议使用此方法，因为密码将在日志和历史记录文件中可见。

创建一个属于多个组的用户

以下命令添加了一个管理用户, mgmtuser1，它带有 guest and mgmtgroup 组。 

$ EAP_HOME/bin/add-user.sh -u 'mgmtuser1' -p 'password1!' -g 'guest,mgmtgroup'
指定替代属性文件

默认情况下，使用 add-user 脚本创建的用户和组信息存储在服务器配置目录中的属性文件中。

用户信息存储在以下属性文件中：

  • EAP_HOME/standalone/configuration/mgmt-users.properties
  • EAP_HOME/domain/configuration/mgmt-users.properties

组信息存储在以下属性文件中：

  • EAP_HOME/standalone/configuration/mgmt-groups.properties
  • EAP_HOME/domain/configuration/mgmt-groups.properties

这些默认目录和属性文件名可以被覆盖。以下命令添加新用户，为用户属性文件指定不同的名称和位置。 

$ EAP_HOME/bin/add-user.sh -u 'mgmtuser2' -p 'password1!' -sc '/path/to/standaloneconfig/' -dc '/path/to/domainconfig/' -up 'newname.properties'

新用户已添加到位于 /path/to /standaloneconfig/newname.properties 和 /path/to /domainconfig/newname.properties 的用户属性文件中。请注意，这些文件必须已经存在，否则您将看到错误。

有关所有可用 add-user 参数及其目的的完整列表，请使用 --help 参数或参阅 Add-User 实用程序参数 部分。