> 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/gsuite.md).

# G Suite SSO

## 개요

Panther는 G Suite(현재는 Google Workspace로 이름이 변경됨)와 SAML 공급자로 통합하여 SSO를 통해 Panther Console에 로그인할 수 있도록 지원합니다.

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

## G Suite를 사용하여 Panther Console에 SAML SSO를 구성하는 방법

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

1. Panther 콘솔에 로그인합니다.
2. 오른쪽 상단 모서리에서 톱니바퀴 아이콘을 클릭하여 설정을 연 다음, 다음으로 이동합니다. **액세스 및 인증** > **ID 및 액세스**.
3. 다음 항목 옆에 **SAML(Security Assertion Markup Language) 활성화**, 토글을 `ON`.
4. 다음을 사용하는 경우 [IdP 시작 로그인](https://docs.panther.com/ko/system-configuration/saml/pages/f6bdab94ad1caa8f58319492faab0644a60d4ea8#idp-initiated-vs.-sp-initiated-login), 다음을 **IdP 시작 단일 로그인(SSO) 사용** 토글을 `ON`.
5. 다음의 다음을 복사합니다. **대상** 및 **ACS 소비자 URL** 값을 복사하여 안전한 위치에 보관하세요. 다음 단계에서 필요합니다.
   * IdP 시작 로그인을 사용하는 경우, 다음도 복사하세요. **릴레이 상태** 값.

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

### 2단계: G Suite 앱 생성

다음 [SAML 기반 SSO용 G Suite 가이드](https://support.google.com/a/answer/6087519) 를 사용하여 사용자 지정 SAML 앱을 추가합니다.

{% hint style="info" %}
변경 사항이 Google Workspace에 전파되기까지 최대 24시간이 걸릴 수 있습니다.
{% endhint %}

Panther용 SAML 앱을 만들려면 다음 수정 사항을 적용하세요.

* 에서 **서비스 제공업체 세부정보** 창에서 다음을 입력합니다:
  * **ACS URL**: 다음을 붙여넣습니다. **ACS 소비자 URL** 1단계에서 Panther Console에서 얻은 값을.
  * **엔터티 ID**: 다음을 붙여넣습니다. **대상** 1단계에서 Panther Console에서 얻은 값을.
  * **시작 URL**: IdP 시작 로그인을 사용하는 경우, 다음을 붙여넣습니다. **릴레이 상태** 1단계에서 Panther Console에서 복사한 값을. SP 시작 로그인을 사용하는 경우, 이 값은 비워 둡니다.

    <figure><img src="/files/57fedeb62d22e631b34c4e3f7988085964c91b81" alt=""><figcaption></figcaption></figure>
* 다음 **속성 매핑** 페이지에서 다음 속성 매핑을 구성합니다:
  * **이름**: `PantherFirstName`
  * **성**: `PantherLastName`
  * **기본 이메일**: `PantherEmail`

    <figure><img src="/files/b0533976f526d8391fcc75773a03c2cb46a15c25" alt=""><figcaption></figcaption></figure>

### 3단계: Google Workspace에서 SAML 앱 사용 설정

다음을 따르세요 [SAML 앱을 켜기 위한 Google의 문서](https://support.google.com/a/answer/6087519).

### 4단계: Panther에서 SAML 구성

1. 다시 다음으로 이동합니다. **ID 및 액세스** 1단계의 Panther Console에 있는 섹션으로. 다음에서 **기본 역할** 필드에서, 새 사용자가 SSO를 통해 처음 로그인할 때 기본적으로 할당될 Panther 역할을 선택합니다.

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

2. 다음 항목 아래의 **ID 공급자 URL** 필드를 클릭한 다음 **여기를 클릭** 하여 SAML 앱을 구성하는 동안 Google에서 다운로드한 메타데이터 파일을 업로드합니다.
3. 클릭하세요 **변경 사항 저장**.

설정을 테스트하려면 Panther 로그인 페이지로 이동하여 다음을 클릭합니다 **SSO로 로그인**.

<figure><img src="/files/337b30a37d5c32bef2b9f9cc03b5e8e0397019e7" alt="The Panther login page shows a &#x22;Login with SSO&#x22; option"><figcaption></figcaption></figure>


---

# 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/gsuite.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.
