사용 중인 플랜
모든 Suite Team, Growth, Professional, Enterprise 또는 Enterprise Plus
Support Team, Professional 또는 Enterprise
이 문서에서 설명된 기능은 2026년 5월 11일부터 6월 12일까지 모든 Suite 및 Support 플랜에 배포됩니다. 계정에 아직 이 기능이 표시되지 않을 수도 있습니다. 참조 자세한 내용은 이 공지 사항을 참조하세요.

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

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

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

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

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

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

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

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

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

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

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

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

  1. 주 메뉴에서 API 연동을 클릭합니다.
  2. 오른쪽 위에서 연동 추가를 클릭합니다.
  3. 연동 추가 창에서 다음을 수행합니다.
    1. 연동 서비스 이름 필드에서 연동 서비스를 설명하는 이름을 지정합니다.
    2. (선택 사항) 설명 필드에 기억하는 데 도움이 되는 연동 서비스에 대한 설명을 입력합니다.
    3. '인증 전용' 연동 서비스로 설정을 선택합니다.
    4. 저장을 클릭합니다.
  4. 왼쪽 사이드바의 시나리오 아래에서 실패 에 커서를 갖다 대고 옵션 메뉴( )을 클릭하고 삭제를 선택합니다. 사용자 지정 권한 부여의 경우 성공 시나리오만 필요합니다. 대체 시나리오는 삭제할 수 없습니다.
  5. 성공 시나리오 페이지에서 + 버튼을 클릭하여 다음 세부 정보로 두 개의 세션 매개변수를 만듭니다.
    • 토큰
      • 키: 토큰 (정확히 다음과 같이 작성되어야 함)
      • 쿼리: 토큰을 정의하는 값을 입력합니다. 예: 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 제공