사용 중인 플랜
모든 Suite Team, Growth, Professional, Enterprise 또는 Enterprise Plus
Support Team, Professional 또는 Enterprise

연동 빌더는 API 키, 무기명 토큰, 사용자 이름 및 비밀번호, OAuth 2.0을 포함한 표준 권한 부여 유형을 지원합니다. 하지만 조직의 필요와 워크플로우에 따라 표준 권한 부여만으로는 충분하지 않을 수 있습니다. 따라서 연동 빌더는 조직의 인증 및 권한 부여 솔루션과 작동하는 사용자 지정 인증 전용 연동 유형도 지원합니다.

이 문서에서는 다음과 같은 주제를 다룹니다.

  • 사용자 지정 권한 부여에 대한 정보
  • 사용자 지정 권한 부여 구성하기
  • 데이터 연동 서비스 만들기
  • 사용자 지정 권한 부여 테스트하기

사용자 지정 권한 부여에 대한 정보

사용자 지정 인증 전용 연동 서비스는 토큰 및 해당 만료에 대한 요청을 한 다음, 권한 부여를 위해 데이터 또는 주 연동 서비스로 전달하여 데이터 요청을 합니다.

전반적인 사용자 지정 권한 부여 플로우는 다음과 같습니다.

  1. 권한 부여 요청: 구성된 인증 전용 연동 서비스가 서버에 액세스 토큰을 검색할 수 있는 권한을 요청하는 요청을 보냅니다. 서버가 AI 상담사로부터 오는 요청을 인증하는 경우에는 액세스 토큰의 검색과 만료 시간(있는 경우)을 승인합니다.
  2. 토큰 처리 문서를 참조하세요. 서버가 액세스 토큰으로 응답한 후 연동 서비스는 두 가지 주요 정보 즉, 토큰 매개변수 자체와 토큰이 유효한 기간을 결정하는 expiresIn 매개변수를 저장합니다.
  3. 토큰을 데이터 연동에 전달합니다. 이 두 매개변수(token 및 expiresIn)는 다음 단계인 데이터 연동 서비스로 전달됩니다. 토큰은 데이터 연동의 후속 요청을 인증하는 데 사용됩니다. 토큰은 내부에서 설정 및 처리되며 세션이나 대화 데이터에 절대 노출되지 않습니다.
  4. 데이터에 대한 사용자 지정 권한 부여 요청: 액세스 토큰이 마련되면 데이터 연동이 이제 필요한 데이터를 검색하여 대화를 강화하는 데 사용됩니다.

아래 플로우차트는 사용자 지정 권한 부여 플로우를 보여줍니다.

사용자 지정 권한 부여 구성하기

연동 빌더에서 연동 서비스를 만드는 정상적인 프로세스의 일부로 사용자 지정 권한 부여를 구성합니다.

참고: 사용자 지정 권한 부여를 위해 한 번에 두 개 이상의 환경을 사용하지 마세요. 프로덕션, 샌드박스 등으로 나누려면 별도의 권한 부여 연동 서비스로 나누세요.

