Integration Hub

Integration Hub는 CXone과 타사 인증 및 웹 서비스의 통합을 처리하는 표준 방법을 제공합니다. 웹 서비스는 애플리케이션, 플랫폼 또는 시스템이 될 수 있습니다.

Integration Hub는 CXone에서 REST API 호출로 작업할 수 있는 방법들 중 하나입니다. Integration Hub를 사용하면 연결을 추가하고 여러 위치에서 사용할 수 있다는 이점이 있습니다. 다른 방법을 사용하면 사용할 때마다 연결을 구축해야 합니다.

또한 Integration Hub는 MTLS 및 암호를 포함하여 강화된 보안을 제공합니다. 암호로 추가된 변수는 암호화되어 직접 접근할 수 없습니다.

연결 및 연결 템플릿

연결은 CXone에서 사용할 API 요청 세부 정보, 인증 세부 정보 및 변수를 정의합니다.  연결에 모든 유형의 연결 정보가 포함될 필요는 없습니다. 지원되는 정보 유형의 모든 조합을 유지할 수 있습니다.

Integration Hub에 추가하는 각 연결은 연결 템플릿을 기반으로 생성됩니다. 템플릿에서는 템플릿을 사용하여 구성되는 모든 연결에 적용될 기본 정보를 정의합니다. 여기에는 포함되는 내용:

• 연결 중인 웹 서비스의 이름.
• 통합 방법. 현재 REST API가 유일하게 지원되는 방법입니다.
• 인증 유형 (있는 경우). 현재 OAuth 2.0 또는 인증 없음을 선택할 수 있습니다.
• 인증을 위한 사용자 정의 헤더 (필요 시).
• 템플릿 기반 요청에서 사용할 수 있는 동사. 동사는 데이터 검색, 레코드 생성 등 연결된 웹 서비스로 수행할 수 있는 작업입니다.

Integration Hub에는 NICE가 소유한 시스템 템플릿과 사용자가 직접 생성한 템플릿의 두 가지 유형의 템플릿이 있습니다. 시스템 템플릿은 Integration Hub와 함께 제공되며 삭제할 수 없습니다. 다음 옵션이 있습니다.

• NICE CXone 개발 포털: API 개발자 포털 에서 이용 가능한 엔드포인트와 통합하여 Studio 프레임워크 작업에 대한 종속성을 줄입니다. OAuth 2.0 인증을 사용합니다. 인증을 확인하려면 Discovery URL을 사용합니다. 클라이언트 인증서는 지원하지 않습니다.

시스템 템플릿과 사용자가 만든 템플릿은 수정할 수 없습니다. 하지만 사용자 지정 템플릿은 삭제할 수 있습니다. 나중에 사용자 지정 템플릿에서 내용을 변경해야 하는 경우, 기존 템플릿을 삭제하고 새 템플릿을 생성할 수 있습니다. 연결 자체는 수정될 수 있습니다. 사용자 지정 템플릿을 삭제해도 해당 템플릿을 사용하여 생성된 연결에는 영향을 미치지 않습니다.

템플릿은 Integration Hub의 연결 라이브러리에서 사용할 수 있습니다. 연결 내역은 Integration Hub의 '내 연결' 아래에 나열됩니다. 최대 50개의 연결을 만들 수 있습니다. 템플릿 수에는 제한이 없습니다.

요청

요청은 API 호출입니다. 요청을 통해 웹 서비스 연결에 사용되는 다음 정보를 지정합니다.

• URL: 연결하려는 리소스의 위치.
• 메서드(동사): 데이터 검색, 새 레코드 생성 등 요청을 통해 수행하려는 작업. Integration Hub는 GET, PUT, POST, DELETE, TRACE, PATCH, HEAD, OPTIONS 동사를 지원합니다. 연결에 사용할 수 있는 동사는 연결 생성에 사용되는 템플릿에서 정의합니다.
• 헤더: 요청에 대한 추가 정보가 포함된 요청의 일부분. 여기에는 언어, 자격 증명 등이 포함될 수 있습니다.
• 쿼리 매개변수: API 요청으로 정보를 전달하는 방법. 키-값 쌍으로 구성됩니다. 응답으로 반환된 데이터를 필터링, 정렬, 사용자 정의 또는 제어할 때 사용할 수 있습니다.
• 본문: 요청의 내용. 형식은 연결하는 API의 요구 사항에 따라 다릅니다.  본문의 미디어 유형은 연결할 리소스가 예상하는 것과 일치해야 합니다. MIME 유형 또는 콘텐츠 유형이라고도 합니다. 지원되는 옵션과 연관된 콘텐츠 헤더는 다음과 같습니다.
  • ApplicationJson: application/json
  • ApplicationJsonPatch: application/json-patch+json
  • FormURLEncoded: application/x-www-form-urlencoded
  • TextHtml: text/html
  • TextPlain: text/plain
  • TextXml: text/xml

