InfoGrab DocsInfoGrab Docs

Event Handler 플러그인 레퍼런스

요약

Event Handler 플러그인은 Teleport 감사 이벤트를 Fluentd 서비스로 내보냅니다. Event Handler로 Teleport 감사 이벤트를 내보내는 방법에 대한 자세한 내용은 감사 이벤트 내보내기 가이드 를 참조합니다.

Event Handler 플러그인은 Teleport 감사 이벤트를 Fluentd 서비스로 내보냅니다. 플러그인은 설정 가능한 배치 단위로 이벤트를 가져와 각 이벤트를 mTLS를 통해 Fluentd로 전달하고, 성공적으로 전송된 각 이벤트의 ID를 로컬 스토리지에 저장합니다. 플러그인이 중단되거나 재시작되면 마지막으로 확인된 이벤트부터 다시 시작합니다. 기본적으로 플러그인은 10초마다 새 이벤트를 폴링합니다.

Event Handler로 Teleport 감사 이벤트를 내보내는 방법에 대한 자세한 내용은 감사 이벤트 내보내기 가이드 를 참조합니다.

구성 방법#

Event Handler 플러그인은 세 가지 소스에서 구성을 받습니다.

  • 명령줄 인수.
  • FDFWD_ 접두사가 붙은 환경 변수.
  • --config 플래그로 지정한 TOML 구성 파일.
storage = "./storage" # Plugin will save its state here
timeout = "10s"
batch = 20

[forward.fluentd]
ca = "/home/bob/event-handler/ca.crt"
cert = "/home/bob/event-handler/client.crt"
key = "/home/bob/event-handler/client.key"
url = "https://fluentd.example.com:8888/test.log"
# The Event Handler appends `.<session-id>.log` to `session-url` when sending
# session recording events. For example, if `session-url` is
# `https://fluentd.example.com:8888/session`, the actual requests are sent to
# paths like `/session.<session-id>.log`. Ensure that your log collector's
# tag matching or routing rules account for this suffix (e.g., use `session.*`
# as a match pattern in Fluentd or Fluent Bit).
session-url = "https://fluentd.example.com:8888/session"

[teleport]
addr = "localhost:3025"
identity = "path/identity-file"
refresh.enabled = true
refresh.interval = "2m"

--dry-run 인수를 사용하면 Fluentd에 연결하지 않고 이벤트 내보내기를 시뮬레이션합니다. --exit-on-last-event를 사용하면 마지막 이벤트를 처리한 후 서비스를 종료합니다. --skip-session-types의 기본값은 ['print', 'desktop.recording']입니다.

이러한 이벤트의 전달을 활성화하면(--skip-session-types='') 녹화된 데이터도 함께 전송됩니다.

Teleport 연결 설정#

CLI 인수 환경 변수 설명
--teleport-addr FDFWD_TELEPORT_ADDR Teleport Auth 서비스 또는 프록시 서비스의 호스트와 포트.
--teleport-ca FDFWD_TELEPORT_CA Teleport TLS CA 인증서 파일의 경로.
--teleport-cert FDFWD_TELEPORT_CERT Teleport TLS 인증서 파일의 경로.
--teleport-key FDFWD_TELEPORT_KEY Teleport TLS 개인 키 파일의 경로.
--teleport-identity FDFWD_TELEPORT_IDENTITY Teleport 아이덴티티 파일의 경로.
--teleport-refresh-enabled FDFWD_TELEPORT_REFRESH_ENABLED 일정 간격으로 디스크에서 아이덴티티 파일을 다시 로드.
--teleport-refresh-interval FDFWD_TELEPORT_REFRESH_INTERVAL 아이덴티티 파일을 다시 로드하는 주기.

Fluentd 연결 설정#

