스키마

필수

• spec (속성) Spec은 AuthPreference 사양입니다 (자세한 내용은 아래의 중첩 스키마 참조)
• version (문자열) Version은 리소스 버전입니다. 필수로 지정해야 합니다. 지원되는 값은: v2 입니다.

선택적

• metadata (속성) 메타데이터는 리소스 메타데이터입니다 (자세한 내용은 아래의 중첩 스키마 참조)
• sub_kind (문자열) SubKind는 일부 리소스에 사용되는 선택적 리소스 하위 종류입니다.

spec 에 대한 중첩 스키마

선택적:

• allow_headless (부울) AllowHeadless는 헤드리스 지원을 활성화/비활성화합니다. 헤드리스 인증은 Webauthn이 필요합니다. Webauthn이 구성되면 기본값은 true이며, 그렇지 않으면 false입니다.
• allow_local_auth (부울) AllowLocalAuth는 로컬 인증이 활성화된 경우 true입니다.
• allow_passwordless (부울) AllowPasswordless는 비밀번호 없는 지원을 활성화/비활성화합니다. 비밀번호 없는 인증은 Webauthn이 필요합니다. Webauthn이 구성되면 기본값은 true이며, 그렇지 않으면 false입니다.
• connector_name (문자열) ConnectorName은 OIDC 또는 SAML 커넥터의 이름입니다. 이 값이 설정되지 않으면 백엔드의 첫 번째 커넥터가 사용됩니다.
• default_session_ttl (문자열) DefaultSessionTTL은 명시적인 TTL이 요청되지 않을 때 사용자 인증서에 사용할 TTL입니다.
• device_trust (속성) DeviceTrust는 신뢰할 수 있는 장치 검증과 관련된 설정을 보유합니다. Teleport Enterprise가 필요합니다. (자세한 내용은 아래의 중첩 스키마 참조)
• disconnect_expired_cert (부울) DisconnectExpiredCert는 만료된 인증서를 사용한 연결을 끊는 설정을 제공합니다. true로 설정하면 만료된 클라이언트 인증서를 사용한 연결이 끊어집니다.
• hardware_key (속성) HardwareKey는 하드웨어 키 지원에 대한 설정입니다. (자세한 내용은 아래의 중첩 스키마 참조)
• idp (속성) IDP는 Teleport 내에서 IdP에 액세스하는 것과 관련된 옵션 세트입니다. Teleport Enterprise가 필요합니다. (자세한 내용은 아래의 중첩 스키마 참조)
• locking_mode (문자열) LockingMode는 클러스터 전체의 잠금 모드 기본값입니다.
• message_of_the_day (문자열)
• okta (속성) Okta는 Teleport 내의 Okta 서비스와 관련된 옵션 세트입니다. Teleport Enterprise가 필요합니다. (자세한 내용은 아래의 중첩 스키마 참조)
• require_session_mfa (숫자) RequireMFAType은 이 클러스터에 대해 시행되는 MFA 요구 유형입니다. 0은 "OFF", 1은 "SESSION", 2는 "SESSION_AND_HARDWARE_KEY", 3은 "HARDWARE_KEY_TOUCH", 4는 "HARDWARE_KEY_PIN", 5는 "HARDWARE_KEY_TOUCH_AND_PIN"입니다.
• second_factor (문자열) SecondFactor는 다중 요소의 유형입니다.
• second_factors (숫자의 목록) SecondFactors는 지원되는 두 번째 요소 유형의 목록입니다.
• signature_algorithm_suite (숫자) SignatureAlgorithmSuite는 클러스터에 대해 구성된 서명 알고리즘 스위트입니다. 지정되지 않으면 현재 기본값은 "legacy"입니다. 1은 "legacy", 2는 "balanced-v1", 3은 "fips-v1", 4는 "hsm-v1"입니다.
• type (문자열) Type은 인증의 유형입니다.
• u2f (속성) U2F는 U2F 장치에 대한 설정입니다. (자세한 내용은 아래의 중첩 스키마 참조)
• webauthn (속성) Webauthn은 서버 측 웹 인증 지원에 대한 설정입니다. (자세한 내용은 아래의 중첩 스키마 참조)

spec.device_trust 에 대한 중첩 스키마

선택 사항:

• auto_enroll (Boolean) 장치 자동 등록을 활성화합니다. 자동 등록을 통해 등록되지 않은 알려진 장치에 대해 모든 사용자가 장치 등록 토큰을 발급할 수 있습니다. tsh 는 적절할 때 사용자 로그인 시 장치를 자동으로 등록하기 위해 자동 등록을 이용합니다. 유효한 클러스터 모드가 여전히 적용됩니다: AutoEnroll=true는 Mode="off"인 경우 의미가 없습니다.
• ekcert_allowed_cas (문자열 목록) PEM 형식의 EKCert CA 허용 목록입니다. 존재하는 경우, 여기에서 지정된 CA에 의해 서명된 EKCert를 제출하는 TPM 장치만 등록될 수 있습니다 (기존 등록은 변경되지 않음). 존재하지 않으면, TPM EKCert의 CA는 등록 중에 확인되지 않으며, 모든 장치가 등록될 수 있습니다.
• mode (문자열) 신뢰할 수 있는 장치에 대한 검증 모드입니다. 다음 모드가 지원됩니다:
  • "off": 장치 인증 및 권한 부여를 모두 비활성화합니다.
  • "optional": 장치 인증 및 권한 부여를 허용하지만, 민감한 엔드포인트에 대한 장치 확장 존재를 강제하지 않습니다.
  • "required": 민감한 엔드포인트에 대한 장치 확장 존재를 강제합니다.
    Mode는 OSS의 경우 항상 "off"입니다. 기본값은 Enterprise의 경우 "optional"입니다.

