InfoGrab DocsInfoGrab Docs

teleport-discovery-azure Terraform 모듈 참조

요약

이 페이지는 teleport-discovery-azure Terraform 모듈의 입력 필드와 출력 값을 나열합니다. 이 Terraform 모듈은 Teleport 클러스터가 Azure VM과 AKS 클러스터를 검색하는 데 필요한 Azure 및 Teleport 클러스터 리소스를 생성합니다:

이 페이지는 teleport-discovery-azure Terraform 모듈의 입력 필드와 출력 값을 나열합니다.

Azure Discovery Terraform 모듈#

이 Terraform 모듈은 Teleport 클러스터가 Azure VM과 AKS 클러스터를 검색하는 데 필요한 Azure 및 Teleport 클러스터 리소스를 생성합니다:

  • Azure 사용자 할당 관리 ID(user-assigned managed identity): Teleport Discovery Service가 Azure API에 인증하여 일치하는 리소스 그룹의 Azure 리소스를 스캔하고 관리하는 데 사용합니다.
  • Azure 페더레이션 ID 자격 증명(federated identity credential): 관리 ID가 Teleport 프록시에서 발급한 OIDC 토큰으로 인증할 수 있도록 하여 Azure와 Teleport 클러스터 간의 신뢰를 설정합니다.
  • Azure 사용자 지정 역할 정의 및 할당: 관리 ID에 구독을 읽을 수 있는 권한과 포함된 각 리소스 유형에 필요한 API 권한을 부여합니다.
  • Teleport discovery_config 클러스터 리소스: 검색할 Azure 리소스를 결정하는 검색 매개변수(구독, 리소스 그룹, 태그)를 구성합니다.
  • Teleport integration 클러스터 리소스: Azure OIDC 연동 구성을 Teleport 클러스터에 저장하고, Azure 테넌트와 클라이언트 ID를 연결하여 인증을 가능하게 합니다.
  • Teleport token 클러스터 리소스: 검색된 Azure VM이 인증하고 Teleport 클러스터에 조인할 때 사용하는 조인 토큰을 제공합니다.

사전 요구사항#

예제#

도움 받는 방법#

문제가 발생하면 GitHub Discussions를 확인하십시오.

이 코드와 관련된 버그는 이슈를 등록해 주십시오.

요구사항#

Name Version
terraform >= 1.5.7
azurerm >= 4.0
http >= 3.0
random >= 3.0
teleport >= 18.7.6

공급자#

Name Version
azurerm >= 4.0
http >= 3.0
random >= 3.0
teleport >= 18.7.6

모듈#

모듈이 없습니다.

리소스#

Name Type
azurerm_federated_identity_credential.teleport_discovery_service resource
azurerm_role_assignment.teleport_discovery resource
azurerm_role_definition.teleport_discovery resource
azurerm_user_assigned_identity.teleport_discovery_service resource
random_id.suffix resource
teleport_discovery_config.azure resource
teleport_integration.azure_oidc resource
teleport_provision_token.azure resource
azurerm_client_config.this data source
http_http.teleport_ping data source

입력#

