외부 콘텐츠 커넥터에 대한 사용자 권한 설정 구성

  • 릴리스 버전: Australia
  • 업데이트 날짜 2026년 03월 12일
  • 소요 시간: 5분

    • 외부 콘텐츠 커넥터의 사용자 권한 크롤링에 대한 기본 필드 매핑을 재정의합니다. 소스 시스템의 사용자 보안 주체와 인스턴스의 ServiceNow AI Platform® 사용자를 고유하게 식별하는 필드를 지정합니다. 필요에 따라 사용자 지정 스크립트를 실행하여 보안 주체 ID를 인스턴스의 사용자 ID와 비교하기 전에 변환합니다.

    시작하기 전에

    필요한 역할: sn_ext_conn.xcc_admin 또는 admin

    이 태스크 정보

    외부 콘텐츠 커넥터에 대한 사용자 권한 크롤링은 소스 시스템에서 사용자 보안 주체를 검색하여 인스턴스의 ServiceNow AI Platform 사용자에게 매핑합니다. 소스 시스템의 사용자 보안 주체는 인스턴스에서 두 명 이하의 사용자에게 매핑되어야 합니다.

    각 외부 콘텐츠 커넥터는 커넥터가 소스 시스템의 사용자 보안 주체에 대한 고유 식별자로 사용하는 미리 정의된 소스 시스템 필드를 지정합니다. 예를 들어, 커넥터는 사용자 이름 또는 이메일 주소 필드를 소스 시스템의 보안 주체 식별자로 지정할 수 있습니다. 모든 커넥터는 기본적으로 사용자 [sys_user] 테이블의 이메일 필드를 인스턴스 내 ServiceNow AI Platform 사용자의 고유 식별자로 사용합니다.

    소스 시스템 주체 또는 인스턴스 사용자의 식별자로 다른 필드를 지정해야 하는 경우 외부 콘텐츠 커넥터에 대한 기본 필드 선택을 재정의할 수 있습니다. 필요에 따라 사용자 지정 스크립트를 실행하여 소스 필드 값을 변환하여 인스턴스 내 ServiceNow AI Platform 사용자의 대상 필드 값과 일치하도록 할 수 있습니다.

    프로시저

    1. 다음으로 이동 모두 > 외부 콘텐츠 커넥터 > 외부 콘텐츠 관리자 홈.
    2. 커넥터 목록에서 설정을 수정할 외부 콘텐츠 커넥터에 대한 기록을 선택합니다.
    3. 커넥터 편집기의 설정 탭에서 사용자 권한 설정을 선택합니다.
    4. 매핑 원본 섹션에서 사용자 보안 주체를 고유하게 식별하는 값이 있는 소스 시스템 필드를 선택합니다.
      예를 들어 소스 시스템 보안 주체가 이메일 주소로 고유하게 식별되는 경우 소스 시스템의 이메일 필드를 선택할 수 있습니다.
    5. 옵션: 사용자 지정 스크립트 옵션을 선택하고 코드 편집기에 사용자 지정 스크립트 함수를 입력합니다.
      인스턴스의 ServiceNow AI Platform 대상 필드 값과 비교하기 전에 소스 시스템 필드 값을 변환하려는 경우에만 이 단계를 수행해야 합니다. 예를 들어, 소스 시스템에서 beth.anglin 과 같은 사용자 ID로 사용자 보안 주체를 식별하지만 ServiceNow AI Platform 인스턴스 사용자는 beth.anglin@example.com 와 같은 이메일 기반 사용자 이름을 사용하는 경우, 스크립트를 사용하여 사용자 이름과 ServiceNow AI Platform 올바르게 일치하도록 각 사용자 보안 주체 ID에 @ 기호와 도메인 이름을 추가할 수 있습니다.
      경고:
      시스템은 외부 콘텐츠 커넥터의 사용자 권한 크롤링으로 검색된 각 사용자 보안 주체에 대한 사용자 지정 스크립트를 실행합니다. 실행 시간이 긴 스크립트는 사용자 매핑 크롤링 성능에 영향을 줄 수 있습니다. 스크립트는 가능한 한 단순하게 유지하십시오.
      사용자 지정 스크립트에는 커넥터의 소스 시스템에서 사용자에 대한 수신 필드 값을 사용자의 사용자 [sys_user] 테이블에서 ServiceNow AI Platform사용자를 일치시키는 데 사용되는 출력 값으로 변환하는 기능이 포함되어야 합니다. 이전 예시를 계속 진행하면서 다음 사용자 지정 스크립트를 정의하여 기본 사용자 이름을 도메인의 사용자 이메일 주소로 변환할 수 있습니다.
      /**
* Maps the incoming field value of the user from the source system to an output value that will be used to match the user in the ServiceNow platform.
* Supported return types are "string" and "number".
*/

