InfoGrab DocsInfoGrab Docs

정적 구성과 동적 구성 조정

요약

일부 동적 리소스는 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 라벨에 사용할 수 있는 값은 다음과 같습니다.

  • defaults
  • config-file
  • dynamic
  • terraform
  • kubernetes

Auth Service는 시작할 때 동적 구성 리소스의 필드에 대응하는 정적 구성 필드의 값을 조회합니다. 값이 있는 필드가 있으면 해당하는 동적 구성 리소스를 생성하여 백엔드에 저장합니다.

값이 없는 정적 구성 필드에 대해서는 백엔드에 해당하는 동적 구성 리소스가 있는지 확인합니다. 없으면 기본값과 teleport.dev/origin=defaults 라벨을 가진 리소스를 생성합니다.

Auth Service가 이미 정적 구성 파일에서 구성을 로드한 뒤에 동적 구성 리소스를 생성하려고 하면 Auth Service가 오류를 반환합니다.

동적 구성 리소스를 삭제하면 Auth Service는 해당 구성 필드를 기본값으로 복원하고 teleport.dev/origin=defaults 라벨을 추가합니다.

Tip

Teleport Cloud 배포는 구성 파일을 사용하지만, 운영자가 이를 수정할 수는 없습니다. Teleport Enterprise Cloud 사용자는 teleport.dev/origin=config-file 라벨이 붙은 구성 리소스를 볼 수 있습니다.

정적 구성과 동적 구성 조정

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 라벨에 사용할 수 있는 값은 다음과 같습니다.

  • defaults
  • config-file
  • dynamic
  • terraform
  • kubernetes

Auth Service는 시작할 때 동적 구성 리소스의 필드에 대응하는 정적 구성 필드의 값을 조회합니다. 값이 있는 필드가 있으면 해당하는 동적 구성 리소스를 생성하여 백엔드에 저장합니다.

값이 없는 정적 구성 필드에 대해서는 백엔드에 해당하는 동적 구성 리소스가 있는지 확인합니다. 없으면 기본값과 teleport.dev/origin=defaults 라벨을 가진 리소스를 생성합니다.

Auth Service가 이미 정적 구성 파일에서 구성을 로드한 뒤에 동적 구성 리소스를 생성하려고 하면 Auth Service가 오류를 반환합니다.

동적 구성 리소스를 삭제하면 Auth Service는 해당 구성 필드를 기본값으로 복원하고 teleport.dev/origin=defaults 라벨을 추가합니다.

Tip

Teleport Cloud 배포는 구성 파일을 사용하지만, 운영자가 이를 수정할 수는 없습니다. Teleport Enterprise Cloud 사용자는 teleport.dev/origin=config-file 라벨이 붙은 구성 리소스를 볼 수 있습니다.