Name Description Type Default Required
apply_azure_tags 생성되는 모든 Azure 리소스에 적용할 추가 Azure 태그입니다. map(string) {} no
apply_teleport_resource_labels 생성되는 모든 Teleport 리소스에 적용할 추가 Teleport 리소스 라벨입니다. map(string) {} no
azure_federated_identity_credential_name 워크로드 아이덴티티 페더레이션을 위해 생성되는 Azure 페더레이션 ID 자격 증명의 이름입니다. string "teleport-federation" no
azure_managed_identity_location 관리 ID가 생성될 Azure 리전(위치)입니다(예: "eastus"). create_azure_managed_identity가 true일 때 필수입니다. string null no
azure_managed_identity_name Teleport Discovery용으로 생성되는 Azure 사용자 할당 관리 ID의 이름입니다. string "discovery-identity" no
azure_managed_identity_use_name_prefix azure_managed_identity_name을 이름 접두사로 사용할지(true) 정확한 이름으로 사용할지(false) 여부입니다. bool true no
azure_management_group_id 역할 할당 범위를 도출하는 데 사용하는 Azure 관리 그룹 또는 테넌트의 ID입니다. azure_role_assignment_scopes가 설정되어 있으면 효과가 없습니다. 둘 다 설정되지 않으면 구독 범위는 azure_matchers에서 도출됩니다. string null no
azure_matchers Azure 리소스 검색 매처입니다. azure_matchers.types에 사용할 수 있는 값은 vm과 aks입니다. azure_management_group_id 또는 azure_role_assignment_scopes가 설정된 경우 와일드카드('*') 구독 매처를 사용할 수 있습니다. list(object({ types = list(string) subscriptions = list(string) resource_groups = optional(list(string), ["*"]) regions = optional(list(string), ["*"]) tags = optional(map(list(string)), { "*" : ["*"] }) })) n/a yes
azure_resource_group_name Azure 리소스가 생성될 기존 Azure 리소스 그룹의 이름입니다. create_azure_managed_identity가 true일 때 필수입니다. string null no
azure_role_assignment_scopes Azure 검색 역할이 할당될 범위입니다. 기본적으로 범위는 azure_management_group_id에 설정된 관리 그룹 또는 azure_matchers에 구성된 구독에서 도출됩니다. list(string) [] no
azure_role_definition_name Teleport Discovery용으로 생성되는 Azure 사용자 지정 역할 정의의 이름입니다. string "teleport-discovery" no
azure_role_definition_use_name_prefix azure_role_definition_name을 이름 접두사로 사용할지(true) 정확한 이름으로 사용할지(false) 여부입니다. bool true no
create 모든 리소스의 생성 여부를 전환합니다. bool true no
create_azure_managed_identity Azure 관리 ID와 역할 리소스를 생성할지(true) 하지 않을지(false) 여부입니다. false이면 Azure 리소스가 생성되지 않습니다. use_oidc_integration이 true이면 반드시 true로 설정해야 합니다. bool true no
teleport_discovery_config_name teleport_discovery_config 리소스의 이름입니다. string "discovery" no
teleport_discovery_config_use_name_prefix teleport_discovery_config_name을 이름 접두사로 사용할지(true) 정확한 이름으로 사용할지(false) 여부입니다. bool true no
teleport_discovery_group_name 사용할 Teleport 검색 그룹입니다. 검색 구성이 적용되려면 이 이름이 하나 이상의 Teleport Discovery Service 인스턴스에 구성된 discovery_group과 일치해야 합니다. Teleport Cloud 클러스터에는 "cloud-discovery-group"을 사용합니다. string n/a yes
teleport_installer_script_name 사용할 기존 Teleport 설치 스크립트의 이름입니다. string "default-installer" no
teleport_integration_name teleport_integration 리소스의 이름입니다. string "discovery" no
teleport_integration_use_name_prefix teleport_integration_name을 이름 접두사로 사용할지(true) 정확한 이름으로 사용할지(false) 여부입니다. bool true no
teleport_provision_token_allow_rules Teleport 프로비저닝 토큰의 사용자 지정 허용 규칙입니다. 와일드카드(*) 구독 매처를 사용하고 create_azure_managed_identity가 true이면 기본값은 Azure 테넌트 ID를 사용하는 테넌트 기반 허용 규칙입니다. create_azure_managed_identity가 false이고 와일드카드 구독 매처를 사용하는 경우 필수입니다. VM을 등록할 때만 사용합니다. list(object({ subscription = optional(string) resource_groups = optional(list(string)) tenant = optional(string) })) null no
teleport_provision_token_name teleport_provision_token 리소스의 이름입니다. string "discovery" no
teleport_provision_token_use_name_prefix teleport_provision_token_name을 이름 접두사로 사용할지(true) 정확한 이름으로 사용할지(false) 여부입니다. bool true no
teleport_proxy_public_addr host:port 형식의 Teleport 클러스터 프록시 공개 주소입니다(URL 스킴 제외). string n/a yes
use_oidc_integration Azure OIDC 연동과 페더레이션 ID 자격 증명을 생성하여 Teleport 검색 구성에서 참조할지(true) 하지 않을지(false) 여부입니다. bool true no