CLI 인수 환경 변수 설명
--fluentd-url FDFWD_FLUENTD_URL 감사 이벤트를 전달할 Fluentd URL.
--fluentd-session-url FDFWD_FLUENTD_SESSION_URL 세션 이벤트의 기본 URL. .<session-id>.log가 덧붙여집니다.
--fluentd-ca FDFWD_FLUENTD_CA Fluentd TLS CA 인증서 파일의 경로.
--fluentd-cert FDFWD_FLUENTD_CERT Fluentd TLS 클라이언트 인증서 파일의 경로.
--fluentd-key FDFWD_FLUENTD_KEY Fluentd TLS 클라이언트 개인 키 파일의 경로.
--fluentd-max-connections FDFWD_MAX_CONNECTIONS Fluentd에 대한 최대 동시 연결 수. 설정하지 않으면 기본값은 동시성 값의 두 배입니다.

이벤트 처리 설정#

CLI 인수 환경 변수 설명
--batch FDFWD_BATCH 배치당 가져올 이벤트 수.
--timeout FDFWD_TIMEOUT Teleport 이벤트 API 폴링의 타임아웃.
--types FDFWD_TYPES 전달할 이벤트 유형의 쉼표로 구분된 목록. 설정하지 않으면 모든 이벤트 유형을 전달합니다. 와일드카드(예: *)는 사용할 수 없으며, 정확한 유형 이름만 일치합니다.
--skip-session-types FDFWD_SKIP_SESSION_TYPES 건너뛸 세션 이벤트 유형의 쉼표로 구분된 목록.
--skip-event-types FDFWD_SKIP_EVENT_TYPES 건너뛸 감사 로그 이벤트 유형의 쉼표로 구분된 목록(예: user.login, access_request.create).
--start-time FDFWD_START_TIME RFC 3339 형식의 최소 이벤트 시간.
--concurrency FDFWD_CONCURRENCY 동시 세션 수.
--window-size FDFWD_WINDOW_SIZE 이벤트를 처리할 윈도 크기.
--storage FDFWD_STORAGE 이벤트 처리 상태를 저장할 디렉터리.

운영 설정#

CLI 인수 환경 변수 설명
--debug FDFWD_DEBUG 디버그 수준 로깅을 활성화.
--dry-run FDFWD_DRY_RUN Fluentd에 연결하지 않고 실행을 시뮬레이션. 구성을 테스트할 때 유용합니다.
--exit-on-last-event FDFWD_EXIT_ON_LAST_EVENT 마지막 이벤트를 처리하면 종료.

사용자 자동 잠금 설정#

Event Handler 플러그인은 인증 시도가 반복해서 실패하면 Teleport 사용자를 자동으로 잠글 수 있습니다.

CLI 인수 환경 변수 설명
--lock-enabled FDFWD_LOCKING_ENABLED 로그인 시도가 반복해서 실패하면 사용자를 자동으로 잠그도록 활성화.
--lock-failed-attempts-count FDFWD_LOCKING_FAILED_ATTEMPTS 잠금을 발생시키는 인증 실패 횟수.
--lock-period FDFWD_LOCKING_PERIOD 인증 실패 횟수를 집계하는 시간 범위.
--lock-for FDFWD_LOCKING_FOR 사용자가 잠긴 상태로 유지되는 기간.

예를 들어 1m 안에 5번 실패하면 사용자를 30m 동안 잠그려면 다음과 같이 설정합니다.

lock-enabled = true
lock-failed-attempts-count = 5
lock-period = "1m"
lock-for = "30m"

mTLS 인증서 생성#

Event Handler 플러그인은 플러그인과 Fluentd 간에 mTLS가 필요합니다. 서버 키 암호화를 권장합니다. 클라이언트 키 암호화는 지원되지 않습니다.

OpenSSL 구성#

다음 구조로 ssl.conf 파일을 생성합니다. [server_cert] 섹션은 Fluentd 서버의 호스트 이름과 IP 주소에 맞게 조정합니다.

[req]
default_bits       = 4096
default_md         = sha256
prompt             = no
distinguished_name = req_distinguished_name

[req_distinguished_name]
CN = localhost

