# 디렉터리 ID 소스 구성 및 사용자 동기화

Canonical: https://www.nsecsoft.com/ko/docs/ping64-identity-access/iam/users/directory-identity-source/

Language: ko-KR

Updated: 2026-11-15T04:10:16.115618Z

ID 소스는 디렉터리의 사용자, 그룹 및 관련 구성원 관계를 통합 ID 디렉터리에 동기화합니다. 설정 저장, 연결 테스트, 동기화 미리 보기 및 실행은 별도 단계입니다. 어느 하나의 성공만으로 사용자 동기화 완료나 앱 접근 권한을 증명할 수 없습니다.

여기서는 AD 및 LDAP 디렉터리를 설명합니다. ID 소스와 AD 도메인 관리의 디렉터리 설정은 서로 다른 관리 경로입니다. 같은 디렉터리를 사용해도 용도, 연결 및 범위를 각각 확인하며 한 경로가 다른 경로를 자동 설정한다고 가정하지 않습니다.

아래 영어 명칭은 확인된 화면 표시이며 한국어 설명을 제공합니다.

## 준비 사항

-   관리자에게 ID 소스 조회, 구성, 미리 보기 및 동기화 권한이 있는지 확인합니다. 동기화와 삭제에는 추가 권한이 필요할 수 있습니다.
-   디렉터리 관리자와 서버, 포트, 인증서, 바인드 계정, 동기화 루트, 사용자·그룹 범위와 필터를 확인합니다. 바인드 계정에 필요한 읽기 권한을 부여하고 조직 규정에 따라 비밀번호를 보호합니다.
-   플랫폼에서 디렉터리에 연결할 수 있고 선택한 보안 연결의 인증서 체인과 호스트 이름을 검증할 수 있는지 확인합니다. 소규모 시험 범위, 테스트 계정과 변경 복구 계획을 준비합니다.
-   공유 디렉터리 연결을 변경하기 전에 다른 관리자와 조정합니다. 범위나 필터를 축소하면 기존 동기화 사용자 또는 그룹이 제외되어 상태와 업무 접근에 영향을 줄 수 있습니다. 먼저 영향을 평가하고 전체 디렉터리에서 바로 시험하지 않습니다.

## 소스 구성 및 테스트

1.  **IAM > Identity Directory > Identity Sources**: 통합 ID 디렉터리에서 ID 소스를 열고 **Add Identity Source**(ID 소스 추가)를 선택한 후 AD 또는 LDAP 디렉터리를 선택합니다. 기존 소스의 유형은 편집 중 직접 전환할 수 없습니다. 화면의 선택 항목은 **AD Domain Directory**와 **LDAP Directory**입니다.
2.  **Configure connection**(연결 구성)에서 이름을 입력하고 디렉터리 연결 생성·관리 또는 기존 소스 사용을 선택합니다. 첫 방식은 소스 저장 시 연결을 생성하거나 갱신하고, 두 번째 방식은 선택한 소스의 연결 설정을 사용합니다. 공유 연결 사용·변경 전에 다른 사용자를 확인합니다. 각 옵션 이름은 **Create or Manage a Directory Connection**과 **Use an Existing Directory Source**입니다.
3.  직접 연결을 관리한다면 LDAPS 또는 StartTLS를 선택하고 서버, 포트, 바인드 계정과 비밀번호를 입력하며 인증서 검증을 확인합니다. 기존 연결 편집 시 비밀번호를 비워 두면 기존 값이 유지되며 변경하려면 새 값을 입력합니다. 기존 소스를 사용하면 선택 연결과 관리 담당자를 확인합니다.
4.  **Sync scope**(동기화 범위)에서 루트, 사용자 및 그룹 범위와 필터를 확인합니다. **Business User Delegated Auth**(업무 사용자 위임 인증)는 조직의 인증 설계에 따라 결정하며 동기화만을 위해 필수라고 가정하지 않습니다.
5.  **Test Config**(설정 테스트)를 선택해 결과를 확인합니다. 실패하면 수정 후 다시 테스트하고 확인 단계의 요약을 검토하여 저장합니다. 테스트 성공은 개체 동기화나 업무 로그인 성공을 뜻하지 않습니다.

## 미리 보기 및 동기화 실행

