AEM의 ServiceNow 서비스 및 구성요소에 대한 통합 설정을 구성합니다.

  • 릴리스 버전: Xanadu
  • 업데이트 날짜 2024년 08월 01일
  • 소요 시간: 5분
  • Adobe Experience Manager(AEM) 인스턴스와 통합할 ServiceNow 서비스 및 구성요소를 설정해야 합니다.

    AEM에서 ServiceNow 서비스를 사용하도록 설정

    AEM의 ServiceNow 서비스에 대해 다음과 같은 유형의 구성 설정을 정의할 수 있습니다.

    AEM의 ServiceNow 구성요소 사용에 대한 설정

    AEM 인스턴스에서 Knowledge API 엔드포인트를 사용하려면 ServiceNow 인스턴스에 CORS(교차 원본 자원 공유) 규칙을 정의해야 합니다. 자세한 내용은 AEM에서 ServiceNow API 엔드포인트에 액세스하기 위한 교차 원본의 자원 공유 규칙 정의 문서를 참조하십시오.

    ServiceNow 서비스의 OSGi 구성 설정 정의

    Adobe Experience Manager(AEM)의 ServiceNow 구성요소에서 사용하는 ServiceNow 서비스에 대한 OSGi 구성 설정을 정의합니다.

    시작하기 전에

    필요한 역할: AEM 관리자

    프로시저

    1. https://<AEM_hostname>:<AEM_port>/system/console/configMgr 형식으로 URL을 사용하여 AEM에서 웹 콘솔에 액세스합니다.
    2. ServiceNow 구성을 검색합니다.
    3. 이름 열에서 ServiceNow 구성 링크를 클릭하십시오.
    4. 구성 설정에 대한 값을 제공합니다.
      표 1. ServiceNow 구성 설정
      필드 설명
      기본 인스턴스 URL ServiceNow 인스턴스의 전체 URL입니다.
      지식베이스 관련 지식 문서가 포함된 지식베이스의 시스템 식별자(sys_id). 여러 항목을 입력하는 경우 지식베이스를 쉼표로 구분합니다.
      주:
      빈 값은 적절한 권한이 있는 사용자가 ServiceNow 인스턴스의 모든 지식베이스 문서에 액세스할 수 있음을 나타냅니다.
      모든 언어로 문서 표시 ServiceNow 구성요소에 대한 지식 문서를 모든 언어로 표시합니다.
    5. 저장을 클릭합니다.

    Adobe Experience Manager의 ServiceNow 서비스에 대한 로그 파일 설정을 구성

    인증 프로세스에서 문제를 식별하는 데 도움이 되도록 디버그 로그를 생성하기 위해 Adobe Experience Manager(AEM)에서 ServiceNow 서비스의 로그 파일 설정을 구성합니다.

    시작하기 전에

    필요한 역할: AEM 관리자

    프로시저

    1. https://<AEM_hostname>:<AEM_port>/system/console/configMgr 형식으로 URL을 사용하여 AEM에서 웹 콘솔에 액세스합니다.
    2. 다음으로 이동 OSGi (오즈지) > 구성.
    3. logs/project-servicenow-components.log: info를 검색하고 선택합니다.
    4. 기본 필드 값을 확인하거나 사용자 지정 구성에 고유한 값을 입력합니다.
      표 2. 로거 구성 설정
      필드
      로그 수준 디버그
      로그 파일 ServiceNow 로그 파일의 경로입니다.
      메시지 패턴 로그 메시지 형식을 지정하기 위한 메시지 형식 패턴입니다.
      로거 ServiceNow 로그인 서비스의 로거 이름입니다.
      가성성 계층 구조에서 더 높은 수준에 연결된 어펜더에 로그를 보낼 수 없도록 하는 옵션입니다.
    5. 저장을 클릭합니다.

    AEM에서 ServiceNow API 엔드포인트에 액세스하기 위한 교차 원본의 자원 공유 규칙 정의

    AEM(Adobe Experience Manager) 인스턴스에서 지식 관리 REST API, Case API 또는 CSM 첨부 파일 API 엔드포인트에 액세스하려면 ServiceNow 인스턴스에 교차 원본 자원 공유(CORS) 규칙을 정의합니다.

    시작하기 전에

    CORS 규칙을 정의하는 API가 구성되어 있는지 확인합니다.
    • 지식 문서에 대한 지식 관리 REST API 엔드포인트를 사용하도록 Knowledge API 플러그인(sn_km_api)을 활성화합니다. 자세한 내용은 지식 관리 REST API를 참조하십시오.
    • 고객 서비스 케이스에 대한 케이스 API 엔드포인트를 사용하려면 Customer Service 플러그인(com.sn_customerservice)을 활성화하십시오. 자세한 내용은 케이스 API를 참조하십시오.
    • glide.rest.attachment_csm_api.allowed_tables 시스템 속성을 구성하고 케이스 첨부 파일에 대한 CSM 첨부 파일 API 엔드포인트를 사용하려면 케이스 [sn_customerservice_case] 테이블을 포함합니다. 자세한 내용은 CSM 첨부 파일 API를 참조하십시오.

    필요한 역할: web_service_admin

    이 태스크 정보

    프로시저

    1. 다음으로 이동 모두 > 시스템 웹 서비스 > CORS 규칙.
    2. 새로 만들기를 클릭합니다.
    3. CORS 규칙 양식의 필드에 내용을 입력합니다.
      표 3. CORS 규칙 양식
      필드 설명
      이름 CORS 규칙을 식별할 이름입니다.
      REST API CORS 규칙이 적용되는 REST API입니다.
      • 지식 문서의 경우, 지식 관리 REST API [sn_km_api/knowledge]를 선택하십시오.
      • 고객 서비스 케이스의 경우 케이스 [sn_customerservice/case]를 선택하십시오.
      • 케이스 첨부 파일의 경우 CSM 첨부 파일 API [now/attachment_csm]를 선택하십시오.
      도메인 CORS 규칙이 적용되는 AEM 인스턴스입니다.
      최대 나이 클라이언트 세션을 캐시하는 시간(초)입니다.
    4. HTTP 메서드 관련 목록에서 HTTP 메서드를 선택하여 웹 서비스 제공자에게 요청을 보냅니다.
      • 지식 문서의 경우 GET을 선택합니다.
      • 고객 서비스 케이스의 경우 GET, PUT, POST를 선택합니다.
      • 케이스 첨부 파일의 경우 GET, POST, DELETE를 선택합니다.
    5. 케이스 API의 경우, HTTP 헤더 관련 목록의 노출된 헤더 필드에 X-Total-Count를 입력하십시오.
    6. 제출을 클릭합니다.