---
schema_version: "1"
id: dd7dab2b4e179d9af467b634328198331d024e7d20b47a5cccfe1ce9a8f288b6
title: ID 마이그레이션 충돌 해결
collection: tableau
version: current
locale: ko-kr
portal_url: https://docs.salesforce.com/tableau/current/ko-kr/server/identity_migration_conflicts.md
canonical_url: https://help.tableau.com/current/server/ko-kr/identity_migration_conflicts.htm
source_site: help.tableau.com
content_type: documentation
content_hash: 4ee196dc257de8e63c579cb19fb0b4f4d1d98af0206ccd602e2958a4b38aa76f
description: Resolve identity conflicts that block the Tableau Server identity migration.
---
[주요 콘텐츠로 건너뛰기](#main-content)

# ID 마이그레이션 충돌 해결

ID 마이그레이션 중에 Tableau Server에서 ID 서비스 사용을 위해 마이그레이션할 수 없는 특정 사용자 ID가 발생할 수 있습니다. 사용자 ID를 마이그레이션할 수 없는 경우 관리자가 수동으로 해결해야 하는 ID 충돌이 됩니다.

사용자 ID를 올바르게 마이그레이션하려면 ID 마이그레이션을 완료하기 전에 전용 ID 마이그레이션 페이지를 사용하여 모든 ID 충돌을 해결해야 합니다.

## 1단계: ID 충돌 해결

충돌 유형에 따라 몇 가지 방법으로 ID 충돌을 해결할 수 있습니다. 충돌 유형과 관계없이 모든 사용자 ID를 해결해야 아래의 [2단계](#step2)로 진행하고 ID 마이그레이션을 완료할 수 있습니다.

ID 충돌이 발생하면 ID 마이그레이션 중에 충돌이 유형으로 그룹화됩니다. 이 유형은 마이그레이션에서 사용자 ID를 자동으로 마이그레이션할 수 없는 이유를 좁히는 데 도움이 됩니다.

ID 충돌이 발생하는 이유는 몇 가지 있습니다. 예를 들어 마이그레이션 중에 외부 ID 저장소에서 2개 이상의 사용자 ID와 일치하는 Tableau Server 사용자가 식별된 경우 ID 충돌이 발생할 수 있습니다.

ID 충돌이 식별된 경우 다음 옵션 중 하나를 사용하여 해결할 수 있습니다.

- **마이그레이션 다시 시도** - 이 옵션은 선택한 사용자 ID를 큐로 다시 이동하여 다시 마이그레이션합니다. 마이그레이션 작업이 다시 실행된 후에는 ID 충돌이 자체적으로 해결되거나 원래 ID 충돌이 다시 발생하거나 새 ID 충돌이 발생할 수 있습니다.
- **승인** - 이 옵션은 선택한 사용자 ID를 승인됨 탭으로 이동합니다. 사용자 ID를 확인하면 1) 이러한 사용자의 사용자 ID와 일치하는 사용자 ID가 ID 저장소에 없으므로 마이그레이션되지 않을 것이고 2) 아래의 [3단계](#step3)에서 ID 서비스를 사용하도록 설정한 후 이러한 사용자는 Tableau Server에 로그인할 수 없게 됨을 이해하는 것입니다.
- **재평가** - 충돌이 이미 확인된 경우 확인됨 탭에서 이 옵션은 선택한 사용자 ID를 충돌 상태로 되돌립니다. 이 옵션은 원래 충돌을 보거나 충돌을 해결하거나 ID 충돌을 다시 확인할 수 있는 기회를 제공합니다.

### 빠른 참조: ID 충돌

<table style="width: 90%;mc-table-style: url('Resources/TableStyles/Basic-Border-Light.css');margin-left: 0;margin-right: auto;" class="TableStyle-Basic-Border" cellspacing="0"><colgroup><col class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1"></colgroup><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="text-align: center;font-weight: bold;">충돌 유형</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="text-align: center;font-weight: bold;">적용되는 구성</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="text-align: center;font-weight: bold;">충돌 이유</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1" style="text-align: center;font-weight: bold;">동작</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">모든 실패</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">전체</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">이 탭은 일치 항목 없음, 모호함, 중복, 로컬에 없음 및 알 수 없음 탭에 분류된 모든 ID 충돌을 캡처합니다.</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">마이그레이션 다시 시도 또는 승인</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">일치 항목 없음</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">AD, LDAP</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">사용자 ID와 일치하는 사용자가 외부 ID 저장소에 없습니다.</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">마이그레이션 다시 시도 또는 승인</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">모호함</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">AD, LDAP</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">지정된 사용자 ID와 일치할 수 있는 항목이 외부 ID 저장소에 2개 이상 있습니다.</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">마이그레이션 다시 시도, 확인 또는 제안된 사용자 ID 중 1개 선택</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">중복</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">AD</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">하나의 AD 계정을 사용하여 사용자 ID가 2개가 만들어졌습니다. 이는 ID 서비스에서 지원되지 않는 레거시 기능의 아티팩트입니다.</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">마이그레이션 다시 시도 또는 승인</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">로컬에 없음</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">로컬</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">ID 저장소에 연결된 사용자 ID가 로컬에 없습니다. 이 충돌은 지원되지 않는 수동 변경이 수행된 경우 발생합니다.</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">마이그레이션 다시 시도 또는 승인</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">알 수 없음</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">전체</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">이 충돌은 내부 Tableau Server 오류 또는 이 표에 나열되지 않은 이유로 인한 ID 충돌을 나타낼 수 있습니다.</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">마이그레이션 다시 시도 또는 승인</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">승인됨</td><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">전체</td><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">이 탭은 마이그레이션되지 않을 모든 사용자 ID를 캡처합니다. 이러한 사용자는 Tableau Server가 ID 서비스를 사용하도록 구성된 후 Tableau Server에 로그인할 수 없게 됩니다.</td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1">마이그레이션 다시 시도 또는 승인</td></tr></tbody></table>

충돌을 해결하려면 아래 단계를 수행합니다.

1. Tableau Server에 관리자로 로그인합니다.
2. 왼쪽 탐색 패널에서 사용자(또는 다중 사이트 Tableau Server의 경우 모든 사이트 > 사용자)를 선택한 다음 ID 마이그레이션 페이지를 클릭합니다.

1. 모든 실패 탭 또는 충돌 관련 탭 중 하나에서 사용자 ID를 1개 이상 선택합니다.
2. 동작 드롭다운 메뉴에서 마이그레이션 다시 시도 또는 승인을 클릭합니다.
    
    “마이그레이션 다시 시도”를 선택하면 사용자 ID에서 다른 충돌 유형이 생성될 수 있습니다. 이 경우 아래 이미지와 같이 모든 실패 탭에 '0'이 표시될 때까지 필요에 따라 충돌을 해결합니다.
    
    ![실패 0개가 표시되어 있는 ID 마이그레이션 요약입니다.](/tableau/current/ko-kr/server/ko-kr/Img/id_mig_failures_acknowledge.png)
    
    **참고:** 승인된 사용자 ID는 앞으로 AD(Active Directory) 및 LDAP 그룹 동기화에서 무시됩니다. 이러한 사용자 ID와 연결된 사용자가 나중에 Tableau Server에 액세스해야 하는 경우 자세한 내용은 [ID 마이그레이션 문제 해결](https://help.tableau.com/current/server/ko-kr/identity_migration_troubleshoot.htm#acknowledged)을 참조하십시오.

## 2단계: ID 마이그레이션 완료

ID 마이그레이션을 완료하려면 모든 ID 충돌을 해결하고 모든 마이그레이션 작업을 실행해야 합니다. 그래야 Tableau Server에서 ID 서비스를 사용하도록 설정할 수 있습니다.

1. 다음 작업 중 _하나_를 수행합니다.
    
    - ID 마이그레이션 작업을 지금 실행하려면 마이그레이션 개요 머리글 옆에서 일정 편집 드롭다운 화살표를 클릭한 다음 지금 실행을 선택합니다.
        
        ![마이그레이션 일정을 편집하기 위한 드롭다운 메뉴로, 사용 안 함 또는 지금 실행 옵션이 있습니다.](/tableau/current/ko-kr/server/ko-kr/Img/id_mig_overview_runnow.png)
    - 또는 기다려서 다음 예약 시간에 마이그레이션을 실행할 수 있습니다.
2. ID 마이그레이션 페이지에서 마이그레이션 개요에 100% 완료가 표시되는지 확인합니다.
    
    ![100% 완료를 나타내는 ID 마이그레이션 진행률 표시줄입니다.](/tableau/current/ko-kr/server/ko-kr/Img/id_mig_complete.png)

## 3단계: ID 서비스를 사용하도록 Tableau Server 구성

ID 마이그레이션이 완료된 후에는 ID 서비스를 사용하도록 Tableau Server를 구성합니다. 이 서비스는 사용자 프로비저닝 및 인증 프로세스를 위한 더 안전하고 변경 불가능한 ID 구조를 제공합니다.

1. 클러스터의 초기 노드(TSM이 설치된 노드)에서 관리자로 명령 프롬프트를 엽니다.
2. 실행 중인 Tableau Server 버전에 따라 다음 명령을 실행합니다.
    
    - Tableau Server 버전 2022.1.8 이상, 2022.3.10 이상, 2023.1.6 이상의 경우:
        
        ```
        tsm configuration set -k wgserver.authentication.legacy_identity_mode.enabled -v false
        ```
    - Tableau Server 버전 2022.1~2022.1.7, 2022.3~2022.3.9 또는 2023.1~2023.1.5의 경우:
        
        ```
        tsm authentication legacy-identity-mode disable
        ```
    
    **참고:** 위의 명령 중 하나를 실행한 후 설명된 ID 마이그레이션 페이지가 제거되고 더 이상 액세스할 수 없게 됩니다. 이 페이지에는 `tsm configuration set -k wgserver.authentication.legacy_identity_mode.enabled`가 `true`이거나 `tsm authentication legacy-identity-mode`를 사용하도록 설정한 경우에만 액세스할 수 있습니다.

ID 서비스를 사용하도록 Tableau Server를 구성한 후에 사용자가 Tableau Server에 로그인하면 Tableau Server가 구성된 ID 저장소의 식별자를 사용하여 사용자 ID를 검색합니다. 이 식별자에서 UUID(범용 고유 식별자)가 반환되고 일치하는 기존 Tableau Server 사용자 ID를 찾는 데 사용됩니다. 그런 다음에는 사용자 세션이 생성되고 인증 워크플로우가 완료됩니다.

## 4단계: ID 풀이 사용하도록 설정되어 있는지 확인

1. 다음 명령을 실행합니다.
    
    ```
    tsm configuration set -k features.IdentityPools -v true
    tsm pending-changes apply
    ```

**참고:** 이러한 명령을 실행하면 Tableau Server가 다시 시작됩니다.