[v3_ca]
basicConstraints     = critical,CA:TRUE
keyUsage             = critical,keyCertSign,cRLSign
subjectKeyIdentifier = hash

[client_cert]
basicConstraints     = CA:FALSE
keyUsage             = critical,digitalSignature
extendedKeyUsage     = clientAuth

[server_cert]
basicConstraints     = CA:FALSE
keyUsage             = critical,digitalSignature
extendedKeyUsage     = serverAuth
subjectAltName       = DNS:localhost,IP:127.0.0.1

[crl_ext]
authorityKeyIdentifier = keyid:always

[ocsp]
basicConstraints     = CA:FALSE
keyUsage             = critical,digitalSignature
extendedKeyUsage     = critical,OCSPSigning

인증 기관 생성#

openssl genrsa -out ca.key 4096
chmod 444 ca.key
openssl req -config ssl.conf -key ca.key -new -x509 -days 7300 \
  -sha256 -extensions v3_ca -subj "/CN=ca" -out ca.crt

서버 인증서 생성#

openssl genrsa -aes256 -out server.key 4096
chmod 444 server.key
openssl req -config ssl.conf -subj "/CN=server" -key server.key \
  -new -out server.csr
openssl x509 -req -in server.csr -CA ca.crt -CAkey ca.key \
  -CAcreateserial -days 365 -out server.crt -extfile ssl.conf \
  -extensions server_cert

클라이언트 인증서 생성#

openssl genrsa -out client.key 4096
chmod 444 client.key
openssl req -config ssl.conf -subj "/CN=client" -key client.key \
  -new -out client.csr
openssl x509 -req -in client.csr -CA ca.crt -CAkey ca.key \
  -CAcreateserial -days 365 -out client.crt -extfile ssl.conf \
  -extensions client_cert

또는 다음 명령을 실행하여 모든 인증서를 example/keys/ 디렉터리에 생성할 수 있습니다.

$ PASS=12345678 KEYLEN=4096 make -C integrations/event-handler gen-example-mtls

추가 자료#

다음 관련 주제를 참조합니다.

Event Handler 플러그인 레퍼런스

Teleport v18.11
원문 보기

요약

Event Handler 플러그인은 Teleport 감사 이벤트를 Fluentd 서비스로 내보냅니다. Event Handler로 Teleport 감사 이벤트를 내보내는 방법에 대한 자세한 내용은 감사 이벤트 내보내기 가이드 를 참조합니다.

Event Handler 플러그인은 Teleport 감사 이벤트를 Fluentd 서비스로 내보냅니다. 플러그인은 설정 가능한 배치 단위로 이벤트를 가져와 각 이벤트를 mTLS를 통해 Fluentd로 전달하고, 성공적으로 전송된 각 이벤트의 ID를 로컬 스토리지에 저장합니다. 플러그인이 중단되거나 재시작되면 마지막으로 확인된 이벤트부터 다시 시작합니다. 기본적으로 플러그인은 10초마다 새 이벤트를 폴링합니다.

Event Handler로 Teleport 감사 이벤트를 내보내는 방법에 대한 자세한 내용은 감사 이벤트 내보내기 가이드 를 참조합니다.

구성 방법#

Event Handler 플러그인은 세 가지 소스에서 구성을 받습니다.

  • 명령줄 인수.
  • FDFWD_ 접두사가 붙은 환경 변수.
  • --config 플래그로 지정한 TOML 구성 파일.
storage = "./storage" # Plugin will save its state here
timeout = "10s"
batch = 20

[forward.fluentd]
ca = "/home/bob/event-handler/ca.crt"
cert = "/home/bob/event-handler/client.crt"
key = "/home/bob/event-handler/client.key"
url = "https://fluentd.example.com:8888/test.log"
# The Event Handler appends `.<session-id>.log` to `session-url` when sending
# session recording events. For example, if `session-url` is
# `https://fluentd.example.com:8888/session`, the actual requests are sent to
# paths like `/session.<session-id>.log`. Ensure that your log collector's
# tag matching or routing rules account for this suffix (e.g., use `session.*`
# as a match pattern in Fluentd or Fluent Bit).
session-url = "https://fluentd.example.com:8888/session"