출력#

Name Description
azure_discovery_role_definition Teleport Discovery Service용 Azure 역할 정의입니다.
azure_teleport_discovery_managed_identity Teleport Discovery Service용으로 생성된 관리 ID입니다.
teleport_discovery_config_name Teleport 동적 discovery_config의 이름입니다. 구성 세부 정보는 tctl get discovery_config/<name>으로 확인할 수 있습니다. Teleport Discovery Service 인스턴스는 discovery_config와 같은 검색 그룹에 속하면 이 discovery_config를 사용합니다.
teleport_integration_name Teleport integration 리소스의 이름입니다. integration 리소스는 Teleport Discovery Service 인스턴스가 Azure OIDC 페더레이션을 사용하여 검색용 Azure 관리 ID를 어슘하도록 구성합니다. 연동 세부 정보는 tctl get integrations/<name>으로 확인하거나 Teleport 웹 UI의 'Zero Trust Access' > 'Integrations'에서 확인할 수 있습니다.
teleport_provision_token_name Teleport 노드가 Azure 자격 증명을 사용하여 Teleport 클러스터에 조인할 수 있도록 하는 Teleport 프로비저닝 token의 이름입니다. VM을 등록할 때만 사용합니다. 토큰 세부 정보는 tctl get token/<name>으로 확인할 수 있습니다.

소스 코드#

GitHub에서 teleport-discovery-azure 모듈 소스 코드 보기.

teleport-discovery-azure Terraform 모듈 참조

Teleport v18.11
원문 보기

요약

이 페이지는 teleport-discovery-azure Terraform 모듈의 입력 필드와 출력 값을 나열합니다. 이 Terraform 모듈은 Teleport 클러스터가 Azure VM과 AKS 클러스터를 검색하는 데 필요한 Azure 및 Teleport 클러스터 리소스를 생성합니다:

이 페이지는 teleport-discovery-azure Terraform 모듈의 입력 필드와 출력 값을 나열합니다.

Azure Discovery Terraform 모듈#

이 Terraform 모듈은 Teleport 클러스터가 Azure VM과 AKS 클러스터를 검색하는 데 필요한 Azure 및 Teleport 클러스터 리소스를 생성합니다:

  • Azure 사용자 할당 관리 ID(user-assigned managed identity): Teleport Discovery Service가 Azure API에 인증하여 일치하는 리소스 그룹의 Azure 리소스를 스캔하고 관리하는 데 사용합니다.
  • Azure 페더레이션 ID 자격 증명(federated identity credential): 관리 ID가 Teleport 프록시에서 발급한 OIDC 토큰으로 인증할 수 있도록 하여 Azure와 Teleport 클러스터 간의 신뢰를 설정합니다.
  • Azure 사용자 지정 역할 정의 및 할당: 관리 ID에 구독을 읽을 수 있는 권한과 포함된 각 리소스 유형에 필요한 API 권한을 부여합니다.
  • Teleport discovery_config 클러스터 리소스: 검색할 Azure 리소스를 결정하는 검색 매개변수(구독, 리소스 그룹, 태그)를 구성합니다.
  • Teleport integration 클러스터 리소스: Azure OIDC 연동 구성을 Teleport 클러스터에 저장하고, Azure 테넌트와 클라이언트 ID를 연결하여 인증을 가능하게 합니다.
  • Teleport token 클러스터 리소스: 검색된 Azure VM이 인증하고 Teleport 클러스터에 조인할 때 사용하는 조인 토큰을 제공합니다.

