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 클러스터에 조인할 때 사용하는 조인 토큰을 제공합니다.
사전 요구사항#
-
VM 검색의 경우, 검색할 모든 Azure VM에 최소한 Microsoft.Compute/virtualMachines/read 권한을 가진 관리 ID가 할당되어 있어야 합니다. 자세히 알아보기
-
AKS 접근의 경우, AKS 클러스터에 접근할 수 있는 Teleport Kubernetes Service를 구성하고 Teleport AKS 자동 검색 가이드에 설명된 권한을 부여합니다.
예제#
도움 받는 방법#
문제가 발생하면 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>으로 확인할 수 있습니다. |