SAML 서명 인증서 교체하기
Teleport v18.11요약
SAML 서명 인증서는 ID 공급자(IdP)가 SAML 어설션에 서명할 때 사용하며, Teleport는 이 서명을 검증하여 사용자를 인증합니다. 이 페이지에서는 SAML 서명 인증서를 교체하기 위해 Teleport가 제공하는 기능을 설명합니다.
SAML 서명 인증서는 ID 공급자(IdP)가 SAML 어설션에 서명할 때 사용하며, Teleport는 이 서명을 검증하여 사용자를 인증합니다. 인증서에는 고정된 유효 기간이 있으며, 이 기간이 지나면 인증서가 만료되어 SSO가 더 이상 동작하지 않습니다. 이 인증서의 기본 유효 기간은 ID 공급자가 정하며, 예를 들어 Entra ID는 3년, Okta는 10년입니다.
이 페이지에서는 SAML 서명 인증서를 교체하기 위해 Teleport가 제공하는 기능을 설명합니다.
만료 알림#
서명 인증서가 만료 예정이거나 이미 만료된 경우, Teleport는 교체가 필요한 인증서에 대한 상세 정보가 담긴 클러스터 알림을 표시합니다.

Teleport에서 인증서를 업데이트하는 방법#
SAML 커넥터의 entity_descriptor 필드에는 서명 인증서를 포함한 ID 공급자의 메타데이터가
저장됩니다.
메타데이터 XML 또는 URL을 얻는 방법을 포함하여 ID 공급자에서 인증서를 생성하고 활성화하는 자세한 단계는 아래의 SAML 인증서를 교체하는 방법을 참조하십시오.
교체한 인증서를 Teleport에 반영하는 방법은 두 가지입니다.
entity_descriptor_url 사용하기(권장)#
SAML 커넥터의 entity_descriptor_url 필드에는 ID 공급자의 메타데이터 URL이 저장됩니다.
이 필드가 있는 상태로 SAML 커넥터를 저장하면, 저장 시점에 entity_descriptor 필드가
ID 공급자의 데이터로 자동으로 채워집니다.
- ID 공급자에서 메타데이터 URL을 찾아 나중에 사용할 수 있도록 저장합니다
- Teleport 웹 UI에서 Zero Trust Access > Auth Connectors로 이동하여
SAML 커넥터를 찾고 Edit를 클릭합니다

- 커넥터에
entity_descriptor_url필드가 있고,entity_descriptor필드에 ID 공급자 메타데이터가 채워져 있는지 확인합니다
entity_descriptor_url필드에 ID 공급자의 메타데이터 URL을 입력하고,entity_descriptor필드와 그 내용을 삭제한 다음 커넥터를 저장합니다
entity_descriptor필드가 교체된 인증서를 포함한 ID 공급자의 최신 메타데이터로 다시 채워졌는지 확인합니다
- ID 공급자로 돌아가 새 인증서를 활성화하고 이전 인증서를 삭제합니다
entity_descriptor 수동으로 업데이트하기#
entity_descriptor_url 필드가 채워져 있지 않은 경우에는 entity_descriptor 필드를
수동으로 채울 수 있습니다.
- ID 공급자에서 메타데이터 XML 파일을 찾아 나중에 사용할 수 있도록 저장합니다
- Teleport 웹 UI에서 Zero Trust Access > Auth Connectors로 이동하여
SAML 커넥터를 찾고 Edit를 클릭합니다

entity_descriptor필드의 내용을 첫 단계에서 저장한 메타데이터 XML 파일의 내용으로 교체한 다음 커넥터를 저장합니다
- ID 공급자로 돌아가 새 인증서를 활성화하고 이전 인증서를 삭제합니다
SAML 인증서를 교체하는 방법#
인증서를 교체하려면 먼저 ID 공급자에서 새 인증서를 생성하고, Teleport가 이를 신뢰하도록 업데이트한 다음, ID 공급자에서 새 인증서를 활성화하고 이전 인증서를 삭제합니다.
ID 공급자에서 새 인증서를 활성화하기 전에 먼저 Teleport가 새 인증서를 신뢰하도록 업데이트해야 합니다. Teleport를 업데이트하기 전에 활성화하면 SSO가 동작하지 않게 됩니다. Teleport에서 인증서를 업데이트하는 방법을 참조하십시오.
Entra ID#
Entra ID에서는 SAML 서명 인증서를 엔터프라이즈 애플리케이션 구성에서 관리합니다.
인증서 생성하기#
- Microsoft Entra 관리 센터에 로그인합니다
- Enterprise apps > All applications로 이동하여 SAML 앱을 선택합니다

- Single sign-on으로 이동하여 SAML Certificates 섹션까지 스크롤한 다음,
Token signing certificate 아래의 Edit 버튼을 클릭합니다

- New Certificate 버튼을 클릭한 다음 Save 버튼을 클릭합니다

- Teleport를 업데이트하는 데 필요한 메타데이터 URL을 복사하거나 메타데이터 XML을 다운로드합니다.
- Single sign-on 페이지의 SAML Certificates 섹션까지 스크롤하여
App Federation Metadata Url 필드에서 메타데이터 URL을 복사합니다

- 새 인증서 항목에서 Download federated certificate XML 항목을 선택하여
메타데이터 XML을 다운로드합니다

- Single sign-on 페이지의 SAML Certificates 섹션까지 스크롤하여
App Federation Metadata Url 필드에서 메타데이터 URL을 복사합니다
인증서 활성화하기#
- Single sign-on 페이지의 SAML Certificates 섹션까지 스크롤하여 Token signing certificate 아래의 Edit 버튼을 클릭합니다
- 새로 생성한 인증서를 찾아 Make certificate active를 선택합니다

- SSO가 정상적으로 동작하는 것을 확인한 후, Delete Certificate를 선택하여
이전 인증서를 삭제합니다

Okta#
Okta에서는 SAML 서명 인증서를 애플리케이션의 Sign On 탭에서 관리합니다.
인증서 생성하기#
- Okta Admin Console에 로그인합니다
- Applications > Applications로 이동하여 SAML 앱을 선택합니다

- Sign On 탭으로 이동하여 SAML Signing Certificates 섹션까지 스크롤한 다음
Generate New Certificate 버튼을 클릭합니다

- Teleport를 업데이트하는 데 필요한 메타데이터 URL을 복사하거나 메타데이터 XML을 다운로드합니다.
- Sign on methods 섹션까지 스크롤하여 SAML 2.0 섹션에서
메타데이터 URL을 복사합니다

- SAML Signing Certificates 섹션까지 스크롤하여 Actions > View IdP metadata에서
메타데이터 XML을 다운로드합니다

- Sign on methods 섹션까지 스크롤하여 SAML 2.0 섹션에서
메타데이터 URL을 복사합니다
인증서 활성화하기#
- SAML Signing Certificates 섹션까지 스크롤하여 새로 생성한 인증서를 찾습니다
- 새 인증서 항목에서 Actions > Activate를 선택하여 인증서를 활성화합니다

- SSO가 정상적으로 동작하는 것을 확인한 후, 이전 인증서 항목에서
Actions > Delete를 선택하여 이전 인증서를 삭제합니다