사전 요구사항#

예제#

도움 받는 방법#

문제가 발생하면 GitHub Discussions를 확인하십시오.

이 코드와 관련된 버그는 이슈를 등록해 주십시오.

요구사항#

Name Version
terraform >= 1.5.7
azurerm >= 4.0
http >= 3.0
random >= 3.0
teleport >= 18.7.6

공급자#

Name Version
azurerm >= 4.0
http >= 3.0
random >= 3.0
teleport >= 18.7.6

모듈#

모듈이 없습니다.

리소스#

Name Type
azurerm_federated_identity_credential.teleport_discovery_service resource
azurerm_role_assignment.teleport_discovery resource
azurerm_role_definition.teleport_discovery resource
azurerm_user_assigned_identity.teleport_discovery_service resource
random_id.suffix resource
teleport_discovery_config.azure resource
teleport_integration.azure_oidc resource
teleport_provision_token.azure resource
azurerm_client_config.this data source
http_http.teleport_ping data source

입력#

Name Description Type Default Required
apply_azure_tags 생성되는 모든 Azure 리소스에 적용할 추가 Azure 태그입니다. map(string) {} no
apply_teleport_resource_labels 생성되는 모든 Teleport 리소스에 적용할 추가 Teleport 리소스 라벨입니다. map(string) {} no
azure_federated_identity_credential_name 워크로드 아이덴티티 페더레이션을 위해 생성되는 Azure 페더레이션 ID 자격 증명의 이름입니다. string "teleport-federation" no
azure_managed_identity_location 관리 ID가 생성될 Azure 리전(위치)입니다(예: "eastus"). create_azure_managed_identity가 true일 때 필수입니다. string null no
azure_managed_identity_name Teleport Discovery용으로 생성되는 Azure 사용자 할당 관리 ID의 이름입니다. string "discovery-identity" no
azure_managed_identity_use_name_prefix azure_managed_identity_name을 이름 접두사로 사용할지(true) 정확한 이름으로 사용할지(false) 여부입니다. bool true no
azure_management_group_id 역할 할당 범위를 도출하는 데 사용하는 Azure 관리 그룹 또는 테넌트의 ID입니다. azure_role_assignment_scopes가 설정되어 있으면 효과가 없습니다. 둘 다 설정되지 않으면 구독 범위는 azure_matchers에서 도출됩니다. string null no
azure_matchers Azure 리소스 검색 매처입니다. azure_matchers.types에 사용할 수 있는 값은 vm과 aks입니다. azure_management_group_id 또는 azure_role_assignment_scopes가 설정된 경우 와일드카드('*') 구독 매처를 사용할 수 있습니다. list(object({ types = list(string) subscriptions = list(string) resource_groups = optional(list(string), ["*"]) regions = optional(list(string), ["*"]) tags = optional(map(list(string)), { "*" : ["*"] }) })) n/a yes
azure_resource_group_name Azure 리소스가 생성될 기존 Azure 리소스 그룹의 이름입니다. create_azure_managed_identity가 true일 때 필수입니다. string null no
azure_role_assignment_scopes Azure 검색 역할이 할당될 범위입니다. 기본적으로 범위는 azure_management_group_id에 설정된 관리 그룹 또는 azure_matchers에 구성된 구독에서 도출됩니다. list(string) [] no
azure_role_definition_name Teleport Discovery용으로 생성되는 Azure 사용자 지정 역할 정의의 이름입니다. string "teleport-discovery" no
azure_role_definition_use_name_prefix azure_role_definition_name을 이름 접두사로 사용할지(true) 정확한 이름으로 사용할지(false) 여부입니다. bool true no
create 모든 리소스의 생성 여부를 전환합니다. bool true no
create_azure_managed_identity Azure 관리 ID와 역할 리소스를 생성할지(true) 하지 않을지(false) 여부입니다. false이면 Azure 리소스가 생성되지 않습니다. use_oidc_integration이 true이면 반드시 true로 설정해야 합니다. bool true no
teleport_discovery_config_name teleport_discovery_config 리소스의 이름입니다. string "discovery" no
teleport_discovery_config_use_name_prefix teleport_discovery_config_name을 이름 접두사로 사용할지(true) 정확한 이름으로 사용할지(false) 여부입니다. bool true no
teleport_discovery_group_name 사용할 Teleport 검색 그룹입니다. 검색 구성이 적용되려면 이 이름이 하나 이상의 Teleport Discovery Service 인스턴스에 구성된 discovery_group과 일치해야 합니다. Teleport Cloud 클러스터에는 "cloud-discovery-group"을 사용합니다. string n/a yes
teleport_installer_script_name 사용할 기존 Teleport 설치 스크립트의 이름입니다. string "default-installer" no
teleport_integration_name teleport_integration 리소스의 이름입니다. string "discovery" no
teleport_integration_use_name_prefix teleport_integration_name을 이름 접두사로 사용할지(true) 정확한 이름으로 사용할지(false) 여부입니다. bool true no
teleport_provision_token_allow_rules Teleport 프로비저닝 토큰의 사용자 지정 허용 규칙입니다. 와일드카드(*) 구독 매처를 사용하고 create_azure_managed_identity가 true이면 기본값은 Azure 테넌트 ID를 사용하는 테넌트 기반 허용 규칙입니다. create_azure_managed_identity가 false이고 와일드카드 구독 매처를 사용하는 경우 필수입니다. VM을 등록할 때만 사용합니다. list(object({ subscription = optional(string) resource_groups = optional(list(string)) tenant = optional(string) })) null no
teleport_provision_token_name teleport_provision_token 리소스의 이름입니다. string "discovery" no
teleport_provision_token_use_name_prefix teleport_provision_token_name을 이름 접두사로 사용할지(true) 정확한 이름으로 사용할지(false) 여부입니다. bool true no
teleport_proxy_public_addr host:port 형식의 Teleport 클러스터 프록시 공개 주소입니다(URL 스킴 제외). string n/a yes
use_oidc_integration Azure OIDC 연동과 페더레이션 ID 자격 증명을 생성하여 Teleport 검색 구성에서 참조할지(true) 하지 않을지(false) 여부입니다. bool true no

