ID 저장소를 사용하여 애플리케이션 및 관리 인터페이스 보안

프로세스

1. Elytron에서 암호화된 파일 시스템-realm 을 만듭니다.

   구문

   /subsystem=elytron/filesystem-realm=<filesystem_realm_name>:add(path=<file_path>,credential-store=<name_of_credential_store>,secret-key=<key>)

   Copy to Clipboard Toggle word wrap

   예제

   /subsystem=elytron/filesystem-realm=exampleSecurityRealm:add(path=fs-realm-users,relative-to=jboss.server.config.dir, credential-store=examplePropertiesCredentialStore, secret-key=key)
   {"outcome" => "success"}

   Copy to Clipboard Toggle word wrap

2. 사용자를 영역에 추가하고 사용자 역할을 구성합니다.

   1. 사용자를 추가합니다.

      구문

      /subsystem=elytron/filesystem-realm=<filesystem_realm_name>:add-identity(identity=<user_name>)

      Copy to Clipboard Toggle word wrap

      예제

      /subsystem=elytron/filesystem-realm=exampleSecurityRealm:add-identity(identity=user1)
      {"outcome" => "success"}

      Copy to Clipboard Toggle word wrap

   2. 사용자의 암호를 설정합니다.

      구문

      /subsystem=elytron/filesystem-realm=<filesystem_realm_name>:set-password(identity=<user_name>, clear={password=<password>})

      Copy to Clipboard Toggle word wrap

      예제

      /subsystem=elytron/filesystem-realm=exampleSecurityRealm:set-password(identity=user1, clear={password="passwordUser1"})
      {"outcome" => "success"}

      Copy to Clipboard Toggle word wrap

   3. 사용자의 역할을 설정합니다.

      구문

      /subsystem=elytron/filesystem-realm=<filesystem_realm_name>:add-identity-attribute(identity=<user_name>, name=<roles_attribute_name>, value=[<role_1>,<role_N>])

      Copy to Clipboard Toggle word wrap

      예제

      /subsystem=elytron/filesystem-realm=exampleSecurityRealm:add-identity-attribute(identity=user1, name=Roles, value=["Admin","Guest"])
      {"outcome" => "success"}

      Copy to Clipboard Toggle word wrap

3. filesystem-realm 을 참조하는 보안 도메인을 생성합니다.

   구문

   /subsystem=elytron/security-domain=<security_domain_name>:add(default-realm=<filesystem_realm_name>,permission-mapper=default-permission-mapper,realms=[{realm=<filesystem_realm_name>,role-decoder="<role_decoder_name>"}])

   Copy to Clipboard Toggle word wrap

   예제

   /subsystem=elytron/security-domain=exampleSecurityDomain:add(default-realm=exampleSecurityRealm,permission-mapper=default-permission-mapper,realms=[{realm=exampleSecurityRealm}])
   {"outcome" => "success"}

   Copy to Clipboard Toggle word wrap

프로세스

1. 키 저장소를 생성합니다.

   구문

   /subsystem=elytron/key-store=<key_store_name>:add(path=<path_to_key_store_file>,credential-reference={<password>})

   Copy to Clipboard Toggle word wrap

   예제

   /subsystem=elytron/key-store=exampleKeystore:add(path=keystore, relative-to=jboss.server.config.dir, type=JKS, credential-reference={clear-text=secret})
   {"outcome" => "success"}

   Copy to Clipboard Toggle word wrap

2. 키 저장소에 키 쌍을 만듭니다.

   구문

   /subsystem=elytron/key-store=<key_store_name>:generate-key-pair(alias=<alias>,algorithm=<key_algorithm>,key-size=<size_of_key>,validity=<validity_in_days>,distinguished-name="<distinguished_name>")

   Copy to Clipboard Toggle word wrap

   예제

   /subsystem=elytron/key-store=exampleKeystore:generate-key-pair(alias=localhost,algorithm=RSA,key-size=1024,validity=365,distinguished-name="CN=localhost")
   {"outcome" => "success"}

   Copy to Clipboard Toggle word wrap

