인증 서비스 연동 가이드

인증 서비스 연동을 통해 인증기능을 제공하고 있습니다. 등록된 인증 서버와의 연동을 통해 인증이 완료된 사용자에게만 답변을 응답힙니다. 최초 1회의 인증이 완료되었다면, 해당 사용자의 정보가 유지되는 동안은 추가 인증절차 없이 답변을 응답합니다.

인증 서비스 연동하기

① 챗봇 설정의 서비스 연동 탭을 클릭한 후 인증 서비스의 연동 버튼을 클릭합니다.

chatbot-2-12-01.png

② 인증 URL을 입력합니다.

chatbot-2-12-02.png

  • 사용자가 질문을 입력하면 챗봇은 인증된 사용자인지 판단하기 위해 POST {URL}/confirm을 호출하여 입력된 인증 서버에 인증 여부를 확인합니다.
  • {URL}은 도메인 관리자가 입력한 인증 URL입니다.
  • 챗봇은 사용자의 ID와 플랫폼 정보를 함께 전달합니다.
{
  "userId": "${userId}",
  "platform": "${platform}",
  "domainCode":"${domainCode}"
}
필수 타입 설명 비고
userId Y String 사용자의 아이디
platform Y String 메신저 플랫폼
domainCode Y String 현재 도메인의 코드
  • 만약 인증된 사용자인 경우 인증서버는 아래와 같이 응답을 전달해주어야 합니다.
{
  "valid": true
}
필수 타입 설명 비고
valid Y Boolean 사용자가 인증된 사용자라면 true가 리턴

인증 요청 메시지인증 실패 메시지, 인증 오류 메시지를 입력합니다.

chatbot-2-12-03.png

  • 만약 인증되지 않은 사용자, 인증에 실패한 사용자인 경우 챗봇은 인증 요청 메시지 또는 인증 실패 메시지와 함께 Login 링크가 담긴 URL 버튼을 사용자에게 응답합니다.
  • GET {URL}/login?userId=${userId}&platform=${platform}&domainCode=${domainCode}

④ 만약 Login에 성공하였다면 인증서버는 Invoke URL을 호출합니다.

chatbot-2-12-04.png

  • Invoke URL을 호출하는 경우 아래의 데이터가 포함되어 있어야 합니다.
{
  "domainCode": "String",
  "platform": "String",
  "userId": "String",
  "nonce": "Option[String]",
  "needPush": true
}
필수 타입 설명 비고
domainCode Y String 도메인을 구분하기 위한 도메인 코드
platform Y String 메신저 플랫폼 정보
userId Y String 사용자구분을 위한 아이디
nonce N String link에 사용하기 위한 임시 암호 값 nonce 값이 존재할 경우 link api를 호출할 때 받은 nonce값을 담아 호출합니다.
needPush Y Boolean 답변을 구한 뒤 push 가 필요할 경우 사용합니다. line, talktalk만 지원됩니다.
  • 로그인 성공 요청이 챗봇 빌더에 전달되면 해당 사용자의 인증 성공에 대한 확인으로 link 리퀘스트를 요청합니다.
  • POST {URL}/link
{
  "userId": "String",
  "platform": "String",
  "domainCode": "String",
  "nonce": "Option[String]"
}
필수 타입 설명 비고
userId Y String 사용자 구분을 위한 아이디
platform Y String 메신저 플랫폼 정보
domainCode Y String 도메인을 구분하기 위한 도메인 코드
nonce N String 받은 nonce 값이 존재할 경우 api를 호출할 때 받은 값을 담아 호출합니다.
  • POST {URL}/link를 호출했을 때 200OK가 전달되면 link에 성공했다고 판단합니다.
  • link에 성공하면 처음 사용자가 진입했을 때 질문했던 내용에 대해 답변을 찾아 응답합니다.
  • link에 실패하면 인증 실패 메시지와 함께 재 로그인을 유도합니다.
  • 만약 로그인 성공 요청에서 needPush: true인 경우 push가 가능한 플랫폼이면 구해진 답변을 push 합니다.

""에 대한 건이 검색되었습니다.

    ""에 대한 검색 결과가 없습니다.

    처리중...