3.4. 관리 API

• JBoss EAP는 요청 경로에 대해 구성된 접두사와 일치하여 custom-constant HTTP 헤더를 적용합니다.

  예를 들어 custom-constant HTTP 헤더를 / 또는 /management 와 같은 요청 경로의 요청에 매핑할 수 있습니다.

• 요청이 여러 접두사와 일치하는 경우 JBoss EAP는 모든 매핑의 custom-constant HTTP 헤더를 적용합니다.

  예를 들어 경로 /management 에 대한 요청은 / 및 / management 모두에 대한 매핑과 일치합니다. JBoss EAP는 두 매핑의 헤더를 적용합니다.

• 요청이 끝나면 응답이 클라이언트로 반환되기 전에 해당 끝점에 의해 설정된 헤더를 덮어씁니다.

  예를 들어 관리 끝점은 각 응답에서 X-Frame-Options 헤더를 설정합니다. 이름이 X-Frame-Options 인 custom-constant HTTP 헤더를 정의하면 custom-constant HTTP 헤더가 기본 헤더를 덮어씁니다.

• custom-constant HTTP 헤더는 RFC-7231 - Hypertext Transfer Protocol (HTTP/1.1): Semantics 및 Content에서 지원되는 문자만 포함할 수 있습니다.

• 다음과 같이 사전 정의된 HTTP 헤더를 덮어쓸 수 없습니다.

  • 연결
  • 콘텐츠 길이
  • content-Type
  • 날짜

  • transfer-Encoding

    이러한 사전 정의된 헤더를 재정의하려고 하면 오류가 발생합니다.

  • 예를 들어 이름이 Date 인 custom-constant HTTP 헤더를 설정하려고 하면 다음 오류가 반환됩니다.

    {
        "outcome" => "failed",
        "failure-description" => "WFLYCTL0458:Disallowed HTTP Header name 'Date'",
        "rolled-back" => true
    }

• JBoss EAP는 지정된 경로에 연결할 수 있는지 여부를 확인하지 않습니다.
• 하위 시스템은 HTTP 관리 인터페이스에서 지원하는 컨텍스트를 동적으로 추가할 수 있습니다.
• custom-constant HTTP 헤더는 끝점이 요청에 대한 응답을 처리하는 방법을 변경하지 않습니다.

추가 리소스

• 하이퍼텍스트 전송 프로토콜 (HTTP/1.1):Semantics 및 Content
• custom-constant HTTP 헤더 정의
• 사용자 정의 상수 HTTP 헤더를 정의하는 CLI 명령

검증 단계

• HTTP 관리 인터페이스로 요청을 보냅니다.

  curl -s -D - -o /dev/null --digest http://localhost:9990/management/ -u USERNAME:PASSWORD

  예제 custom-constant HTTP 헤더 X-Help에 대한 샘플 응답

  admin:redhat
  HTTP/1.1 200 OK
  Connection: keep-alive
  X-Frame-Options: SAMEORIGIN
  Content-Type: application/json; charset=utf-8
  Content-Length: 3312
  X-Help: http://mywebsite.com
  Date: Tue, 27 Oct 2020 08:13:17 GMT

  응답에는 X-Help custom-constant HTTP 헤더가 포함됩니다.

추가 리소스

• custom-constant 헤더
• 사용자 정의 상수 HTTP 헤더를 정의하는 CLI 명령

독립 실행형 모드

• 단일 custom-constant HTTP 헤더를 정의하려면 다음 명령을 사용합니다.

  /core-service=management/management-interface=http-interface:write-attribute(name=constant-headers,value=[{path=/PREFIX,headers=[{name=X-HEADER,value=HEADERVALUE}]}])

  이 명령을 실행하면 다음과 같은 XML 구성이 생성됩니다.

  <management-interfaces>
      <http-interface http-authentication-factory="management-http-authentication">
          <http-upgrade enabled="true" sasl-authentication-factory="management-sasl-authentication/>
          <socket-binding http="management-http"/>
          <constant-headers>
              <header-mapping path="/PREFIX">
                  <header name="X-HEADER" value="HEADERVALUE"/>
              </header-mapping>
          </constant-headers>
      </http-interface>
  </management-interfaces>

• 여러 custom-constant HTTP 헤더를 정의하려면 다음 명령을 사용합니다.

  /core-service=management/management-interface=http-interface:write-attribute(name=constant-headers,value=[{path=/PREFIX1,headers=[{name=X-HEADER,value=HEADERVALUE-FOR-X}]},{path=/PREFIX2,headers=[{name=Y-HEADER,value=HEADERVALUE-FOR-Y}]}])

도메인 모드

• 단일 custom-constant HTTP 헤더를 정의하려면 다음 명령을 사용합니다.

  /host=primary/core-service=management/management-interface=http-interface:write-attribute(name=constant-headers,value=[{path=/PREFIX,headers=[{name=X-HEADER,value=HEADER-VALUE}]}])

  이 명령을 실행하면 다음과 같은 XML 구성이 생성됩니다.

  <management-interfaces>
      <http-interface http-authentication-factory="management-http-authentication">
          <http-upgrade enabled="true" sasl-authentication-factory="management-sasl-authentication/>
          <socket interface="management" port="${jboss.management.http.port:9990}"/>
          <constant-headers>
              <header-mapping path="/PREFIX">
                  <header name="X-HEADER" value="HEADER-VALUE"/>
              </header-mapping>
          </constant-headers>
      </http-interface>
  </management-interfaces>

• 여러 custom-constant HTTP 헤더를 정의하려면 다음 명령을 사용합니다.

  /host=primary/core-service=management/management-interface=http-interface:write-attribute(name=constant-headers,value=[ {path=/PREFIX-1,headers=[{name=X-HEADER,value=HEADER-VALUE-FOR-X}]},{path=/PREFIX-2,headers=[{name=Y-HEADER,value=HEADER-VALUE-FOR-Y}]}])

추가 리소스

• custom-constant 헤더
• custom-constant HTTP 헤더 정의