3. 키 저장소 파일에 키 쌍을 저장합니다.

   구문

   /subsystem=elytron/key-store=<key_store_name>:store()

   Copy to Clipboard Toggle word wrap

   예제

   /subsystem=elytron/key-store=exampleKeystore:store()
   {
       "outcome" => "success",
       "result" => undefined
   }

   Copy to Clipboard Toggle word wrap

프로세스

1. Elytron에서 filesystem-realm 을 만듭니다.

   구문

   /subsystem=elytron/filesystem-realm=<filesystem_realm_name>:add(path=<file_path>,key-store=<key_store_name>,key-store-alias=<key_store_alias>)

   Copy to Clipboard Toggle word wrap

   예제

   /subsystem=elytron/filesystem-realm=exampleSecurityRealm:add(path=fs-realm-users,relative-to=jboss.server.config.dir, key-store=exampleKeystore, key-store-alias=localhost)
   {"outcome" => "success"}

   Copy to Clipboard Toggle word wrap

2. 사용자를 영역에 추가하고 사용자 역할을 구성합니다.

   1. 사용자를 추가합니다.

      구문

      /subsystem=elytron/filesystem-realm=<filesystem_realm_name>:add-identity(identity=<user_name>)

      Copy to Clipboard Toggle word wrap

      예제

      /subsystem=elytron/filesystem-realm=exampleSecurityRealm:add-identity(identity=user1)
      {"outcome" => "success"}

      Copy to Clipboard Toggle word wrap

   2. 사용자의 암호를 설정합니다.

      구문

      /subsystem=elytron/filesystem-realm=<filesystem_realm_name>:set-password(identity=<user_name>, clear={password=<password>})

      Copy to Clipboard Toggle word wrap

      예제

      /subsystem=elytron/filesystem-realm=exampleSecurityRealm:set-password(identity=user1, clear={password="passwordUser1"})
      {"outcome" => "success"}

      Copy to Clipboard Toggle word wrap

   3. 사용자의 역할을 설정합니다.

      구문

      /subsystem=elytron/filesystem-realm=<filesystem_realm_name>:add-identity-attribute(identity=<user_name>, name=<roles_attribute_name>, value=[<role_1>,<role_N>])

      Copy to Clipboard Toggle word wrap

      예제

      /subsystem=elytron/filesystem-realm=exampleSecurityRealm:add-identity-attribute(identity=user1, name=Roles, value=["Admin","Guest"])
      {"outcome" => "success"}

      Copy to Clipboard Toggle word wrap

3. filesystem-realm 을 참조하는 보안 도메인을 생성합니다.

   구문

   /subsystem=elytron/security-domain=<security_domain_name>:add(default-realm=<filesystem_realm_name>,permission-mapper=default-permission-mapper,realms=[{realm=<filesystem_realm_name>,role-decoder="<role_decoder_name>"}])

   Copy to Clipboard Toggle word wrap

   예제

   /subsystem=elytron/security-domain=exampleSecurityDomain:add(default-realm=exampleSecurityRealm,permission-mapper=default-permission-mapper,realms=[{realm=exampleSecurityRealm}])
   {"outcome" => "success"}

   Copy to Clipboard Toggle word wrap

프로세스

1. 기존 키 저장소에 키 쌍을 만듭니다.

   구문

   /subsystem=elytron/key-store=<key_store_name>:generate-key-pair(alias=<alias>,algorithm=<key_algorithm>,key-size=<size_of_key>,validity=<validity_in_days>,distinguished-name="<distinguished_name>")

   Copy to Clipboard Toggle word wrap

   예제

   /subsystem=elytron/key-store=exampleKeystore:generate-key-pair(alias=localhost2,algorithm=RSA,key-size=1024,validity=365,distinguished-name="CN=localhost")
   {"outcome" => "success"}

   Copy to Clipboard Toggle word wrap

2. 키 저장소 파일에 키 쌍을 저장합니다.

   구문

   /subsystem=elytron/key-store=<key_store_name>:store()

   Copy to Clipboard Toggle word wrap

   예제

   /subsystem=elytron/key-store=exampleKeystore:store()
   {
       "outcome" => "success",
       "result" => undefined
   }

   Copy to Clipboard Toggle word wrap

