이벤트 관리 MID 웹 서버 확장 양식

  • 릴리스 버전: Yokohama
  • 업데이트 날짜 2025년 01월 30일
  • 읽기3분
  • MID 웹 서버 확장자를 만들거나 수정하기 위한 양식의 필드입니다.

    표 1. MID 웹 서버 컨텍스트 양식
    필드 설명
    이름 확장을 쉽게 식별할 수 있는 고유한 이름입니다.
    짧은 설명 확장에 대한 간략하고 의미 있는 설명입니다.
    상태 이 필드에는 확장의 상태가 자동으로 채워집니다. 이 필드는 확장이 시작되기 전에는 비어있게 됩니다. 확장에 대한 명령을 실행하면 다음 값 중 하나가 표시됩니다.
    • 시작됨: 확장이 실행 중입니다.
    • 중지됨: 확장이 실행되고 있지 않습니다.
    • 오프라인: MID 서버가 다운되었습니다.
    • 오류: 확장에 오류가 발생하여 실패했습니다. 오류 메시지가 오류 메시지 필드에 표시됩니다.
    • 경고: 런타임 예외가 발생했습니다. 확장은 계속 작동합니다.
    HTTP/HTTPS 포트 수신 요청에 대해 확장이 수신하는 포트 번호입니다.
    인증 유형 사용 가능한 인증 유형은 다음과 같습니다.
    • API 키 (기본값): 확장에 연결하는 클라이언트는 API 키를 요청의 인증 헤더에 입력해야 합니다. 기존 API 키 보기에 대한 자세한 내용은 MID 웹 서버 API 키 인증 구성 문서를 참조하십시오.
    • 키 기반 (Yokohama 릴리스 이전의 릴리스와의 호환성에서만 사용되지 않으며 유지됨): 비밀 키 필드의 값은 수신 클라이언트 요청의 인증 헤더에서 보낸 인증 토큰을 생성하는 데 사용됩니다. 자세한 내용은 키 기반 MID 웹 서버 인증 구성 문서를 참조하십시오.
    • 기본: 이 옵션을 선택할 때 나타나는 기본 인증 사용자기본 인증 사용자 암호 필드에 사용자 이름과 암호를 정의합니다.
    • mTLS: TLS 프로토콜을 사용하는 인증서 기반 인증입니다. 자세한 내용은 MID 웹 서버 및 에이전트 mTLS 인증 문서를 참조하십시오.
    비밀 키 인증 유형 필드에 대해 키 기반 인증을 선택한 경우 생성되는 값입니다.
    기본 인증 사용자 기본 인증을 선택할 때 사용할 사용자 이름입니다.
    기본 인증 사용자 암호 기본 인증을 선택할 때 사용할 암호입니다.
    보안 연결 확장이 TLS 프로토콜을 사용하여 수신 연결을 암호화하는 것임을 나타내는 옵션입니다. 확장에 인증서와 개인 키 조합도 제공해야 합니다. 이 옵션을 선택하면 MID 서버 통합 키 저장소 확인란이 나타납니다.
    MID 통합 키 저장소 사용 Secure connection에 MID 서버 통합 키 저장소 옵션을 사용하는 옵션입니다.

    웹 서버 키 저장소를 사용하려면 이 옵션을 선택 취소합니다.

    자세한 내용은 보안 MID 웹 서버 확장 구성 문서를 참조하십시오.

    키 저장소 인증서 별칭 확장에서 보안 연결을 설정하는 데 사용하는 선택한 키 저장소 내부의 키 쌍의 별칭 이름입니다.

    MID 통합 키 저장소를 사용하거나 단일 별칭으로 웹 서버 키 저장소를 사용할 때 기본 별칭을 사용하려면 이 필드를 비워 둡니다.

    키 저장소 암호 보안 연결을 설정하는 데 사용되는 웹 서버 키 저장소의 암호입니다.
    키 저장소 키 암호 웹 서버 키 저장소의 지정된 별칭에 매핑된 개인 키 항목의 암호입니다. 암호가 키 저장소 암호 필드의 항목과 일치하면 이 필드를 비워둘 수 있습니다.
    신뢰 저장소 암호 클라이언트 인증의 서명을 확인하는 데 사용되는 CA(인증 기관) 인증서를 보관하는 신뢰 저장소의 암호입니다. mTLS 인증 유형을 선택하면 나타납니다.

    확장이 MID 서버가 실행 중인 JRE의 cacerts 신뢰 저장소를 사용하도록 구성된 경우 이 필드를 비워 둡니다.

    오류 메시지 시작 또는 중지 같은 명령이 실패하게 된 오류에 대해 설명하는 메시지입니다. 이 필드는 상태 필드의 값이 오류인 경우에만 나타납니다.
    다음에서 실행 이 확장을 실행할 위치입니다. 사용 가능한 옵션은 특정 MID 서버특정 MID 서버 클러스터입니다.
    MID 서버 다음에서 실행 필드의 선택 항목에 따라 지정된 MID 서버 또는 MID 서버 클러스터의 이름입니다.
    • 특정 MID 서버를 선택한 경우에는 지정된 MID 서버의 이름입니다.
    • 특정 MID 서버 클러스터를 선택한 경우에는 지정된 MID 서버 클러스터의 이름입니다.
    다음에서 실행 중 MID 서버가 중단된 경우에도 확장이 실행되고 있는 MID 서버의 이름을 표시합니다. 사용자가 확장을 중지하면 이 필드는 비어있게 됩니다.