연동 빌더에서 사용자 지정 권한 부여를 구성하려면 다음과 같이 하세요.

  1. 주 메뉴에서 API 연동을 클릭합니다.
  2. 오른쪽 위에서 연동 추가를 클릭합니다.
  3. 연동 서비스 추가 창에서 다음과 같이 합니다.
    1. 연동 서비스 이름 필드에서 연동 서비스를 설명하는 이름을 지정합니다.
    2. (선택 사항) 설명 필드에 기억하는 데 도움이 되는 연동 서비스에 대한 설명을 입력합니다.
    3. '인증 전용' 연동으로 설정을 선택합니다.
    4. 저장을 클릭합니다.
  4. 왼쪽 사이드바의 시나리오 아래에서 실패 에 커서를 갖다 대고 옵션 메뉴( ) 삭제를 선택합니다. 
    사용자 지정 권한 부여의 경우 성공 시나리오만 필요하고 실패 시나리오를 삭제해야 합니다. 하지만 대체 시나리오를 삭제할 수는 없습니다.
  5. 성공 시나리오 페이지에서 + 버튼을 클릭하여 다음과 같은 세부 정보로 두 개의 세션 매개변수를 만듭니다.
    • 토큰
      • Key: token (정확하게 이와 같이 작성되어야 함)
      • 쿼리: 토큰을 정의하는 값을 입력합니다. 예: data.access_token
    • 만료일
      • 키: expiresIn (정확하게 이와 같이 작성되어야 함)
      • 쿼리: 토큰 만료를 정의하는 값을 입력합니다. 예: data.expires_in
        토큰 만료는 데이터 응답에 포함되지 않을 수 있습니다. 그런 경우에는 원하는 값(초 단위)을 하드 코딩할 수 있습니다. 예: 3600
        토큰 만료를 설정하는 것이 좋습니다. 테스트할 때 오류가 발생하면 새 토큰이 발급되기 전에 기다려야 하는 시간입니다. 만료가 없으면 토큰이 무기한 설정되므로 문제를 해결하는 동안 새 토큰을 발급할 수 없습니다.
  6. 저장을 클릭합니다.

데이터 연동 서비스 만들기

다음은 위의 단계에서 만든 사용자 지정 인증 전용 연동을 사용할 데이터 연동을 만듭니다. 평소대로 새 연동 서비스를 만들 때처럼 하세요. 도움말은 연동 서비스 빌더 설명을 참조하세요.

데이터 연동 서비스를 만들려면 다음과 같이 하세요.

  1. 왼쪽 사이드바의 환경 아래에서 환경(예: 프로덕션)을 선택합니다.
  2. 권한 부여 탭의 권한 부여 유형 드롭다운 필드에서 사용자 지정을 선택합니다.
  3. API 권한 부여 연동 드롭다운 필드에서 위에서 만든 사용자 지정 인증 전용 연동을 선택합니다.
  4. 헤더 탭을 선택하고 헤더 추가를 클릭합니다.
  5. 다음 필드를 입력합니다.
    • 키: Authorization
    • 값: 무기명{{apiToken}} (정확하게 다음과 같이 작성되어야 함)
  6. 저장을 클릭합니다.

사용자 지정 권한 부여 테스트하기

사용자 지정 인증 전용 연동을 구성한 후에는 테스트하는 것이 좋습니다. 도움말은 기능 테스트를 참조하세요.

문제 해결 statusCode: null

또한 연동 서비스를 테스트할 때 아래 이미지와 같이 “statusCode: null” 메시지를 접할 수도 있습니다.

먼저, 사용자 지정 인증 전용 연동이 위의 단계 에 따라 올바르게 구성되었는지 다시 확인하세요.

이제 어디에서 오류가 발생했는지 기록해 둡니다. 인증 연동에 있는 경우에는 무언가가 올바르게 구성되어 있지 않거나 요청을 하는 URL이 잘못되었을 수 있습니다. 이 경우에는 엔지니어가 어떤 문제에 대한 자세한 정보를 제공할 수 있는지 확인하는 것이 좋습니다.

위의 단계를 수행했지만 여전히 이 오류가 발생하는 경우 토큰이 만료될 때까지 기다렸다가 다시 시도하세요.

이러한 문제 해결 단계를 모두 시도했지만 연동 서비스가 여전히 작동하지 않으면 CSM에 문의하여 추가 지원을 받으세요.

 

번역 고지 사항: 본 문서는 콘텐츠에 대한 기본적인 이해를 제공하기 위해 자동 번역 소프트웨어를 사용하여 번역되었습니다. 정확한 번역을 제공하고자 합당한 노력을 기울였으나 Zendesk는 번역의 정확성을 보장하지 않습니다.

번역된 문서에 포함된 정보의 정확성과 관련하여 질문이 있으시면 문서의 공식 버전인 영문 버전을 참조하시기 바랍니다.

Zendesk 제공