인바운드 통신을 위한 메시지 인증 구성

기본 또는 OAuth 대신 API에 가상 에이전트 대한 메시지 인증을 구성할 수 있습니다. 메시지 인증에는 정적 또는 해시 토큰 구성, 제공자 인증 설정 및 채널 ID 설정이 포함됩니다.

시작하기 전에

인바운드 REST 엔드포인트 검토 및 인바운드 인증 구성 문서에서 설명하는 단계를 따르십시오.

필요한 역할: admin

프로시저

1. 토큰 유형에 따라 다음 중 하나를 수행하여 토큰을 구성합니다.
   • 정적 토큰:
     1. 모두로 이동한 다음 필터에 token_verification.list를 입력합니다.
     2. 새로 만들기를 클릭합니다.
     3. 토큰 검증 양식의 필드에 내용을 입력합니다.

        필드	설명
        이름	인증 토큰의 이름입니다(예: B2BTestAppAuthToken).
        설명	B2B 테스트 애플리케이션 인증 토큰과 같은 인증 토큰에 대한 설명입니다.
        토큰	일반 프로그래밍 또는 스크립팅 언어를 사용하여 생성한 인증 토큰을 입력하거나 관련 링크에서 보안 토큰 생성 을 클릭합니다.

     4. 제출을 클릭합니다.
   • 해시 토큰:
     1. 모두로 이동한 다음 필터에 hash_message_verification.list를 입력합니다.
     2. 새로 만들기를 클릭합니다.
     3. 해시 메시지 확인 양식의 필드에 내용을 입력합니다.

        필드	설명
        이름	인증 토큰의 이름입니다(예: B2BTestAppAuthToken).
        설명	B2B 테스트 애플리케이션 인증 토큰과 같은 인증 토큰에 대한 설명입니다.
        비밀	인증 토큰(임의 문자열)입니다.

     4. 제출을 클릭합니다.
2. 토큰 기반 인증을 위한 제공자 인증을 설정합니다.
   1. 모두로 이동한 다음 필터에 message_auth.list를 입력합니다.
   2. 새로 만들기를 클릭합니다.
   3. 메시지 인증 양식의 필드에 내용을 입력합니다.

      필드	설명
      이름	B2B 인증 토큰과 같은 메시지 인증의 이름입니다.
      제공자	제공자의 이름입니다.
      그룹 이름	필요하지 않습니다.
      서비스 포털	필요하지 않습니다.
      인바운드 메시지 검증	만든 정적 토큰 또는 해시 메시지 토큰을 선택합니다.
      아웃바운드 메시지 작성	이 필드는 현재 API에서 가상 에이전트 지원되지 않습니다. 만든 정적 토큰 또는 해시 메시지 토큰을 선택합니다.
      아웃바운드 서비스 토큰	이 필드는 현재 API에서 가상 에이전트 지원되지 않습니다.

   4. 제출을 클릭합니다.
3. 채널 ID를 설정합니다.
   1. 모두로 이동한 다음 필터에 sys_cs_provider_application.list를 입력합니다.
   2. VA 봇-봇 제공자 애플리케이션 기록을 선택하여 엽니다.
   3. 제공자 채널 ID 양식에서 메시지 인증 필드를 찾아 이전에 설정한 메시지 인증을 선택합니다.

      

   4. 업데이트를 클릭합니다.
4. 해시 토큰 기반 인증의 경우에만 요청 헤더에 x-b2b-signature 를 보냅니다.
   이 값은 요청 페이로드의 인코딩된 값으로 HmacSHA1 , 인스턴스에서 ServiceNow 생성된 토큰을 사용합니다. 예를 들어 Postman에서 다음 단계를 수행합니다.
   1. 헤더에서 x-b2b-signature 를 {{hashValue}}로 설정합니다.

      

   2. 사전 요청 스크립트 영역에서 토큰을 다음과 같이 설정합니다.

      pm.environment.set('hashValue', CryptoJS.HmacSHA1(JSON.stringify(JSON.parse(request.data)), '<insert your token>').toString(CryptoJS.enc.Hex));

      

다음에 수행할 작업

API에 대한 가상 에이전트 출력 응답 REST 엔드포인트 및 아웃바운드 인증 구성