Kakao i Agent::Service Agent 등록::토큰 발급 및 인증

페이지 이동경로

토큰 발급 및 인증

Kakao Developers에서 애플리케이션을 등록을 한 이후에 토큰 발급을 수행해야 합니다. 토큰 발급은 카카오 로그인 기능을 쉽게 구현할 수 있는 도구인 Connect Web에서 수행하며, Connect Web을 사용하기 위해서는 먼저 Kakao Developers에 Connect Web의 서버 도메인을 등록해야 합니다.

서버 도메인 등록

Connect Web의 서버 도메인을 Kakao Developers(Sandbox) 사이트에 등록하는 절차는 다음과 같습니다.

  1. 내 애플리케이션 > 앱 설정 > 플랫폼 메뉴에서 [Web 플랫폼 등록] 버튼을 클릭합니다.

    플랫폼 메뉴 그림플랫폼 메뉴

  2. Web 플랫폼 등록 화면이 팝업하면, 해당 서버 도메인을 등록합니다.

    안내
    Kakao Developers(Sandbox)에는 Sandbox 서버 도메인만 등록해야 합니다.

    • 선택적으로 Stage phase 연동을 원하시면 카카오엔터프라이즈 담당자에게 문의 부탁드립니다.
    • Production phase 연동을 위해 공식 Kakao Developers를 사용하는 경우에는 Production의 서버 도메인만을 추가합니다.

    서버 도메인
    서버 도메인
    Sandbox https://sandbox-connect.i.kakao.com
    Stage https://stage-connect.i.kakao.com
    Production https://connect.i.kakao.com

    서버 도메인 등록하기 그림서버 도메인 등록하기

Connect Web 가입

Connect Web은 카카오 로그인 기능을 보다 쉽게 구현할 수 있는 도구입니다. 사용자의 멀티 디바이스인 애플리케이션, 스피커 또는 SDK 등에서 카카오톡 계정으로 카카오 AI 음성 서비스를 사용하기 위해서는 고객사와 카카오 i 서비스 간 계정 연결 및 설정이 필요하며, 해당 작업은 Connect Web의 가입을 통해 쉽게 구현할 수 있습니다.

안내
사전에 카카오엔터프라이즈 담당자와 협의 후에 Connect Web 가입을 진행 부탁드립니다.
  1. 다음의 명령어를 사용하여 Connect Web의 진입을 요청하면 해당 URL을 획득할 수 있습니다.

    코드예제Connect Web URL Request Syntax

      curl -X GET 'https://sandbox-connect.i.kakao.com/api/open/v0/getEntryUrl?target=test.test'
    

    코드예제Connect Web URL 획득

    {
        "url": "https://sandbox-pf-link.kakao.com/qr/_DKd/pages/_Rmxl?query=target%3Dtest.test",
    	"_code": 200,
    	"_message": "OK"
    }
    

  2. 획득한 URL을 사용하여 모바일 버전의 커넥트웹으로 이동한 후에 카카오 계정을 입력하여 로그인을 진행합니다.

    로그인 화면 그림로그인 화면

  3. Connect Web 서비스의 약관 동의를 진행하고 Connect Web 가입을 완료합니다.

    • 이미 헤이카카오 계정이 있는 경우에는 해당 절차를 건너뛸 수 있습니다.

    약관 동의 그림약관 동의

  4. [확인] 버튼 클릭 시 Redirect, AppScheme, Bot Event와 같은 동작을 실행시킬 수 있으며, 자세한 내용은 카카오엔터프라이즈 담당자와 사전에 협의가 필요합니다.

    • Redirect, AppScheme, Bot Event 방식에서 ticket은 Param에 포함되어 전달됩니다.

    확인 후 동작 실행 그림확인 후 동작 실행

토큰 발급

AIID 발급에 필요한 애플리케이션 사용자 ID와 토큰 정보를 획득하기 위해서는 요청 시 targetticket 값이 사용됩니다.

  • 응답으로는 app_user_id, access_token, refresh_token 값이 반환됩니다.

코드예제애플리케이션 사용자 ID와 토큰 정보 Request Syntax

    curl -X GET 'https://sandbox-connect.i.kakao.com/api/open/v0/getAuthorization?target=test.test&ticket=${TICKET}'

코드예제애플리케이션 사용자 ID와 토큰 정보 Response Syntax

{
    "app_user_id": 49494,
    "access_token": "cjEk45Y_n6sRx_C-peVF2XNUXMmzbEGwLC8UuwrKJuoAAAF3PiS9hQ",
    "refresh_token": "AsIMGg6ld60-yP7g4BzUv4yrzlztt_KXLV1kcwrKJuoAAAF3PiS9gg",
    "expires_in": 7199,
    "_code": 200,
    "_message": "OK"
}

획득 정보

획득 정보 설명
app_user_id 애플리케이션의 사용자 식별 ID 값
access_token 사용자가 로그인에 성공했을 때 발급되는 인증 토큰
refresh_token Access Token 만료 시에 재발급을 위해 사용되는 토큰
expires_in Access Token의 유효 시간(초)
code 응답에 대한 상태 코드
message 코드에 대한 설명 메시지

이 문서가 만족스러운 이유를 알려주세요.
이 문서에 아쉬운 점을 알려주세요.
평가해주셔서 감사합니다.

더 자세한 의견은 documentation@kakaoenterprise.com 으로 제보해주세요.