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
추가 자료#
다음 관련 주제를 참조합니다.