Auth

카카오워크가 Bot 서버로 전달하는 요청을 검증하기 위해 다음과 같은 API를 사용합니다.

auth.jwks

카카오워크가 Bot 서버로 전달하는 요청을 검증하기 위한 공개키 목록(JSON Web Key Set)을 조회합니다.

카카오워크는 Request URL·Callback URL로 요청(반응형 메시지·Modal)을 전달할 때 Authorization 헤더에 Bearer {JWT} 형식의 토큰을 함께 보냅니다. 이 토큰은 RS256으로 서명되어 있으며, 토큰 헤더의 kid 와 같은 kid 를 가진 공개키로 서명을 검증할 수 있습니다.

• 이 API는 Rate Limit 적용 대상이 아닙니다.
• 공개키는 변경될 수 있으므로, 토큰의 kid 와 일치하는 키를 찾지 못하면 이 API를 다시 호출해 키 목록을 갱신하세요.

Request

Request Syntax

코드예제auth.jwks Request Syntax

  curl -X GET https://api.kakaowork.com/v1/auth.jwks \
       -H "Authorization: Bearer {YOUR_APP_KEY}"

Request Header

Request Header에 대한 상세는 다음과 같습니다.

Request Elements

요구하는 파라미터가 없습니다.

Response

Response Syntax

코드예제auth.jwks Response Syntax

{
        "success": true,
        "keys": [
                {
                        "kty": "RSA",
                        "use": "sig",
                        "alg": "RS256",
                        "kid": "tiger-ex-v1",
                        "e": "AQAB",
                        "n": "zvsr5IeY8aAJ1vSykEKQ..."
                }
        ]
}

Response Elements

Response Elements에 대한 상세는 다음과 같습니다.