> For the complete documentation index, see [llms.txt](https://docs.panther.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.panther.com/ko/system-configuration/saml/generic.md).

# 일반 SSO

## 개요

Panther는 SAML ID 공급자(IdP)와 통합하여 SSO를 통해 Panther Console에 로그인할 수 있도록 지원합니다.

Panther Console와의 SSO 통합의 기능, 용어, 제한 사항에 대한 자세한 내용은 참조하세요 [ID 및 액세스 통합](/ko/system-configuration/saml.md).

## 일반 통합으로 Panther Console에 SAML SSO를 구성하는 방법

어떤 SAML ID 공급자(IdP)든 다음 세 단계로 Panther와 통합할 수 있습니다:

### 1단계: Panther에서 SSO 매개변수 가져오기

1. Panther 콘솔에 로그인합니다.
2. 오른쪽 상단에서 기어 아이콘을 클릭하여 설정을 연 다음 **액세스 및 인증** > **ID 및 액세스**.
3. 옆의 **SAML 사용(보안 어설션 마크업 언어)**, 토글을 `ON`.
4. 사용하는 경우 [IdP 시작 로그인](https://docs.panther.com/ko/system-configuration/saml/pages/f6bdab94ad1caa8f58319492faab0644a60d4ea8#idp-initiated-vs.-sp-initiated-login), **IdP 시작 단일 로그인(SSO) 사용** 토글을 `ON`.
5. 다음을 복사하세요 **Audience** 및 **ACS 소비자 URL** 값을 복사하여 안전한 위치에 보관하세요. 다음 단계에서 필요합니다.
   * IdP 시작 로그인을 사용하는 경우, 다음도 복사하세요. **Relay State** 값.

{% hint style="info" %}
다음을 사용하는 것이 권장됩니다. [SP 시작 로그인](/ko/system-configuration/saml.md#sp-initiated-login-recommended), 일반적으로 IdP 시작 로그인보다 더 안전하다고 여겨지기 때문입니다.
{% endhint %}

### 2단계: IdP에서 애플리케이션 만들기

1. IdP의 관리 콘솔에 로그인하세요.
2. 다음 설정으로 IdP에 SAML 애플리케이션을 만드세요:
   * **Audience**: 입력하세요 **Audience** 1단계에서 Panther Console에서 복사한 값을 입력하세요.
   * **ACS 소비자 URL**: 입력하세요 **ACS URL** 1단계에서 Panther Console에서 복사한 값을 입력하세요.
   * **Relay State**: IdP 시작 로그인을 사용하는 경우, 붙여넣으세요 **Relay State** 1단계에서 Panther Console에서 복사한 값입니다. SP 시작 로그인을 사용하는 경우 이 값을 비워 두세요.
   * **SAML 속성 매핑**:
     * **PantherEmail**: 이 필드를 사용자 이메일에 매핑합니다.
     * **PantherFirstName**: 이 필드를 이름에 매핑합니다.
     * **PantherLastName**: 이 필드를 성에 매핑합니다.
   * 적절한 사용자에게 액세스 권한을 부여하세요
3. 복사하세요 **Issuer ID** 를 IdP에서 가져와 안전한 위치에 보관하세요. 다음 단계에서 필요합니다.
   * 이 URL은 공개적으로 액세스 가능한 XML 문서여야 합니다.
   * IdP가 메타데이터 XML 파일을 직접 다운로드할 수 있게 해주지만 URL은 제공하지 않는 경우, Panther에 업로드할 수 있도록 이 파일을 다운로드하세요.

### 3단계: Panther에서 일반 SAML 애플리케이션 구성

1. 다시 돌아가 **ID 및 액세스** 1단계의 Panther Console 섹션으로. 그 안의 **기본 역할** 필드에서 새 사용자가 SSO를 통해 처음 로그인할 때 기본으로 할당될 Panther 역할을 선택하세요.

{% hint style="warning" %}
Panther는 이 값을 다음으로 설정하지 않는 것을 강력히 권장합니다. `Admin`.
{% endhint %}

2. 에서 **ID 공급자 URL** 필드에 **Issuer URL** 이 문서의 이전 단계에서 얻은 값을 붙여넣으세요.
   * IdP가 파일 URL은 제공하지 않았지만 메타데이터 XML 파일을 다운로드할 수 있게 했다면, 다음을 클릭하여 Panther에 업로드하세요 **여기를 클릭하세요** 아래의 **ID 공급자 URL** 필드.
3. 클릭하세요 **변경 사항 저장**.

설정을 테스트하려면 Panther 로그인 페이지로 이동하여 클릭하세요 **SSO로 로그인**.

<figure><img src="/files/337b30a37d5c32bef2b9f9cc03b5e8e0397019e7" alt="The Panther login page displays a &#x22;Login with SSO&#x22; button at the bottom."><figcaption></figcaption></figure>

예시는 다음을 참조하세요 [OneLogin SSO](/ko/system-configuration/saml/onelogin.md) 및 [Okta SSO ](/ko/system-configuration/saml/okta.md)통합 가이드.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.panther.com/ko/system-configuration/saml/generic.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
