SAML 애플리케이션 등록하기
Teleport v18.11요약
이 페이지는 SAML 애플리케이션이 Teleport에 등록된 후에도 SAML을 통해 사용자를 계속 인증할 수 있도록, SAML 애플리케이션(서비스 공급자)과 ID 공급자(IdP)에서 필요한 SAML 구성 변경 사항을 설명합니다.
이 페이지는 SAML 애플리케이션이 Teleport에 등록된 후에도 SAML을 통해 사용자를 계속 인증할 수 있도록, SAML 애플리케이션(서비스 공급자)과 ID 공급자(IdP)에서 필요한 SAML 구성 변경 사항을 설명합니다.
SAML 구성 이해하기#
SAML SSO 구성은 양쪽으로 이루어집니다. ID 공급자에는 서비스 공급자의 Assertion Consumer Service(ACS) URL과 대상 URI(Entity ID)를 등록하고, 서비스 공급자에는 ID 공급자의 SSO URL과 발급자(issuer)를 등록합니다.
SAML 인증 중에 브라우저는 인증 요청을 ID 공급자의 SSO URL로, 응답을 서비스 공급자의 ACS URL로 전달합니다.
Teleport 애플리케이션 서비스 뒤에 있는 웹 애플리케이션을 등록하면, 해당 애플리케이션은 Teleport 프록시 서비스 주소의 하위 도메인인 새 엔드포인트에서 Teleport 프록시를 통해 제공됩니다. 또한 애플리케이션에 Teleport 프록시 서비스를 통해서만 접근할 수 있도록 네트워크를 변경합니다. 이처럼 애플리케이션의 공개 주소가 바뀌면 ID 공급자가 여전히 SAML 응답을 애플리케이션의 이전 엔드포인트로 보내기 때문에 SAML SSO가 동작하지 않습니다.
이를 바로잡으려면 ID 공급자와 서비스 공급자 양쪽에 구성된 ACS URL을 애플리케이션의 새 공개 주소로 업데이트합니다. 애플리케이션의 대상 URI가 공개 엔드포인트에서 파생되는 경우에는 이 값도 양쪽 모두에서 업데이트합니다.
마이그레이션 계획#
SAML 애플리케이션을 Teleport에 등록하기 전#
이 단계에서 애플리케이션은 자체 공개 주소로 접근할 수 있으며, ID 공급자는 SAML 어서션을 해당 주소로 보냅니다.
+-----------+
| IdP |
+-----^-----+
|
|
v
+-----------+ +--------------------------+
| Browser |<---->| Application |
+-----------+ | app.example.com |
+--------------------------+
이 단계의 일반적인 SAML 구성은 다음과 같습니다.
ID 공급자에서:
- 애플리케이션의 ACS URL:
https://app.example.com/saml/acs - 애플리케이션의 대상 URI:
urn:example:application
애플리케이션(서비스 공급자)에서:
- IdP의 SSO URL:
https://idp.example.com/saml/sso - IdP의 Entity ID:
https://idp.example.com/metadata
SAML 애플리케이션을 Teleport에 등록한 후#
애플리케이션을 애플리케이션 서비스 구성에 추가합니다. 예를 들면 다음과 같습니다.
app_service:
enabled: true
apps:
- name: app
uri: "http://app.localhost:8080"
public_addr: "app.example.teleport.sh"
Teleport 프록시 서비스는 SAML SSO 어서션을 담은 요청을 포함하여 애플리케이션으로 향하는 HTTPS 요청을 프록시합니다.
따라서 SAML 구성에서는 Teleport 엔드포인트를 서비스 공급자 주소로 사용해야 합니다.
+-----------+
| IdP |
+-----^-----+
|
|
v
+-----------+ +------------------------------+ +---------------+
| Browser |<---->| Teleport |<---->| Application |
+-----------+ | app.example.teleport.sh | +---------------+
+------------------------------+
ID 공급자에서:
- 애플리케이션의 ACS URL:
https://app.example.teleport.sh/saml/acs - 애플리케이션의 대상 URI:
urn:example:application
이제 ID 공급자가 Teleport 프록시 주소를 가리킨다는 점에 유의합니다.
애플리케이션(서비스 공급자)에서:
- IdP의 SSO URL:
https://idp.example.com/saml/sso - IdP의 Entity ID:
https://idp.example.com/metadata
ID 공급자의 엔드포인트는 그대로라는 점에 유의합니다.
다만 애플리케이션에 따라 애플리케이션에서 다음 구성도 변경해야 할 수 있습니다.
애플리케이션의 ACS URL#
많은 SAML 애플리케이션은 애플리케이션의 SAML 구성에 ACS URL을 명시적으로 설정해야 합니다.
애플리케이션이 이를 요구하는 경우, ID 공급자에 구성한 것과 동일한 Teleport 도메인으로
애플리케이션의 구성을 업데이트해야 합니다: https://app.example.teleport.sh/saml/acs.
헤더 재작성#
일부 SAML 애플리케이션은 수신한 HTTP 요청의 Host 헤더로 기본 URL을 만들고,
같은 값에서 기대하는 ACS URL을 도출합니다.
애플리케이션이 이렇게 동작한다면, 애플리케이션이 Host 헤더로 Teleport 주소를 받도록
Teleport 애플리케이션 서비스에 헤더 재작성을 구성합니다.
예시:
apps:
- name: app
uri: "http://app.localhost:8080"
public_addr: "app.example.teleport.sh"
rewrite:
headers:
- "Host: app.example.teleport.sh"
FAQ#
사용자의 로그인 시작 방식 변경 여부#
변경됩니다. Teleport 애플리케이션 서비스는 애플리케이션으로 프록시하기 전에 자체 사용자 세션을 유지합니다. 사용자는 SAML SSO를 시작하기 전에 해당 애플리케이션에 대한 유효한 Teleport 세션을 가지고 있어야 합니다.
애플리케이션에 로그인하려면 사용자는 Teleport 웹 UI의 애플리케이션 타일에 있는 Launch 버튼을 클릭합니다. 그러면 Teleport 웹 UI가 사용자를 위한 새 애플리케이션 세션을 만들고, 지정된 하위 도메인에서 애플리케이션을 엽니다. 사용자는 거기서 애플리케이션 자체에서 SAML SSO를 이어서 진행할 수 있습니다.
사용자가 해당 애플리케이션에 대해 활성 Teleport 세션을 가지고 있다면, 서비스 공급자가 시작하는 로그인과 ID 공급자가 시작하는 로그인 모두 동작합니다.
북마크한 로그인 링크가 필요한 경우, 사용자는 Teleport 웹 UI의 애플리케이션 타일에 있는 같은 Launch 버튼에서 URL을 복사할 수 있습니다.
Teleport 애플리케이션 서비스와 SAML의 호환성#
Teleport 애플리케이션 서비스는 SAML 메시지를 수정하지 않습니다. HTTP Redirect 또는 POST 바인딩으로 전달되는 요청과 HTTP POST 또는 Artifact 바인딩으로 전달되는 응답은 사용자가 해당 애플리케이션에 대해 활성 Teleport 세션을 가지고 있는 한 모두 계속 동작합니다.
HTTP-Artifact 바인딩은 아래에서 설명하는 것처럼 애플리케이션이 ID 공급자에 직접 접근할 수 있어야 합니다.
애플리케이션의 ID 공급자 외부 송신(egress) 접근 필요 여부#
애플리케이션에 ID 공급자로의 외부 송신 접근이 필요한 경우는 두 가지입니다.
- 실시간 엔티티 디스크립터 검증: SAML 어서션을 검증하기 위해 서비스 공급자는 ID 공급자의 엔티티 디스크립터를 확인합니다. 일부 애플리케이션은 설정 중에 이 엔티티 디스크립터를 한 번 구성하고, 수신한 어서션을 저장된 사본과 대조해 검증합니다. 다른 애플리케이션은 검증을 시도할 때마다 엔티티 디스크립터를 가져옵니다.
- HTTP-Artifact 바인딩: 애플리케이션이 SSO를 완료하기 위해 HTTP-Artifact 바인딩 방식을 사용하도록 구성된 경우, 어서션 데이터는 백채널로 교환됩니다. 이때 서비스 공급자는 ID 공급자의 엔드포인트를 직접 조회하여 SAML 어서션을 요청합니다.
ID 공급자의 서비스 공급자 외부 송신 접근 필요 여부#
SSO 중에는 필요하지 않습니다.
서비스 공급자를 구성하는 동안에는 필요할 수 있습니다. 일부 ID 공급자는 SAML 구성을 채우거나 검증하기 위해 서비스 공급자의 메타데이터를 가져옵니다. 애플리케이션이 이미 Teleport를 통해 제공되고 있다면, 이 가져오기를 위해 ID 공급자의 HTTP 클라이언트가 Teleport 로그인 절차를 완료해야 하는데, 이는 불가능합니다.
대부분의 ID 공급자는 엔티티 디스크립터 파일을 업로드하여 엔티티 디스크립터를 구성하는 방식도 지원하므로, 서비스 공급자의 메타데이터 엔드포인트에서 가져올 필요가 없습니다.
다음 단계#
- Teleport 애플리케이션 서비스로 웹 애플리케이션을 등록합니다.
- 애플리케이션 서비스에서 사용할 수 있는 고급 옵션을 확인합니다.