각 Integration Hub 연결에는 최대 50개의 요청이 있을 수 있습니다. 한 번에 활성이 될 수 있는 요청 수에는 제한이 없습니다.

수동 요청 및 Studio 요청

Integration Hub는 두 가지 연결 요청 옵션을 지원합니다.

• 수동: 요청 추가 페이지의 옵션을 사용하여 Integration Hub에 수동 요청을 작성합니다. 그 안에 비밀을 사용할 수 있습니다. 수동 요청은 일반적으로 데이터가 변경되지 않는 경우에 사용됩니다. Studio 스크립트 없이 Integration Hub에서 직접 실행할 수 있습니다. Studio 스크립트에서도 실행할 수 있습니다.

• Studio: 경우에 따라 API 요청을 Integration Hub에서 수동 요청으로 작성할 수 없습니다. 예를 들어 경로 매개변수, 변수 대체가 필요하거나 SOAP 웹 서비스에 연결되는 요청은 Studio 스크립트에서 작성해야 합니다. 그러나 Integration Hub 연결에서 이러한 요청을 추적할 수 있습니다. Studio 요청 옵션을 사용하여 가능합니다. Studio 요청은 연결에 해당하는 모든 수동 요청과 함께 연결의 요청 탭에 표시됩니다.

변수

Integration Hub를 사용하면 값 쌍을 변수로 저장할 수 있습니다. 변수는 기본적으로 암호화되지 않습니다. 하지만 변수를 암호로 바꿔서 암호화할 수 있습니다. 변수를 암호로 표시하면 암호나 키와 같은 민감 정보의 보안이 강화됩니다.

변수는 변수를 생성한 연결에서 사용할 수 있습니다. Studio 스크립트에서 연결 또는 인증 요청을 실행하는 경우 스크립트에서 해당 연결의 변수를 사용할 수 있습니다.

비밀은 저장 시 암호화됩니다. Integration Hub는 AES(Advanced Encryption Standard)를 사용하여 데이터를 암호화합니다. 그리고 암호화된 데이터베이스에 저장됩니다. 데이터의 암호를 해독하는 유일한 시간은 실행 시점입니다.

Integration Hub Studio 작업

인증을 사용하거나 Studio 스크립트에서 요청하려면 다음 Studio 작업을 사용합니다.

• CONNECTAUTH: 이 작업을 통해 스크립트에 인증 세부 정보나 비밀을 포함할 수 있습니다. 인증 세부 정보 및 변수는 Integration Hub 연결에서 정의해야 합니다.
• CONNECTREQUEST: 이 작업을 통해 Integration Hub 연결에 정의된 요청을 사용할 수 있습니다. 이 작업은 수동 요청과 Studio 요청을 사용할 때 필요합니다.

Integration Hub Studio 작업에 대한 주요 정보

• Integration Hub가 필요합니다. CXone 시스템에서 Integration Hub가 활성화되어 있지 않으면 작업이 작동하지 않습니다.
• 스크립트에 각 작업의 인스턴스를 두 개 이상 포함할 수 있습니다.
• 변수 대체를 사용하여 다양한 요청을 실행하거나 단일 스크립트에서 둘 이상의 연결에 대한 인증을 사용할 수 있습니다.
• CXone에서 API 호출을 수행하는 다른 방법들과 마찬가지로 연결된 웹 서비스로부터 응답을 수신하고 적절하게 처리하려면 추가 스크립팅이 필요합니다.
• CONNECTAUTH는 사용자 정의를 허용하지 않습니다. Integration Hub의 연결에 정의된 대로 인증 요청을 실행합니다.