teleport_saml_idp_service_provider Terraform 리소스 참조
Teleport v18.11요약
이 페이지는 Teleport Terraform 프로바이더의 teleport_saml_idp_service_provider 리소스에서 지원되는 값을 설명합니다. API는 또한 attribute_mapping의 값으로 entity_descriptor를 다시 작성합니다.
이 페이지는 Teleport Terraform 프로바이더의 teleport_saml_idp_service_provider 리소스에서 지원되는 값을 설명합니다.
Teleport API는 XML entity_descriptor, entity_id, acs_url을 제공할 수 있도록 허용합니다.
그러나 entity_descriptor에는 entity_id와 acs_url 값이 모두 포함되어 있습니다.
API는 entity_id가 entity_descriptor 안의 사본과 일치하지 않으면 변경을 허용하지 않습니다.
acs_url은 검사하지 않지만, 두 값이 다를 경우 entity_descriptor 안의 사본을 사용합니다.
따라서 entity_id와 acs_url을 함께 사용하거나 entity_descriptor를 사용하되, 둘 다 사용하지 않기를 권장합니다.
다만 Terraform 프로바이더는 기본 API와 동작을 맞추기 위해 세 가지를 모두 사용하는 것을 명시적으로 막지 않습니다.
API는 또한 attribute_mapping의 값으로 entity_descriptor를 다시 작성합니다.
두 값이 다르면 다음 적용 시 Terraform 리소스가 다시 생성됩니다.
이를 방지하려면 entity_descriptor 대신 entity_id+acs_url과 함께 attribute_mapping을 사용하십시오.
비슷한 멱등성 문제를 방지하기 위해 Terraform 프로바이더는 속성 매핑의 name_format 필드에도 전체 URN을 요구합니다.
사용 예시#
resource "teleport_saml_idp_service_provider" "from_descriptor" {
version = "v1"
metadata = {
name = "my-sp"
}
spec = {
entity_descriptor = <<-EOT
<?xml version="1.0" encoding="UTF-8"?>
<md:EntityDescriptor xmlns:md="urn:oasis:names:tc:SAML:2.0:metadata"
entityID="https://sp.example.com/saml/metadata">
<md:SPSSODescriptor protocolSupportEnumeration="urn:oasis:names:tc:SAML:2.0:protocol">
<md:AssertionConsumerService
Binding="urn:oasis:names:tc:SAML:2.0:bindings:HTTP-POST"
Location="https://sp.example.com/saml/acs"
index="0"/>
</md:SPSSODescriptor>
</md:EntityDescriptor>
EOT
// If you set both entity_descriptor and attribute_mapping, the Teleport API
// will add the attribute_mapping to the entity_descriptor, causing
// the resource to change on every apply
attribute_mapping = null
}
}
resource "teleport_saml_idp_service_provider" "from_entity_id" {
version = "v1"
metadata = {
name = "my-sp-2"
}
spec = {
entity_id = "https://sp.example.com/saml/metadata"
acs_url = "https://sp.example.com/saml/acs"
attribute_mapping = [
{
name = "username"
// Note: the short forms (i.e. just "basic") are not supported by the
// Terraform provider.
name_format = "urn:oasis:names:tc:SAML:2.0:attrname-format:basic"
value = "external.username"
},
]
}
}
스키마#
필수#
spec(Attributes) spec은 SAML IdP 서비스 프로바이더 사양입니다. (아래 중첩 스키마 참조)version(String) Version은 리소스를 생성하는 데 사용되는 API 버전입니다. 반드시 지정해야 합니다. 이 버전에 따라 Teleport는 리소스 생성 또는 삭제 시 다른 기본값을 적용합니다. "v"로 시작하는 정수여야 합니다. 예:v1
선택#
metadata(Attributes) Metadata는 리소스 메타데이터입니다. (아래 중첩 스키마 참조)sub_kind(String) SubKind는 일부 리소스에서 사용되는 선택적 리소스 하위 종류입니다.
spec에 대한 중첩 스키마#
선택:
acs_url(String) ACSURL은 SAML 인증 응답이 리디렉션되는 엔드포인트입니다.attribute_mapping(Attributes List) AttributeMapping은 서비스 프로바이더가 요청한 속성을 Teleport의 사용자 이름, 역할 및 트레이트에 매핑하는 데 사용됩니다. (아래 중첩 스키마 참조)entity_descriptor(String) EntityDescriptor는 서비스 프로바이더의 엔티티 디스크립터입니다.entity_id(String) EntityID는 엔티티 디스크립터의 엔티티 ID입니다. 엔티티 디스크립터가 제공된 경우, 이 리소스를 사용할 때마다 엔티티 디스크립터의 XML 블롭을 파싱하지 않아도 되도록 upsert 시점에 이 값이 엔티티 디스크립터의 엔티티 ID와 일치하는지 확인합니다.launch_urls(List of String) LaunchURLs는 서비스 프로바이더의 사용자 지정 랜딩 URL을 구성하는 데 사용됩니다. 다음과 같은 경우에 유용합니다. 1. 서비스 프로바이더가 IdP 시작 인증을 지원하지 않는 경우, 사용자를 서비스 프로바이더의 인증 엔드포인트로 바로 이동시키도록 시작 URL을 구성할 수 있습니다. 2. 서비스 프로바이더가 IdP 시작 인증을 지원하는 경우, 해당 서비스 프로바이더가 내부 서비스의 마스터 인증 서비스 프로바이더 역할을 할 때 유용합니다. 이 경우 Teleport 관리자는 시작 URL을 구성하여, 사용자가 UI의 로그인 타일에서 특정 내부 서비스 URL을 선택하도록 할 수 있으며, 이 경우 마스터 서비스 프로바이더로 바로 이동하지 않고 해당 서비스로 이동하여 인증하게 됩니다. 각 시작 URL 값은 HTTPS 엔드포인트여야 합니다.preset(String) Preset은 Teleport가 처리하는 사용자 지정 동작을 가진 서비스 프로바이더 프로필을 정의하는 데 사용됩니다.relay_state(String) RelayState는 SAML 응답에 relay_state HTTP 파라미터로 사용자 지정 값을 추가하는 데 사용됩니다. 이 값에는 서비스 프로바이더별 리디렉션 URL, 정적 상태 토큰 등을 포함할 수 있습니다. 이 값은 IdP 시작 SSO 흐름에서만 적용됩니다.
spec.attribute_mapping에 대한 중첩 스키마#
선택:
name(String) name은 속성 이름입니다.name_format(String) name_format은 속성 이름 형식입니다.value(String) value는 프레디킷 표현식으로 정의할 수 있는 속성 값입니다.
metadata에 대한 중첩 스키마#
필수:
name(String) Name은 객체 이름입니다.
선택:
description(String) Description은 객체 설명입니다.expires(String) Expires는 시스템의 모든 리소스에 설정할 수 있는 전역 만료 시간 헤더입니다.labels(Map of String) Labels는 라벨 집합입니다.