spec.hardware_key 에 대한 중첩 스키마

선택 사항:

• piv_slot (문자열) PIVSlot은 Teleport 클라이언트가 개인 키 정책에 따라 기본값 대신 사용해야 하는 PIV 슬롯입니다. 예: "9a" 또는 "9e".
• serial_number_validation (속성) SerialNumberValidation은 하드웨어 키 일련 번호 검증에 대한 설정을 보유합니다. 기본적으로 일련 번호 검증이 비활성화되어 있습니다. (아래의 중첩 스키마 참조)

spec.hardware_key.serial_number_validation 에 대한 중첩 스키마

선택 사항:

• enabled (Boolean) 사용 가능 여부를 나타냅니다.
• serial_number_trait_name (문자열) SerialNumberTraitName은 기본값: "hardware_key_serial_numbers"를 대체하기 위한 하드웨어 키 일련 번호에 대한 선택적 사용자 특성 이름입니다. 주의: 이 사용자 특성의 값은 일련 번호의 쉼표로 구분된 목록 또는 쉼표로 구분된 목록의 목록이어야 합니다. 예: ["123", "345,678"]

spec.idp 에 대한 중첩 스키마

선택 사항:

• saml (속성) SAML은 Teleport SAML IdP와 관련된 옵션입니다. (아래의 중첩 스키마 참조)

spec.idp.saml 에 대한 중첩 스키마

선택 사항:

• enabled (Boolean) 이 옵션이 Teleport SAML IdP에 대한 접근을 허용하는 경우 true로 설정됩니다.

spec.okta 에 대한 중첩 스키마

선택 사항:

• sync_period (문자열) SyncPeriod는 동기화 호출 간의 기간을 나노초로 나타냅니다.

spec.u2f 에 대한 중첩 스키마

선택 사항:

• app_id (문자열) AppID는 유니버설 다중 요인을 위한 응용 프로그램 ID를 반환합니다.
• device_attestation_cas (문자열 목록) DeviceAttestationCAs에는 U2F 장치에 대한 신뢰할 수 있는 증명 CA가 포함되어 있습니다.
• facets (문자열 목록) Facets는 유니버설 다중 요인을 위한 Facets를 반환합니다. 사용 중단됨: 하위 호환성 이유로 유지되지만, Teleport v10부터 Webauthn이 U2F 구현을 대체함에 따라 Facets에는 영향을 미치지 않습니다.

spec.webauthn 에 대한 중첩 스키마

선택 사항:

• attestation_allowed_cas (문자열 목록) PEM 형식의 장치 증명 CA 허용 목록입니다. 존재하는 경우, 여기에서 지정된 인증서와 일치하는 증명서만 등록할 수 있습니다(기존 등록은 변경되지 않음). AttestationDeniedCAs 와 함께 제공되는 경우, 등록이 허용되려면 두 조건이 모두 충족되어야 합니다(장치는 허용된 CA와 일치해야 하며 거부된 CA와는 일치하지 않아야 함). 기본적으로 모든 장치는 허용됩니다.
• attestation_denied_cas (문자열 목록) PEM 형식의 장치 증명 CA 거부 목록입니다. 존재하는 경우, 여기에서 지정된 인증서와 일치하지 않는 증명서만 등록할 수 있습니다(기존 등록은 변경되지 않음). AttestationAllowedCAs 와 함께 제공되는 경우, 등록이 허용되려면 두 조건이 모두 충족되어야 합니다(장치는 허용된 CA와 일치해야 하며 거부된 CA와는 일치하지 않아야 함). 기본적으로 거부된 장치는 없습니다.
• rp_id (문자열) RPID는 의존하는 당사자의 ID입니다. Teleport 설치의 도메인 이름으로 설정해야 합니다. 중요: RPID는 클러스터 수명 동안 절대 변경되어서는 안 되며, WebAuthn 장치에 등록 데이터에 기록됩니다. RPID가 변경되면 모든 기존 WebAuthn 키 등록이 무효화되며, WebAuthn을 다중 요소로 사용하는 모든 사용자는 다시 등록해야 합니다.

metadata 에 대한 중첩 스키마

선택 사항:

• description (문자열) 설명은 객체 설명입니다.
• expires (문자열) 만료는 시스템 내의 모든 리소스에 설정할 수 있는 전역 만료 시간 헤더입니다.
• labels (문자열 맵) 레이블은 레이블 집합입니다.