3. 키 저장소 별칭을 업데이트하여 새 키 쌍을 참조합니다.

   구문

   /subsystem=elytron/filesystem-realm=<filesystem_realm_name>:write-attribute(name=key-store-alias, value=<key_store_alias>)

   Copy to Clipboard Toggle word wrap

   예제

   /subsystem=elytron/filesystem-realm=exampleSecurityRealm:write-attribute(name=key-store-alias, value=localhost2)
   {
       "outcome" => "success",
       "response-headers" => {
           "operation-requires-reload" => true,
           "process-state" => "reload-required"
       }
   }

   Copy to Clipboard Toggle word wrap

4. 서버를 다시 로드합니다.

   reload

   Copy to Clipboard Toggle word wrap

5. 새 키 쌍을 사용하여 파일 시스템-realm 의 파일을 새 서명으로 업데이트합니다.

   구문

   /subsystem=elytron/filesystem-realm=<filesystem_realm_name>:update-key-pair()

   Copy to Clipboard Toggle word wrap

   예제

   /subsystem=elytron/filesystem-realm=exampleSecurityRealm:update-key-pair()
   {"outcome" => "success"}

   Copy to Clipboard Toggle word wrap

프로세스

1. 암호화되지 않은 파일 시스템-realm 을 암호화된 파일 시스템으로 변환합니다.

   구문

   $ JBOSS_HOME/bin/elytron-tool.sh filesystem-realm-encrypt --input-location <existing_filesystem_realm_name> --output-location JBOSS_HOME/standalone/configuration/<target_filesystem_realm_name> --credential-store <path_to_credential_store>/<credential_store>

   Copy to Clipboard Toggle word wrap

   예제

   $ JBOSS_HOME/bin/elytron-tool.sh filesystem-realm-encrypt --input-location JBOSS_HOME/standalone/configuration/fs-realm-users --output-location JBOSS_HOME/standalone/configuration/fs-realm-users-enc --credential-store JBOSS_HOME/standalone/configuration/examplePropertiesCredentialStore.cs
   
   Creating encrypted realm for: JBOSS_HOME/standalone/configuration/fs-realm-users
   Found credential store and alias, using pre-existing key

   Copy to Clipboard Toggle word wrap

   WildFly Elytron 명령 filesystem-realm-encrypt 는 --output-location 인수로 지정된 filesystem-realm 을 생성합니다. 또한 elytron 하위 시스템에 filesystem-realm 리소스를 추가하는 데 사용할 수 있는 filesystem-realm 의 루트에 CLI 스크립트를 생성합니다.

   작은 정보

   명령 실행에 대한 요약을 보려면 --summary 옵션을 사용합니다.

2. 생성된 CLI 스크립트를 사용하여 elytron 하위 시스템에 filesystem-realm 리소스를 추가합니다.

   Synax

   $ JBOSS_HOME/bin/jboss-cli.sh --connect --file=<target_filesystem_realm_directory>/<target_filesystem_realm_name>.cli

   Copy to Clipboard Toggle word wrap

   예제

   $ JBOSS_HOME/bin/jboss-cli.sh --connect --file=JBOSS_HOME/standalone/configuration/fs-realm-users-enc/encrypted-filesystem-realm.cli

   Copy to Clipboard Toggle word wrap

프로세스

1. 키 저장소를 생성합니다.

   구문

   /subsystem=elytron/key-store=<key_store_name>:add(path=<path_to_key_store_file>,credential-reference={<password>})

   Copy to Clipboard Toggle word wrap

   예제

   /subsystem=elytron/key-store=exampleKeystore:add(path=keystore, relative-to=jboss.server.config.dir, type=JKS, credential-reference={clear-text=secret})
   {"outcome" => "success"}

   Copy to Clipboard Toggle word wrap

2. 키 저장소에 키 쌍을 만듭니다.

   구문

   /subsystem=elytron/key-store=<key_store_name>:generate-key-pair(alias=<alias>,algorithm=<key_algorithm>,key-size=<size_of_key>,validity=<validity_in_days>,distinguished-name="<distinguished_name>")

   Copy to Clipboard Toggle word wrap

   예제

   /subsystem=elytron/key-store=exampleKeystore:generate-key-pair(alias=localhost,algorithm=RSA,key-size=1024,validity=365,distinguished-name="CN=localhost")
   {"outcome" => "success"}

   Copy to Clipboard Toggle word wrap

