InfoGrab DocsInfoGrab Docs

teleport_saml_idp_service_provider Terraform 리소스 참조

요약

이 페이지는 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는 라벨 집합입니다.

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는 라벨 집합입니다.