var mapSourceUser = function(sourceUserValue) {
  // Append @ symbol and domain name to source user ID
  //   Source field value format = user
  //   Destination field value format = user@example.com

  return sourceUserValue + "@example.com";
}

mapSourceUser(sourceUserValue);
      기본 스크립트에는 사용자 지정 스크립트의 기초로 사용할 수 있는 몇 가지 코드 예제가 포함되어 있습니다. 코드 편집기의 코드를 기본 스크립트로 되돌리려면 기본 스크립트로 재설정 을 선택한 다음 재설정을 선택합니다.
      중요사항:
      스크립트 시작 시 또는 해당 함수에 대한 후속 호출 시 mapSourceUser 함수 선언을 변경하지 마십시오. 원하는 사용자 지정 필드 값 변환을 구현하려면 중괄호 안의 함수 본문만 편집해야 합니다.
    6. 매핑 대상 섹션에서 인스턴스의 ServiceNow AI Platform 사용자에 대한 고유 식별자로 사용할 필드를 선택합니다.
      기본 식별자 필드는 사용자 [sys_user] 테이블의 이메일 필드입니다.
    7. 테스트를 선택한 후 다음 단계를 수행하여 사용자 권한 설정을 테스트합니다.
      1. 프롬프트가 표시되면 외부 콘텐츠 커넥터의 소스 필드에 대한 샘플 값을 입력합니다.
        예를 들어 소스 시스템에서 이메일 주소를 사용하여 사용자 보안 주체를 식별하는 경우 abel.tuter@example.com 입력할 수 있습니다.
      2. 테스트 실행을 선택하고 테스트가 완료될 때까지 기다립니다.
        시스템은 사용자 권한 설정을 사용하여 소스 시스템에서 지정된 사용자 보안 주체와 일치하는 인스턴스 사용자를 찾습니다 ServiceNow AI Platform . 취소를 선택하거나 모달 창을 닫아 이 프로세스를 중단하고 테스트를 취소할 수 있습니다.
      3. 테스트 결과를 확인합니다.
        일치
        이 상태는 테스트가 단일 ServiceNow AI Platform 인스턴스 사용자와 성공적으로 일치했음을 나타냅니다.
        일치 항목 없음
        이 상태는 테스트가 일치하는 인스턴스 사용자가 없음 ServiceNow AI Platform 을 나타냅니다.
        불확실
        이 상태는 테스트가 원하는 한 고유 사용자가 아닌 여러 ServiceNow AI Platform 인스턴스 사용자와 일치했음을 나타냅니다.
      4. 테스트 결과에 따라 적절한 단계를 수행합니다.
      • 사용자 권한 설정 편집기로 돌아가려면 닫기를 선택합니다.
      • 다른 입력으로 테스트를 반복할 수 있도록 샘플 값 입력 필드로 돌아가려면 새 테스트를 선택합니다. 이전 입력을 편집하여 다른 값이 어떻게 작동하는지 확인할 수 있습니다.
    8. 테스트가 완료되면 저장을 선택합니다.

    결과

    외부 콘텐츠 커넥터가 수정된 사용자 권한 설정으로 업데이트됩니다.

    사용자 지정 스크립트를 구성한 경우 사용자 권한 크롤링 중에 발생한 스크립트 오류는 커넥터의 크롤링 상세 페이지의 경보 섹션에 기록됩니다. 외부 콘텐츠 커넥터의 크롤링 이력 항목에서 크롤링 상세 페이지에 액세스하는 방법에 대한 자세한 내용은 다음 문서를 참조하십시오 외부 콘텐츠 커넥터에 대한 크롤링 이력 검토.

    다음에 수행할 작업

    수정된 설정을 사용하여 소스 시스템에서 업데이트된 사용자 권한을 검색하려면 편집한 외부 콘텐츠 커넥터에 대한 사용자 권한 크롤링을 생성하고 실행합니다. 사용자 권한 크롤링 생성 및 실행에 대한 자세한 내용은 다음 문서를 참조하십시오 외부 콘텐츠 커넥터에 대한 사용자 권한 크롤링 생성.