1.  소스 목록으로 돌아가 저장된 소스를 다시 열고 확인 단계에서 **Preview Sync**(동기화 미리 보기)를 선택합니다. 새 소스는 먼저 저장해야 합니다. 편집 중 미리 보기는 저장된 설정을 사용하며 미저장 변경을 반영하지 않습니다.
2.  커넥터 상태, 신규 항목 및 충돌을 확인합니다. 화면은 최대 200개 개체의 미리 보기를 요청하므로 전체 디렉터리의 개별 검증으로 간주하지 않습니다. 충돌 시 관리자가 대응 관계와 처리 방안을 확인합니다.
3.  시험 범위를 확인한 뒤 소스 작업 메뉴에서 **Sync**(동기화)를 선택합니다. 시작 알림은 작업 제출을 뜻하며 완료를 뜻하지 않습니다. 이미 실행 중인 작업이 있으면 기다리고 상태를 확인합니다. 화면 알림은 **Sync triggered**와 **A sync task is already running**입니다.
4.  동기화 상태와 마지막 동기화 시간을 확인합니다. 완료 후 사용자 관리에서 예상 사용자와 그룹을 확인하고 실패 또는 충돌을 검토합니다. 누락 시 범위, 필터, 바인드 계정 읽기 권한 및 작업 결과를 확인한 후 조정과 재실행을 결정합니다.
5.  동기화 사용자가 앱에 접근하려면 대상 앱 접근 범위를 설정하고 인증 연동을 검증해야 합니다. [사용자 계정과 앱 접근](https://www.nsecsoft.com/ko/docs/ping64-identity-access/iam/users/user-accounts/)에서 지정 사용자 또는 실제 소속 그룹, 앱 상태 및 통제된 로그인 결과를 확인합니다. 동기화가 모든 앱 접근을 자동으로 허용하지 않습니다.

**범위 변경 시 중요 사항:** 미리 보기는 해당 시점에 읽은 개체를 기준으로 생성되며 새 범위나 필터로 읽히지 않는 기존 동기화 사용자와 그룹을 완전히 나열하지 않습니다. 미리 보기에 비활성화 항목이 없어도 실제 동기화에서 비활성화가 없다고 보장할 수 없습니다. 동기화로 기존 사용자나 그룹이 비활성화되어 기존 사용자 세션과 애플리케이션 접근이 영향을 받을 수 있습니다. 범위 변경 전에 디렉터리 관리자와 기존 동기화 목록, 예정 범위, 중요 계정을 대조하고 승인된 복구 계획을 준비하십시오. 작은 범위에서 먼저 검증하고 동기화 후 사용자, 그룹, 업무 접근을 각각 확인하십시오.

**충돌 및 빈 결과:** 미리 보기 페이지는 상태, 신규 및 충돌 수 등의 요약만 표시하며 충돌 개체의 상세 정보나 연결 작업은 제공하지 않습니다. 사용자 이름 또는 이메일이 기존 사용자와 중복되거나 그룹 이름이 기존 그룹과 충돌하면 실제 동기화는 해당 개체를 건너뛰고 자동으로 연결하지 않습니다. 작업이 완료되어도 주요 사용자, 그룹 및 구성원 관계를 확인하십시오. 충돌은 디렉터리 관리자 및 기술 지원과 처리 방법을 확인하고 이름만으로 동일 개체라고 판단하지 마십시오. 동기화에서 개체를 전혀 읽지 못하면 이번에는 개체를 갱신하거나 누락된 개체를 비활성화하지 않습니다. 따라서 작업 완료가 기존 사용자의 정리를 의미하지는 않습니다. 범위, 필터, 읽기 권한 및 예상 데이터를 확인한 후 다시 동기화하십시오.

**디렉터리 그룹과 애플리케이션 접근 권한:** OIDC 애플리케이션의 그룹별 권한 검사는 통합 ID 관리에서 사용자의 관리 그룹을 확인하며, 동기화된 디렉터리 그룹 구성원 관계를 직접 사용하지 않습니다. 동기화로 새로 생성된 사용자는 처음에 관리 그룹이 없습니다. 디렉터리 그룹을 동기화하고 애플리케이션에서 선택하는 것만으로 구성원의 접근이 보장되지는 않습니다. 그룹별 권한을 부여하려면 먼저 사용자 관리에서 관리 그룹을 확인하고 조직 기준에 따라 설정한 다음 애플리케이션의 지정 접근 범위를 저장하십시오. 필요에 따라 애플리케이션에서 허용된 사용자를 직접 지정할 수도 있습니다. 변경 전에 영향을 평가하고 변경 후 허용된 계정과 허용되지 않은 계정으로 각각 검증하십시오.

## 변경 및 문제 해결

-   **연결 또는 범위 변경:** 공유 여부와 기존 사용자, 그룹, 업무 접근 영향을 확인하고 저장 후 재테스트, 미리 보기 및 동기화 결과 검토를 수행합니다.
-   **연결 테스트 실패:** 주소, 포트, 네트워크, 인증서 체인과 호스트 이름, 바인드 계정과 비밀번호를 확인합니다. 테스트 통과를 위해 인증서 문제를 무시하지 않습니다.
-   **미리 보기에 충돌:** 미리 보기만으로 범위를 확대하지 말고 디렉터리 개체와 기존 사용자의 대응 관계 및 처리 방안을 확인합니다.
-   **작업 시작 후 개체 누락:** 작업 완료, 범위, 필터 및 읽기 권한을 확인합니다. 제출 성공은 동기화 완료가 아닙니다.
-   **동기화 사용자의 앱 접근 실패:** 사용자 상태, 앱 접근 범위, 인증 연동과 실제 로그인 결과를 각각 확인합니다. 동기화나 위임 인증은 앱 권한 부여와 다릅니다.