3. 키 저장소 파일에 키 쌍을 저장합니다.

   구문

   /subsystem=elytron/key-store=<key_store_name>:store()

   Copy to Clipboard Toggle word wrap

   예제

   /subsystem=elytron/key-store=exampleKeystore:store()
   {
       "outcome" => "success",
       "result" => undefined
   }

   Copy to Clipboard Toggle word wrap

프로세스

1. 기존 filesystem-realm 을 사용하고 키 쌍으로 서명하여 무결성이 지원되는 filesystem-realm 을 생성합니다.

   기존 filesystem-realm 에 무결성 지원을 추가하려면 다음 명령에서 --output-location 및 --realm-name 옵션을 생략합니다. --output-location 및 --realm-name 옵션을 지정하면 명령은 기존 옵션을 업데이트하지 않고 무결성 검사를 사용하여 새 파일 시스템-realm 을 생성합니다.

   구문

   $ JBOSS_HOME/bin/elytron-tool.sh filesystem-realm-integrity  --input-location <path_to_existing_filesystem_realm> --keystore <path_to_key_store_file> --password <keystore_password> --key-pair <key_pair_alias> --output-location <path_for_new_filesystem_realm> --realm-name <name_of_new_filesystem_realm>

   Copy to Clipboard Toggle word wrap

   예제

   $ JBOSS_HOME/bin/elytron-tool.sh filesystem-realm-integrity --input-location JBOSS_HOME/standalone/configuration/fs-realm-users/ --keystore JBOSS_HOME/standalone/configuration/keystore --password secret --key-pair localhost --output-location JBOSS_HOME/standalone/configuration/fs-realm-users --realm-name exampleRealmWithIntegrity

   Copy to Clipboard Toggle word wrap

   Exmaple 출력

   Creating filesystem realm with integrity verification for: JBOSS_HOME/standalone/configuration/fs-realm-users

   Copy to Clipboard Toggle word wrap

   WildFly Elytron 명령 filesystem-realm -integrity 는 --output-location 인수로 지정된 파일 시스템-realm을 생성합니다. 또한 elytron 하위 시스템에 filesystem-realm 리소스를 추가하는 데 사용할 수 있는 filesystem-realm 의 루트에 CLI 스크립트를 생성합니다.

   작은 정보

   명령 실행에 대한 요약을 보려면 --summary 옵션을 사용합니다.

2. 생성된 CLI 스크립트를 사용하여 elytron 하위 시스템에 filesystem-realm 리소스를 추가합니다.

   구문

   $ JBOSS_HOME/bin/jboss-cli.sh --connect --file=<target_filesystem_realm_directory>/<target_filesystem_realm_name>.cli

   Copy to Clipboard Toggle word wrap

   예제

   $ JBOSS_HOME/bin/jboss-cli.sh --connect --file=JBOSS_HOME/standalone/configuration/fs-realm-users/exampleRealmWithIntegrity.cli

   Copy to Clipboard Toggle word wrap

프로세스

1. mvn 명령을 사용하여 Maven 프로젝트를 설정합니다. 명령은 프로젝트에 대한 디렉터리 구조와 pom.xml 구성 파일을 생성합니다.

   구문

   $ mvn archetype:generate \
   -DgroupId=${group-to-which-your-application-belongs} \
   -DartifactId=${name-of-your-application} \
   -DarchetypeGroupId=org.apache.maven.archetypes \
   -DarchetypeArtifactId=maven-archetype-webapp \
   -DinteractiveMode=false

   Copy to Clipboard Toggle word wrap

   예제

   $ mvn archetype:generate \
   -DgroupId=com.example.app \
   -DartifactId=simple-webapp-example \
   -DarchetypeGroupId=org.apache.maven.archetypes \
   -DarchetypeArtifactId=maven-archetype-webapp \
   -DinteractiveMode=false

   Copy to Clipboard Toggle word wrap

2. 애플리케이션 루트 디렉터리로 이동합니다.

   구문

   $ cd <name-of-your-application>

   Copy to Clipboard Toggle word wrap

   예제

   $ cd simple-webapp-example

   Copy to Clipboard Toggle word wrap

