정적 구성과 동적 구성 조정
Teleport v18.11요약
일부 동적 리소스는 Teleport 정적 구성 파일의 필드와 동일한 설정을 지정합니다. Teleport Enterprise Cloud는 정적 구성 파일을 운영자에게 노출하지 않지만, 일부 설정에는 정적 구성 파일을 사용합니다.
일부 동적 리소스는 Teleport 정적 구성 파일의 필드와 동일한 설정을 지정합니다. 이러한 필드에 대해 Teleport Auth Service는 시작할 때와 Teleport 리소스를 생성하거나 삭제할 때 정적 구성과 동적 구성을 조정합니다.
Teleport Enterprise Cloud는 정적 구성 파일을 운영자에게 노출하지 않지만, 일부 설정에는 정적 구성 파일을 사용합니다.
공유 구성 필드#
정적 구성 파일과 필드를 공유하는 동적 리소스는 다음과 같습니다.
session_recording_config#
| 동적 리소스 필드 | 정적 구성 필드 |
|---|---|
spec.mode |
auth_service.session_recording |
spec.proxy_checks_host_keys |
auth_service.proxy_checks_host_keys |
cluster_auth_preference#
| 동적 리소스 필드 | 정적 구성 필드 |
|---|---|
spec.type |
auth_service.authentication.type |
spec.second_factors |
auth_service.authentication.second_factors |
spec.connector_name |
auth_service.authentication.connector_name |
spec.disconnect_expired_cert |
auth_service.disconnect_expired_cert |
spec.allow_local_auth |
auth_service.authentication.local_auth |
spec.message_of_the_day |
auth_service.message_of_the_day |
spec.locking_mode |
auth_service.authentication.locking_mode |
spec.webauthn |
auth_service.authentication.webauthn |
spec.require_session_mfa |
auth_service.authentication.require_session_mfa |
spec.allow_passwordless |
auth_service.authentication.passwordless |
spec.device_trust |
auth_service.authentication.device_trust |
spec.idp |
proxy_service.idp |
spec.allow_headless |
auth_service.authentication.headless |
cluster_networking_config#
| 동적 리소스 필드 | 정적 구성 필드 |
|---|---|
spec.client_idle_timeout |
auth_service.client_idle_timeout |
spec.keep_alive_interval |
auth_service.keep_alive_interval |
spec.keep_alive_count_max |
auth_service.keep_alive_count_max |
spec.session_control_timeout |
auth_service.session_control_timeout |
spec.idle_timeout_message |
auth_service.client_idle_timeout_message |
spec.web_idle_timeout |
auth_service.web_idle_timeout |
spec.proxy_listener_mode |
auth_service.proxy_listener_mode |
spec.routing_strategy |
auth_service.routing_strategy |
spec.tunnel_strategy |
auth_service.tunnel_strategy |
spec.proxy_ping_interval |
auth_service.proxy_ping_interval |
spec.case_insensitive_routing |
auth_service.case_insensitive_routing |
ui_config#
| 동적 리소스 필드 | 정적 구성 필드 |
|---|---|
spec.scrollback_lines |
proxy_service.ui.scrollback_lines |
spec.show_resources |
proxy_service.ui.show_resources |
출처 라벨#
Teleport Auth Service는 구성 리소스에 teleport.dev/origin 라벨을 적용하여 해당 리소스가 정적 구성 파일, 동적 구성 리소스, 기본값 중 어디에서 비롯되었는지 나타냅니다.
teleport.dev/origin 라벨에 사용할 수 있는 값은 다음과 같습니다.
defaultsconfig-filedynamicterraformkubernetes
Auth Service는 시작할 때 동적 구성 리소스의 필드에 대응하는 정적 구성 필드의 값을 조회합니다. 값이 있는 필드가 있으면 해당하는 동적 구성 리소스를 생성하여 백엔드에 저장합니다.
값이 없는 정적 구성 필드에 대해서는 백엔드에 해당하는 동적 구성 리소스가 있는지 확인합니다. 없으면 기본값과 teleport.dev/origin=defaults 라벨을 가진 리소스를 생성합니다.
Auth Service가 이미 정적 구성 파일에서 구성을 로드한 뒤에 동적 구성 리소스를 생성하려고 하면 Auth Service가 오류를 반환합니다.
동적 구성 리소스를 삭제하면 Auth Service는 해당 구성 필드를 기본값으로 복원하고 teleport.dev/origin=defaults 라벨을 추가합니다.
Teleport Cloud 배포는 구성 파일을 사용하지만, 운영자가 이를 수정할 수는 없습니다. Teleport Enterprise Cloud 사용자는 teleport.dev/origin=config-file 라벨이 붙은 구성 리소스를 볼 수 있습니다.