> 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/okta/okta-scim.md).
# Okta SCIM
## 개요
Panther는 다음을 통해 사용자 관리를 지원합니다 [교차 도메인 ID 관리 시스템(SCIM)](https://scim.cloud/) Okta와 함께. SCIM은 여러 시스템(예: Panther와 Okta) 간의 사용자 ID를 하나의 위치에서 관리하도록 설계된 프로토콜입니다. 이를 통해 Okta를 통해 Panther 역할을 관리하고, 프로필을 업데이트하며, 사용자를 활성화하거나 비활성화할 수 있습니다.
{% hint style="warning" %}
Panther는 SCIM을 통한 사용자 프로비저닝을 지원하지 않지만, 사용자는 *될 수 있습니다* 다음을 사용하여 자동으로 생성될 [Okta SSO](/ko/system-configuration/saml/okta.md) JIT(Just-In-Time) 프로비저닝을 통한 통합으로. 이는 사용자가 Okta에서 Panther 애플리케이션에 할당된 후, Panther에 처음 로그인하는 시점에 Panther에서 생성된다는 의미입니다. (SCIM 프로비저닝은 대신 Okta가 선제적으로 Panther에서 사용자를 생성한다는 의미입니다.)
{% endhint %}
### 지원되는 SCIM 기능
SCIM은 기존 Panther 사용자에 대해 다음 항목을 관리할 수 있습니다:
* **프로필 업데이트:** 사용자의 이름, 성, 이메일 및 사용자 지정 Panther 역할
* **사용자 상태**: 기존 사용자를 비활성화하고 다시 활성화
### 제한 사항
**사용자 프로비저닝:**
* Panther 사용자 프로필은 Okta SSO를 통해 Panther에 처음 로그인할 때 JIT 프로비저닝으로 생성됩니다.
* Panther는 SCIM을 통한 새 사용자 생성을 지원하지 않습니다.
* 기존 사용자 가져오기는 지원되지 않습니다.
* 사용자가 Panther에 처음 로그인하기 전에는 Okta에서 해당 사용자의 프로필을 업데이트할 수 없습니다.
**사용자 관리:**
* 사용자는 비활성화만 가능하며 삭제는 불가능합니다. Okta는 SCIM 사용자 객체에 대해 DELETE 작업을 수행하지 않습니다. 자세한 내용은 [Okta 문서](https://developer.okta.com/docs/api/openapi/okta-scim/guides/scim-20/#delete-users) 참조하세요.
* 오직 `eq` 연산자만 SCIM 쿼리에서 지원됩니다.
**그룹 및 역할:**
* 다음 `/Groups` SCIM 엔드포인트는 지원되지 않습니다.
* 사용자가 여러 그룹에 속해 있는 경우, 먼저 할당된 그룹의 속성이 우선 적용됩니다.
{% hint style="warning" %}
SCIM이 활성화되면 Panther Console에서 사용자에게 직접 적용한 변경 사항은 다음 Okta 동기화 시 덮어쓰여집니다.
{% endhint %}
### SCIM 워크플로
1. [Panther용 Okta SSO 구성](/ko/system-configuration/saml/okta.md).
2. [Okta로 Panther의 SCIM 구성](#how-to-configure-scim-to-panther-with-okta).
3. [Okta에서 사용자를 Panther 애플리케이션에 할당](#step-4-assign-users-and-groups-to-the-panther-application).
4. 사용자는 Okta SSO를 통해 Panther에 로그인하며, 이때 JIT 프로비저닝을 통해 프로필이 생성됩니다.
5. Okta SCIM이 프로필 업데이트, 역할 및 사용자 상태를 관리합니다.
## Okta로 Panther의 SCIM을 구성하는 방법
### 사전 요구 사항
* 이미 Panther의 [Okta SSO](/ko/system-configuration/saml/okta.md) 지침의 단계를 완료했습니다.
* 관리자 권한으로 Panther에 로그인되어 있습니다.
* Okta 계정의 관리자입니다.
### 1단계: 새 Panther API 토큰 만들기
1. Panther Console의 왼쪽 탐색 모음 하단에서 **설정**를 클릭한 다음 **개발자 도구** > **API 토큰**.
2. API 토큰 페이지에서 **새 토큰 만들기.**
* 다음을 제공하세요 **이름**, 예를 들어 `Panther-Okta-SCIM`.
* 토큰에 다음 권한을 부여합니다 **사용자 관리** (또는 `UserModify` (API를 통해 토큰을 생성하는 경우).
* 참고: **사용자 정보 읽기** 는 다음에서 제공되는 고유 권한입니다 **사용자 관리**.
3. 클릭합니다 **API 토큰 생성**.
4. API 토큰 값을 복사하여 안전한 위치에 저장하세요. 다음 단계에서 필요합니다.
* 이 페이지를 닫은 후에는 이 토큰을 다시 볼 수 없습니다.
### 2단계: Panther Okta 애플리케이션에서 SCIM 프로비저닝 설정
참고: [Okta SSO](/ko/system-configuration/saml/okta.md) 이미 구성되고 활성화되어 있어야 합니다.
1. Okta 계정에서 SAML SSO를 활성화하기 위해 만든 Panther 애플리케이션으로 이동합니다.
2. 아래 **일반 설정**에서 **프로비저닝** 필드를 클릭합니다: **SCIM**:
3. 다음 타일을 클릭하세요: **프로비저닝** 탭으로 이동한 다음, 왼쪽에서 **통합**. 페이지 오른쪽 상단에서 **편집**
4. 다음 값으로 구성 설정을 수정합니다:
* **인증 모드:** 드롭다운에서 다음을 선택합니다 `HTTP 헤더`. 이를 선택하면 **HTTP 헤더** 섹션이 아래에 표시됩니다.
* **인증**: 1단계에서 생성한 API 토큰 값을 붙여넣습니다.
* **SCIM 커넥터 기본 URL**: 다음을 입력하세요. **테넌트 URL** 를 Panther Console에서 가져옵니다.
* 이 값을 얻으려면: Panther Console에서 **일반 설정** 페이지로 이동하여 **ID 및 액세스** 탭을 선택합니다. **테넌트 URL** 는 **SCIM 프로비저닝 설정** 섹션.
* **사용자 고유 식별자 필드**: 사용자에 대한 고유 식별자로 사용하는 필드를 입력합니다. 예를 들어 `이메일`.
* **지원되는 프로비저닝 작업**: 선택 `프로필 업데이트 푸시`.
3. 클릭합니다 **저장**. Okta가 Panther와의 SCIM 연결을 확인합니다.
* 오류가 발생하면 다음을 확인하세요 **SCIM 커넥터 기본 URL** 값이 다음과 같은지 **테넌트 URL** 가 Panther Console의 값인지 확인한 다음 1분 후 다시 시도하세요. 새 API 토큰을 사용하는 경우 토큰이 활성화되는 데 최대 1분이 걸릴 수 있습니다.
### 3단계: Okta에서 Panther 설정 구성
이전 단계에서 SCIM 연결을 확인한 후, Okta에 Okta에서 Panther로 동기화할 설정을 구성하는 새 페이지가 표시됩니다.
1. 다음 타일을 클릭하세요: **프로비저닝** 탭. 왼쪽에서 **앱으로** 그런 다음 클릭합니다 **편집**.
2. 옵션을 활성화합니다 **사용자 속성 업데이트** 및 **사용자 비활성화**:
### 4단계: 사용자를 Panther 애플리케이션에 할당
{% hint style="warning" %}
**참고:** 새로 할당된 사용자는 SCIM이 프로필을 관리하기 전에 Okta SSO를 통해 Panther에 처음 로그인해야 합니다.
{% endhint %}
아직 하지 않았다면, Okta 사용자와 그룹을 Panther 애플리케이션에 할당합니다:
1. Okta에서 다음을 클릭합니다 **할당** 탭.
2. 사용자와 그룹에 Panther 애플리케이션을 할당합니다.
* 사용자: Okta 문서의 다음 내용을 따르세요 [애플리케이션을 사용자에게 할당하는 방법](https://help.okta.com/oie/en-us/Content/Topics/users-groups-profiles/usgp-assign-apps.htm).
* 그룹: Okta 문서의 다음 내용을 따르세요 [애플리케이션을 그룹에 할당하는 방법](https://help.okta.com/oie/en-us/Content/Topics/users-groups-profiles/usgp-assign-app-group.htm).
### 5단계: (선택 사항) SCIM을 통한 Panther 역할 관리 설정
Okta에서 Panther 역할 할당(예: Admin, ReadOnlyAnalyst 또는 사용자 지정 역할 중 하나)을 관리하려면, Okta의 Panther 사용자 프로필에 다음 이름의 새 속성을 만듭니다 `PantherRole`.
이 역할에 할당된 값은 모두 Panther와 동기화됩니다. 유효한 역할 이름을 제공하지 않으면 오류가 발생하며, 유효한 역할 이름이 제공될 때까지 사용자 업데이트가 수행되지 않습니다.
1. 다음 페이지에서 **앱으로** 설정 페이지에서 아래로 스크롤하여 **Panther 속성 매핑** 섹션으로 이동합니다. 다음을 클릭합니다 **프로필 편집기로 이동**.\
2. 다음 페이지에서 **프로필 편집기** 페이지에서 다음 **속성 추가**.
3. 새 속성에는 다음 값을 사용합니다. 나열되지 않은 필드는 그대로 두어도 됩니다.
* **데이터 유형**: `문자열`
* **표시 이름**: `Panther 역할`
* **변수 이름**: `pantherRole`
* **외부 이름**: `pantherRole`
* **외부 네임스페이스**: `urn:ietf:params:scim:schemas:core:2.0:User`
4. 클릭합니다 **저장**.
5. 다음에 대한 추가 속성 문을 구성합니다 `PantherRole` (이미 설정한 3개에 더해 [Okta SSO 설정 중 구성한](/ko/system-configuration/saml/okta.md#step-2-create-the-panther-application-in-okta)). 이렇게 하면 사용자가 Okta SSO를 통해 Panther에 로그인할 때 사용자의 `PantherRole` 정보가 SAML 어설션으로 동기화됩니다.
1. Okta에서 다음으로 이동합니다 **일반** 탭.
2. 다음 **SAML 설정** 섹션에서, **편집**.
3. 아래 **속성 문**, 네 번째 속성을 추가합니다:
* **이름**: `PantherRole`
* **값**: `appuser.pantherRole`
4. 클릭합니다 **계속**그다음 **저장**.
6. 개인 또는 그룹에 Panther 역할을 할당합니다.
{% hint style="warning" %}
이 단계는 사용자가 서비스 제공자(Panther) 시작 로그인을 완료해야만 특정 사용자에 대해 완료될 수 있습니다(이 과정에서 JIT 프로비저닝을 사용해 사용자 프로필이 생성됩니다). 그 전에 사용자 프로필을 업데이트하려고 하면 오류가 발생할 수 있습니다.
{% endhint %}
* 새 그룹 또는 사용자를 할당할 때, 그룹에 할당할 Panther 역할을 정의하라는 메시지가 표시됩니다.
* 기존 엔터티의 Panther 역할을 수정하려면 **할당** 탭을 클릭하고 사용자 또는 그룹을 편집한 다음 `Panther 역할` 필드를 수정합니다. 만약 `Panther 역할` 속성이 할당되지 않으면 Panther는 Panther Console에서 선택한 기본 SAML 역할을 사용합니다.
{% hint style="warning" %}
SCIM을 통해 이루어진 Panther 역할 할당은 영향을 받는 사용자가 Okta를 통해 Panther Console에 다시 인증할 때까지 Panther에 반영되지 않습니다. Okta에서 변경한 내용이 Panther와 동기화된 것으로 표시되지 않으면 몇 분 기다렸다가 다시 시도하세요.
{% endhint %}
---
# 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/okta/okta-scim.md?ask=&goal=
```
`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.