[teleport]
addr = "localhost:3025"
identity = "path/identity-file"
refresh.enabled = true
refresh.interval = "2m"

--dry-run 인수를 사용하면 Fluentd에 연결하지 않고 이벤트 내보내기를 시뮬레이션합니다. --exit-on-last-event를 사용하면 마지막 이벤트를 처리한 후 서비스를 종료합니다. --skip-session-types의 기본값은 ['print', 'desktop.recording']입니다.

이러한 이벤트의 전달을 활성화하면(--skip-session-types='') 녹화된 데이터도 함께 전송됩니다.

Teleport 연결 설정#

CLI 인수 환경 변수 설명
--teleport-addr FDFWD_TELEPORT_ADDR Teleport Auth 서비스 또는 프록시 서비스의 호스트와 포트.
--teleport-ca FDFWD_TELEPORT_CA Teleport TLS CA 인증서 파일의 경로.
--teleport-cert FDFWD_TELEPORT_CERT Teleport TLS 인증서 파일의 경로.
--teleport-key FDFWD_TELEPORT_KEY Teleport TLS 개인 키 파일의 경로.
--teleport-identity FDFWD_TELEPORT_IDENTITY Teleport 아이덴티티 파일의 경로.
--teleport-refresh-enabled FDFWD_TELEPORT_REFRESH_ENABLED 일정 간격으로 디스크에서 아이덴티티 파일을 다시 로드.
--teleport-refresh-interval FDFWD_TELEPORT_REFRESH_INTERVAL 아이덴티티 파일을 다시 로드하는 주기.

Fluentd 연결 설정#

CLI 인수 환경 변수 설명
--fluentd-url FDFWD_FLUENTD_URL 감사 이벤트를 전달할 Fluentd URL.
--fluentd-session-url FDFWD_FLUENTD_SESSION_URL 세션 이벤트의 기본 URL. .<session-id>.log가 덧붙여집니다.
--fluentd-ca FDFWD_FLUENTD_CA Fluentd TLS CA 인증서 파일의 경로.
--fluentd-cert FDFWD_FLUENTD_CERT Fluentd TLS 클라이언트 인증서 파일의 경로.
--fluentd-key FDFWD_FLUENTD_KEY Fluentd TLS 클라이언트 개인 키 파일의 경로.
--fluentd-max-connections FDFWD_MAX_CONNECTIONS Fluentd에 대한 최대 동시 연결 수. 설정하지 않으면 기본값은 동시성 값의 두 배입니다.

이벤트 처리 설정#

CLI 인수 환경 변수 설명
--batch FDFWD_BATCH 배치당 가져올 이벤트 수.
--timeout FDFWD_TIMEOUT Teleport 이벤트 API 폴링의 타임아웃.
--types FDFWD_TYPES 전달할 이벤트 유형의 쉼표로 구분된 목록. 설정하지 않으면 모든 이벤트 유형을 전달합니다. 와일드카드(예: *)는 사용할 수 없으며, 정확한 유형 이름만 일치합니다.
--skip-session-types FDFWD_SKIP_SESSION_TYPES 건너뛸 세션 이벤트 유형의 쉼표로 구분된 목록.
--skip-event-types FDFWD_SKIP_EVENT_TYPES 건너뛸 감사 로그 이벤트 유형의 쉼표로 구분된 목록(예: user.login, access_request.create).
--start-time FDFWD_START_TIME RFC 3339 형식의 최소 이벤트 시간.
--concurrency FDFWD_CONCURRENCY 동시 세션 수.
--window-size FDFWD_WINDOW_SIZE 이벤트를 처리할 윈도 크기.
--storage FDFWD_STORAGE 이벤트 처리 상태를 저장할 디렉터리.

운영 설정#