출력#

Name Description
azure_discovery_role_definition Teleport Discovery Service용 Azure 역할 정의입니다.
azure_teleport_discovery_managed_identity Teleport Discovery Service용으로 생성된 관리 ID입니다.
teleport_discovery_config_name Teleport 동적 discovery_config의 이름입니다. 구성 세부 정보는 tctl get discovery_config/<name>으로 확인할 수 있습니다. Teleport Discovery Service 인스턴스는 discovery_config와 같은 검색 그룹에 속하면 이 discovery_config를 사용합니다.
teleport_integration_name Teleport integration 리소스의 이름입니다. integration 리소스는 Teleport Discovery Service 인스턴스가 Azure OIDC 페더레이션을 사용하여 검색용 Azure 관리 ID를 어슘하도록 구성합니다. 연동 세부 정보는 tctl get integrations/<name>으로 확인하거나 Teleport 웹 UI의 'Zero Trust Access' > 'Integrations'에서 확인할 수 있습니다.
teleport_provision_token_name Teleport 노드가 Azure 자격 증명을 사용하여 Teleport 클러스터에 조인할 수 있도록 하는 Teleport 프로비저닝 token의 이름입니다. VM을 등록할 때만 사용합니다. 토큰 세부 정보는 tctl get token/<name>으로 확인할 수 있습니다.

소스 코드#

GitHub에서 teleport-discovery-azure 모듈 소스 코드 보기.