8.14. 使用 CLI 脚本为可引导 JAR 启用 HTTP 身份验证

流程

1. 将以下内容添加到 pom.xml 文件的 <build> 元素 中。您必须指定任何 Maven 插件的最新版本，以及 org.jboss.eap:wildfly-galleon-pack Galleon 功能包的最新版本。例如：

   <plugins>
       <plugin>
            <groupId>org.wildfly.plugins</groupId>
            <artifactId>wildfly-jar-maven-plugin</artifactId>
            <version>${bootable.jar.maven.plugin.version}</version>
            <configuration>
                <feature-pack-location>org.jboss.eap:wildfly-galleon-pack:${jboss.xp.galleon.feature.pack.version}</feature-pack-location>
                <layers>
                      <layer>datasources-web-server</layer>
                </layers>
           </configuration>
           <executions>
               <execution>
                   <goals>
                       <goal>package</goal>
                    </goals>
               </execution>
           </executions>
       </plugin>
   </plugins>

   示例显示了包含 elytron 子系统的 datasources-web-server Galleon 层。

2. 更新 src/main/webapp/WEB-INF 目录中的 web.xml 文件。例如：

   <?xml version="1.0" encoding="UTF-8"?>
   
   <web-app version="4.0"
            xmlns="http://xmlns.jcp.org/xml/ns/javaee"
            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
            xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee  http://xmlns.jcp.org/xml/ns/javaee/web-app_4_0.xsd">
   
       <login-config>
           <auth-method>BASIC</auth-method>
           <realm-name>Example Realm</realm-name>
       </login-config>
   
   </web-app>

3. 创建用于存储 Java 文件的目录：

   $ mkdir -p APPLICATION_ROOT/src/main/java/com/example/authentication/

   其中 APPLICATION_ROOT 是 Maven 项目的根目录。

4. 创建包含以下内容的 Java 文件 TestServlet.java，并将文件保存到 APPLICATION_ROOT/src/main/java/com/example/authentication/ 目录中：

   package com.example.authentication;
   
   import javax.servlet.annotation.HttpMethodConstraint;
   import javax.servlet.annotation.ServletSecurity;
   import javax.servlet.annotation.WebServlet;
   import javax.servlet.http.HttpServlet;
   import javax.servlet.http.HttpServletRequest;
   import javax.servlet.http.HttpServletResponse;
   
   import java.io.IOException;
   import java.io.PrintWriter;
   
   @WebServlet(urlPatterns = "/hello")
   @ServletSecurity(httpMethodConstraints = { @HttpMethodConstraint(value = "GET", rolesAllowed = { "Users" }) })
   public class TestServlet extends HttpServlet {
   
       @Override
       protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws IOException {
           PrintWriter writer = resp.getWriter();
           writer.println("Hello " + req.getUserPrincipal().getName());
           writer.close();
       }
   
   }

5. 创建 CLI 脚本，如 authentication.cli，并将它保存在可引导 JAR 的可访问目录中，如 APPLICATION_ROOT/scripts 目录。该脚本必须包含以下命令：

   /subsystem=elytron/properties-realm=bootable-realm:add(users-properties={relative-to=jboss.server.config.dir, path=bootable-users.properties, plain-text=true}, groups-properties={relative-to=jboss.server.config.dir, path=bootable-groups.properties})
   /subsystem=elytron/security-domain=BootableDomain:add(default-realm=bootable-realm, permission-mapper=default-permission-mapper, realms=[{realm=bootable-realm, role-decoder=groups-to-roles}])
   
   /subsystem=undertow/application-security-domain=other:write-attribute(name=security-domain, value=BootableDomain)

6. 将以下配置提取添加到插件 <configuration> 元素中：

   <cli-sessions>
       <cli-session>
           <script-files>
               <script>scripts/authentication.cli</script>
           </script-files>
       </cli-session>
   </cli-sessions>

   本例显示了 authentication.cli CLI 脚本，该脚本会将默认 undertow 安全域配置为为服务器定义的安全域。

7. 在 Maven 项目的根目录中创建一个目录，以存储 JBoss EAP JAR Maven 插件添加到可引导 JAR 的属性文件：

   $ mkdir -p APPLICATION_ROOT/extra-content/standalone/configuration/

   其中 APPLICATION_ROOT 是含有应用的 pom.xml 配置文件的目录。

   此目录存储 可引导用户.properties 和可 引导组.properties 文件等文件。

   bootable-users.properties 文件包含以下内容：

   testuser=bootable_password

   bootable-groups.properties 文件包含以下内容：

   testuser=Users

8. 将以下 extra-content-content-dirs 元素添加到现有的 <configuration> 元素中：

   <extra-server-content-dirs>
               <extra-content>extra-content</extra-content>
   </extra-server-content-dirs>

   extra-content 目录包含属性文件。

9. 将应用打包为可引导 JAR。

   $ mvn package

10. 启动应用程序：

    mvn wildfly-jar:run

11. 调用 servlet，但不要指定凭证：

    curl -v http://localhost:8080/hello

    预期输出：

    HTTP/1.1 401 Unauthorized
    ...
    WWW-Authenticate: Basic realm="Example Realm"

12. 调用服务器并指定您的凭据。例如：

    $ curl -v -u testuser:bootable_password http://localhost:8080/hello

    返回 HTTP 200 状态，表示已为您的可引导 JAR 启用了 HTTP 身份验证。例如：

    HTTP/1.1 200 OK
    ....
    Hello testuser