3. 생성된 pom.xml 파일의 내용을 다음 텍스트로 바꿉니다.

   <?xml version="1.0" encoding="UTF-8"?>
   
   <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
     xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
     <modelVersion>4.0.0</modelVersion>
   
     <groupId>com.example.app</groupId>
     <artifactId>simple-webapp-example</artifactId>
     <version>1.0-SNAPSHOT</version>
     <packaging>war</packaging>
   
     <name>simple-webapp-example Maven Webapp</name>
     <!-- FIXME change it to the project's website -->
     <url>http://www.example.com</url>
   
       <properties>
           <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
           <maven.compiler.source>11</maven.compiler.source>
           <maven.compiler.target>11</maven.compiler.target>
           <version.maven.war.plugin>3.4.0</version.maven.war.plugin>
       </properties>
   
       <dependencies>
           <dependency>
               <groupId>jakarta.servlet</groupId>
               <artifactId>jakarta.servlet-api</artifactId>
               <version>6.0.0</version>
               <scope>provided</scope>
           </dependency>
       </dependencies>
   
       <build>
           <finalName>${project.artifactId}</finalName>
           <plugins>
               <plugin>
                   <groupId>org.apache.maven.plugins</groupId>
                   <artifactId>maven-war-plugin</artifactId>
                   <version>${version.maven.war.plugin}</version>
               </plugin>
               <plugin>
                   <groupId>org.wildfly.plugins</groupId>
                   <artifactId>wildfly-maven-plugin</artifactId>
                   <version>4.2.2.Final</version>
               </plugin>
           </plugins>
       </build>
   </project>

   Copy to Clipboard Toggle word wrap

프로세스

1. Java 파일을 저장할 디렉터리를 만듭니다.

   구문

   $ mkdir -p src/main/java/<path_based_on_artifactID>

   Copy to Clipboard Toggle word wrap

   예제

   $ mkdir -p src/main/java/com/example/app

   Copy to Clipboard Toggle word wrap

2. 새 디렉터리로 이동합니다.

   구문

   $ cd src/main/java/<path_based_on_artifactID>

   Copy to Clipboard Toggle word wrap

   예제

   $ cd src/main/java/com/example/app

   Copy to Clipboard Toggle word wrap

3. 다음 콘텐츠를 사용하여 SecuredServlet.java 파일을 생성합니다.

   package com.example.app;
   
   import java.io.IOException;
   import java.io.PrintWriter;
   import java.security.Principal;
   
   import jakarta.servlet.ServletException;
   import jakarta.servlet.annotation.WebServlet;
   import jakarta.servlet.http.HttpServlet;
   import jakarta.servlet.http.HttpServletRequest;
   import jakarta.servlet.http.HttpServletResponse;
   
   /**
    * A simple secured HTTP servlet. It returns the user name of obtained
    * from the logged-in user's Principal. If there is no logged-in user,
    * it returns the text "NO AUTHENTICATED USER".
    */
   
   @WebServlet("/secured")
   public class SecuredServlet extends HttpServlet {
   
       @Override
       protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
           try (PrintWriter writer = resp.getWriter()) {
               writer.println("<html>");
               writer.println("  <head><title>Secured Servlet</title></head>");
               writer.println("  <body>");
               writer.println("    <h1>Secured Servlet</h1>");
               writer.println("    <p>");
               writer.print(" Current Principal '");
               Principal user = req.getUserPrincipal();
               writer.print(user != null ? user.getName() : "NO AUTHENTICATED USER");
               writer.print("'");
               writer.println("    </p>");
               writer.println("  </body>");
               writer.println("</html>");
           }
       }
   
   }

   Copy to Clipboard Toggle word wrap

4. 애플리케이션 루트 디렉터리에서 다음 명령을 사용하여 애플리케이션을 컴파일합니다.

   $ mvn package
   ...
   [INFO] ------------------------------------------------------------------------
   [INFO] BUILD SUCCESS
   [INFO] ------------------------------------------------------------------------
   [INFO] Total time: 1.015 s
   [INFO] Finished at: 2022-04-28T17:48:53+05:30
   [INFO] ------------------------------------------------------------------------

   Copy to Clipboard Toggle word wrap

5. 애플리케이션을 배포합니다.

   $ mvn wildfly:deploy

   Copy to Clipboard Toggle word wrap