CLI 인수 환경 변수 설명
--debug FDFWD_DEBUG 디버그 수준 로깅을 활성화.
--dry-run FDFWD_DRY_RUN Fluentd에 연결하지 않고 실행을 시뮬레이션. 구성을 테스트할 때 유용합니다.
--exit-on-last-event FDFWD_EXIT_ON_LAST_EVENT 마지막 이벤트를 처리하면 종료.

사용자 자동 잠금 설정#

Event Handler 플러그인은 인증 시도가 반복해서 실패하면 Teleport 사용자를 자동으로 잠글 수 있습니다.

CLI 인수 환경 변수 설명
--lock-enabled FDFWD_LOCKING_ENABLED 로그인 시도가 반복해서 실패하면 사용자를 자동으로 잠그도록 활성화.
--lock-failed-attempts-count FDFWD_LOCKING_FAILED_ATTEMPTS 잠금을 발생시키는 인증 실패 횟수.
--lock-period FDFWD_LOCKING_PERIOD 인증 실패 횟수를 집계하는 시간 범위.
--lock-for FDFWD_LOCKING_FOR 사용자가 잠긴 상태로 유지되는 기간.

예를 들어 1m 안에 5번 실패하면 사용자를 30m 동안 잠그려면 다음과 같이 설정합니다.

lock-enabled = true
lock-failed-attempts-count = 5
lock-period = "1m"
lock-for = "30m"

mTLS 인증서 생성#

Event Handler 플러그인은 플러그인과 Fluentd 간에 mTLS가 필요합니다. 서버 키 암호화를 권장합니다. 클라이언트 키 암호화는 지원되지 않습니다.

OpenSSL 구성#

다음 구조로 ssl.conf 파일을 생성합니다. [server_cert] 섹션은 Fluentd 서버의 호스트 이름과 IP 주소에 맞게 조정합니다.

[req]
default_bits       = 4096
default_md         = sha256
prompt             = no
distinguished_name = req_distinguished_name

[req_distinguished_name]
CN = localhost

[v3_ca]
basicConstraints     = critical,CA:TRUE
keyUsage             = critical,keyCertSign,cRLSign
subjectKeyIdentifier = hash

[client_cert]
basicConstraints     = CA:FALSE
keyUsage             = critical,digitalSignature
extendedKeyUsage     = clientAuth

[server_cert]
basicConstraints     = CA:FALSE
keyUsage             = critical,digitalSignature
extendedKeyUsage     = serverAuth
subjectAltName       = DNS:localhost,IP:127.0.0.1

[crl_ext]
authorityKeyIdentifier = keyid:always

[ocsp]
basicConstraints     = CA:FALSE
keyUsage             = critical,digitalSignature
extendedKeyUsage     = critical,OCSPSigning

인증 기관 생성#

openssl genrsa -out ca.key 4096
chmod 444 ca.key
openssl req -config ssl.conf -key ca.key -new -x509 -days 7300 \
  -sha256 -extensions v3_ca -subj "/CN=ca" -out ca.crt

서버 인증서 생성#

openssl genrsa -aes256 -out server.key 4096
chmod 444 server.key
openssl req -config ssl.conf -subj "/CN=server" -key server.key \
  -new -out server.csr
openssl x509 -req -in server.csr -CA ca.crt -CAkey ca.key \
  -CAcreateserial -days 365 -out server.crt -extfile ssl.conf \
  -extensions server_cert

클라이언트 인증서 생성#

openssl genrsa -out client.key 4096
chmod 444 client.key
openssl req -config ssl.conf -subj "/CN=client" -key client.key \
  -new -out client.csr
openssl x509 -req -in client.csr -CA ca.crt -CAkey ca.key \
  -CAcreateserial -days 365 -out client.crt -extfile ssl.conf \
  -extensions client_cert

또는 다음 명령을 실행하여 모든 인증서를 example/keys/ 디렉터리에 생성할 수 있습니다.

$ PASS=12345678 KEYLEN=4096 make -C integrations/event-handler gen-example-mtls

추가 자료#

다음 관련 주제를 참조합니다.