일반적인 User Sync Tool 오류와 해결 방법을 확인하세요.
이 페이지에서는 User Sync Tool을 실행할 때 발생할 수 있는 일반적인 오류와 각 오류를 해결하는 단계를 나열합니다.도구 개요와 설정, 구성, 명령 참조를 찾을 수 있는 위치는 User Sync Tool 설정을 참조하십시오.
설치 및 환경
이는 경로가 256자를 초과할 때 Windows에서 나타날 수 있습니다.PEX_ROOT라는 이름의 환경 변수를 C:\pex 값으로 만드십시오.C: 이외의 드라이브에서 스크립트를 실행하는 경우 드라이브 레터를 일치하도록 변경하십시오.변경 사항이 적용되려면 때때로 시스템을 다시 시작해야 할 수 있습니다.
user-sync.pex가 위치한 폴더 내에서 python 명령줄을 실행하십시오.
- 시스템에 설치된 Python 버전이 32비트인지 확인하십시오.32비트 버전을 제거하고 64비트 버전을 설치하십시오.
- GitHub에서 다운로드한 user-sync.pex 버전이 Python 버전 및 운영 체제와 일치하는지 확인하십시오.예를 들어, Windows 64비트 및 Python 3의 경우 user-sync-v2.3-win64-py365.zip을 다운로드하십시오.최신 Python을 사용하는 대신 .pex가 빌드된 Python 버전과 일치시키십시오..zip의 접미사가 버전을 식별합니다. user-sync-v2.3-win64-py365.zip의 경우 Python 3.6.5입니다.
이 오류는 User Sync Tool v2.3과 Python 3.7.0을 사용하는 macOS High Sierra에서 기록되었습니다.터미널에서 brew install openssl을 실행하면 해당 상황에서 문제가 해결되었습니다.
연결, 제한 시간 및 제한
제한 시간이 30분 미만인 경우, 1분 내에 허용되는 API 호출 할당량에 도달하면 이러한 경고가 나타납니다.도구는 지수적 백오프 메커니즘을 사용하여 다시 시도하며, 재시도 간격을 늘리고 세 번의 시도가 실패한 후 중지합니다.스크립트를 끝까지 실행하도록 하십시오.
시간 초과가 1000초보다 높으면 제한은 각 User Sync Tool 인스턴스가 실행되는 빈도와 관련이 있습니다. 너무 자주 실행되는 인스턴스는 30~75분 동안 제한됩니다. 시간 초과는 도구를 일정 기간 동안만 일시 중지시키며, 도구는 이후 복구되어 동기화를 계속합니다.
도구가 두 인스턴스가 동시에 시작되는 것을 감지하기 때문에 첫 번째가 완료될 때까지 새 인스턴스는 실행되지 않습니다. 이 경우 로그에 프로세스가 이미 진행 중이라는 메시지가 표시될 수 있습니다.
최적의 성능을 위해 다음 실행 빈도 권장 사항을 따르십시오:
- 예약된 작업을 최소 2시간 간격으로 반복하도록 설정하십시오.
- 최대 트래픽을 피하기 위해 예약된 작업 트리거가 :00 또는 :30분에 시작되지 않도록 설정하십시오.
- 도구를 더 자주 실행해야 하는 경우 전체 동기화 대신 푸시 전략(변경 사항의 델타)을 사용하는 것을 고려하십시오.
- 도구의 실행 일정을 조직의 Workday에 맞춰 설정하십시오.예를 들어, 조직에서 그때 프로비저닝을 수정할 필요가 없다면 밤에 동기화 작업을 실행하지 마십시오.
도구가 공개 API 엔드포인트에 연결할 수 없습니다. 방화벽 규칙, 트래픽을 차단하는 프록시 또는 계정 인터넷 액세스 설정과 같은 로컬 설정이 액세스를 방해할 수 있습니다. https_proxy 환경 변수를 http://<proxyAddress>:<port> 또는 https://<proxyAddress>:<port>와 같은 값으로 추가하면 도움이 될 수 있습니다. 다른 경우에는 다음 엔드포인트에 대한 액세스를 허용하십시오: ims-na1.adobelogin.com:443 및 usermanagement.adobe.io:443. 이것은 실행 계정에 대해 이러한 엔드포인트에 대한 액세스를 지워서만 로컬에서 해결할 수 있습니다.
로컬 프록시 서버의 SSL 검사가 이를 야기합니다.
해결책 1: PEM 형식(예: thecert.crt)의 프록시 루트 CA 인증서를 얻으십시오. DER 형식인 경우 다음 openssl 명령으로 PEM으로 변환하십시오: openssl x509 -inform DER -in thecert.crt -out thecert.pem -outform PEM. PEM 파일은 -----BEGIN CERTIFICATE----- 및 -----END CERTIFICATE----- 줄 사이에 base64로 인코딩된 문자열을 표시합니다. REQUESTS_CA_BUNDLE이라는 환경 변수를 생성하고 그 값을 thecert.pem의 경로로 설정하십시오.
해결책 2: Windows에서는 운영 체제와 Python이 설치된 드라이브와 다른 드라이브에서 도구가 실행될 경우 이 오류가 발생할 수 있습니다. 전체 스크립트를 운영 체제가 있는 드라이브로 이동하십시오. 그것이 선택 사항이 아니라면, 신뢰할 수 있는 루트 CA가 포함된 cacert.pem 파일을 다른 드라이브에 복사하고 그 경로를 REQUESTS_CA_BUNDLE로 설정하십시오. 프록시가 SSL 트래픽도 검사하는 경우 프록시 인증서가 신뢰되도록 프록시 루트 CA 인증서 콘텐츠를 cacert.pem에 복사하십시오. 기본 Python 설치에서는 인증서 번들을 C:\Python36\Lib\site-packages\certifi\cacert.pem에 보관합니다.
해결책 3: API 엔드포인트 ims-na1.adobelogin.com 및 usermanagement.adobe.io에 대해 프록시에서 SSL 검사를 비활성화합니다.
인증 및 자격 증명
umapi_api_key에 대한 자격 증명 저장소 항목이 누락되었을 수 있습니다.자격 증명 저장소에 항목을 만드세요.OS 레벨 저장소에 자격 증명 저장에 대한 User Sync Tool 문서를 참조하세요.
현재 연결된 사용자에 대한 항목이 누락되었지만 다른 사용자 계정에서 자격 증명 웹 스토어에 값이 추가되었을 수도 있습니다. 항목을 추가하거나 사용자 계정을 전환하세요.
- 문제를 빠르게 식별할 수 없는 경우 키 쌍을 다시 발급하세요.
- Windows에서 스크립트를 실행할 때 umapi_private_key_data 속성을 사용하지 마세요. 대신 키를 암호화하고 자격 증명 관리자에 암호를 저장하세요.
- 다른 형식으로 키 쌍을 발급한 경우 RSA 256, 2048비트 개인 키를 시도해 보세요.
- connector-umapi.yml 파일에서 secure_priv_key_pass_key: umapi_private_key_passphrase를 설정했을 수 있습니다. 자격 증명 저장소의 일치하는 항목과 관련 값이 일치하는지 확인하세요.
Adobe Admin Console에서 [설정], [인증 설정]으로 이동하세요. 사용자에게 가장 쉬움(암호 만료 없음) 이외의 옵션이 선택되었을 수 있습니다. [더 보안] 또는 [가장 보안] 옵션은 통합과 연결된 기술 계정의 암호를 만료시킬 수 있습니다. 이를 수정하려면 새 통합을 만들고 connector-umapi.yml 파일에서 메타데이터를 갱신하세요. 이에 대한 수정 사항이 배포되었지만 2018년 10월 이전에 만들어진 통합에 영향을 줄 수 있습니다.
- connector-umapi.yml 파일의 tech_acct 값이 Adobe Developer Console의 통합에 있는 기술 계정 ID와 다를 수 있습니다. 현재 통합에서 기술 계정 ID를 확인하고 파일에 복사하십시오.
- 통합의 공개 인증서가 만료되었을 수 있습니다. 개인 키와 공개 키를 갱신하고, 공개 키를 업로드한 후, 기존 개인 키를 새 키로 교체하십시오. connector-umapi.yml 파일의 경로가 올바른 파일을 가리키는지 확인하십시오.
- 통합이 올바른 조직을 위한 것인지 확인하십시오. Adobe Developer Console의 왼쪽 상단 모서리에 있는 드롭다운에서 조직을 선택한 후, 다른 메타데이터(조직 ID, 시크릿, 클라이언트 ID)와 함께 기본 통합의 기술 계정 ID를 확인하십시오.
이 오류는 이전 통합에서 나타납니다. 동일한 목적으로 사용되는 기존 통합과 함께 Adobe Developer Console에서 새 통합(또는 프로젝트)을 만드십시오. 새 통합은 새로운 자격 증명을 제공하므로 connector-umapi.yml 파일에서 자격 증명을 업데이트하십시오.키 쌍(개인 키와 공개 키)이 재발행되었을 가능성이 높으므로 새 개인 키로 기존 키를 교체해야 합니다.
LDAP 및 그룹
- LDAP에 해당 정확한 이름의 그룹이 존재하지 않습니다. 그룹의 올바른 LDAP 이름을 추가하십시오.
- 선언된 base_dn 하에서 그룹을 찾을 수 없습니다(connector-ldap.yml 파일 참조). 그룹을 포함하도록 base_dn 값을 변경하십시오. 이는 주로 base_dn이 가능한 한 광범위하지 않고 특정 OU를 가리킬 때 발생합니다.
출력의 사용자 그룹 group_name이 Adobe 측에 존재하지 않습니다. 만드십시오. 사용자 그룹이 아닌 제품 라이선스 구성(PLC)의 이름을 설정하려는 경우, 기업 디렉터리에서 해당 그룹 만들기에 대한 User Sync Tool 문서를 참조하십시오.
관심 그룹이 하위 도메인에 있는 반면 host 값이 루트 도메인 중 하나일 수 있습니다. 사용자 그룹이 있는 하위 도메인으로 host 값을 변경하십시오. 사용자나 그룹이 루트 도메인과 하위 도메인 모두에 있는 경우, 루트 도메인에서 글로벌 카탈로그 포트를 사용하고 하위 도메인 그룹을 Global 대신 Universal로 변경하십시오. 글로벌 카탈로그를 사용한 호스트 값 예시: ldap://domain.local:3268 또는 ldaps://domain.local:3269. 글로벌 카탈로그 포트를 사용할 때 base_dn을(를) 빈 값으로 설정하세요: base_dn: "".
사용자 및 계정 생성하기
계정을 만드는 데 사용된 도메인이 조직에서 클레임되지 않았거나 신뢰되지 않을 수 있습니다.Adobe Admin Console의 설정에서 활성 도메인에 대해 녹색 플래그나 점이 나타납니다.그렇지 않은 경우, 도메인 클레임 과정을 완료하면 이 문제를 해결할 수 있습니다.
Federated ID 계정을 만들려고 했지만 디렉터리는 Enterprise ID용으로 생성되었거나 그 반대의 경우입니다.user-sync-config.yml 파일에서 user_identity_type 속성을 찾으세요.Adobe Admin Console에 표시된 디렉터리 유형과 일치하도록 값을 설정하세요(설정, 신원, 도메인, 해당 도메인의 디렉터리 유형 값 순으로).
때때로 @claimed-domain.com 도메인은 Azure 또는 Google 커넥터를 설정하여 계정을 Admin Console에 동기화한 다른 조직이 소유하고 있으며, 해당 도메인은 User Sync Tool을 사용하여 @claimed-domain.com 형식의 계정을 동기화하는 다른 조직에 위임됩니다.이 메시지는 도구가 LDAP 서버에서 user@claimed-domain.com 계정을 추출하여 보조 조직에서 생성하려고 하지만, 주 조직에서 Azure 또는 Google 커넥터를 통해 계정이 아직 생성되거나 동기화되지 않았을 때 나타납니다.Azure 또는 Google 커넥터를 사용하는 조직에서 user@claimed-domain.com 계정을 생성하거나 동기화한 다음, 수탁 조직에서 User Sync Tool로 동기화를 다시 시도하세요.
이 일반적인 오류는 여러 원인이 있지만, 일반적인 문제는 생성 작업에 사용된 도메인이 Azure 또는 Google 동기화 설정 하에 있는 것입니다.확인하려면 시스템 관리자 계정으로 Adobe Admin Console에 로그인하고, 설정으로 이동하여 도메인을 보유한 디렉터리를 선택한 다음 [동기화] 탭을 선택하세요.동기화 소스 카드가 있는 경우, 수정 방법은 동기화를 어떻게 계속할지에 따라 달라집니다:
- Azure 또는 Google 커넥터가 동기화를 수행해야 하는 경우, 동기화 소스 설정을 계속하고 User Sync Tool을 완전히 제거하세요.
- User Sync Tool이 동기화를 수행해야 하는 경우, [설정으로 이동]을 선택한 다음 페이지 하단의 [동기화 제거]를 선택하세요.그러면 도구가 평상시와 같이 실행됩니다.
동기화 소스 카드가 없는 경우, 현재 도구가 도메인이 다른 콘솔(소유 조직)에서 위임된 콘솔에서 실행 중일 수 있습니다.해당 조직에 Azure 또는 Google 동기화가 켜져 있어 이 오류가 발생할 수 있습니다.먼저 소유 콘솔에서 계정을 동기화한 다음, 도구를 사용하여 현재 콘솔에서 계정을 생성하세요.
이 중 어느 것도 해당하지 않는 경우 엔터프라이즈 지원팀에 문의하세요.
