사용자가 Zendesk API에 액세스하는 데 사용할 수 있는 두 가지 인증 방법이 있습니다. 첫 번째는 API 토큰이라는 자동 생성된 비밀번호를 사용하는 것입니다. 두 번째는 API 토큰과 다른 OAuth 액세스 토큰을 사용하는 것입니다.
두 가지 인증 방법 모두 새 계정에서는 기본적으로 사용 중지되어 있습니다. 이 문서에서는 사용자들이 Zendesk API에 액세스하는 방법을 관리하기 위해 각 방법을 사용 설정 및 사용 중지하는 방법에 대해 설명합니다.
Zendesk API 사용에 대한 자세한 내용은 다음 페이지를 참조하세요.
API에 대한 API 토큰 액세스 관리하기
사용자는 API 토큰을 사용하여 API 요청을 인증할 수 있습니다. API 토큰은 자동 생성된 비밀번호로 사용자 이름과 함께 사용하여 API 요청을 인증할 수 있습니다. 또한 연동을 위한 2단계 인증의 일부로 사용될 수도 있습니다. 각 API 토큰은 계정에서 인증된 사용자 모두 사용할 수 있으며 특정 사용자와 연결되지 않습니다. 한 개 이상의 토큰을 동시에 활성화할 수 있습니다.
API 토큰은 OAuth 액세스 토큰과 같지 않습니다. developer.zendesk.com에서 API 토큰과 액세스 토큰의 차이점을 참조하세요.
API 토큰을 사용하여 API 요청을 인증하려면 developer.zendesk.com에서 API 토큰을 참조하세요.
API 토큰 액세스 사용 설정하기
API 토큰 액세스는 기본적으로 사용 중지되어 있습니다. 사용자가 API 토큰을 사용할 수 있게 하려면 먼저 관리 센터에서 API 토큰 액세스를 사용 설정해야 합니다.
API 토큰 액세스를 사용 설정하려면 다음과 같이 하세요.
- 관리 센터의 사이드바에서 앱 및 연동 서비스를 클릭한 다음 API > Zendesk API를 선택합니다.
- 설정 탭에서 토큰 액세스를 사용 설정합니다.
API 토큰 생성하기
API 토큰을 생성하려면 관리자 권한이 있어야 하며 계정에 API 토큰 액세스가 사용 설정되어 있어야 합니다.
API 토큰을 생성하려면 다음과 같이 하세요.
- 관리 센터의 사이드바에서 앱 및 연동 서비스를 클릭한 다음 API > Zendesk API를 선택합니다.
-
활성 API 토큰 오른쪽에 있는 API 토큰 추가 버튼을 클릭합니다.
토큰이 생성되어 표시됩니다.
- (선택 사항) API 토큰 설명을 입력합니다.
- 토큰을 복사하여 안전한 곳에 붙여 넣습니다. 저장을 클릭하여 이 창을 닫으면 전체 토큰이 다시는 표시되지 않습니다.
-
저장을 클릭하여 Zendesk API 페이지로 돌아갑니다.
토큰을 클릭하여 다시 열면 토큰의 잘린 버전이 표시됩니다.
API 토큰 삭제하기
API 토큰은 비밀번호와 같습니다. 계정에서 인증된 모든 사용자나 이메일 주소가 있는 사람은 누구나 이를 사용하여 API 요청을 인증할 수 있습니다. API 토큰이 손상되었음을 알게 되면 즉시 삭제하세요. 토큰을 삭제하면 영구적으로 비활성화됩니다.
API 토큰을 삭제하려면 다음과 같이 하세요.
- 관리 센터의 사이드바에서 앱 및 연동 서비스를 클릭한 다음 API > Zendesk API를 선택합니다.
- 목록에서 토큰을 선택한 다음 오른쪽에 있는 삭제를 클릭합니다.
API에 대한 OAuth 토큰 액세스 관리하기
OAuth 액세스 토큰을 사용하여 API 요청을 인증할 수 있습니다. OAuth는 민감한 정보인 API 토큰을 저장 및 사용하지 않고서도 애플리케이션이 Zendesk 데이터에 액세스할 수 있는 안전한 방법을 제공합니다.
API 토큰처럼 관리 센터에서 직접 OAuth 액세스 토큰을 만들 수는 없습니다. 먼저 관리 센터에서 OAuth 클라이언트를 만든 다음 정의된 OAuth 권한 부여 플로우에서 OAuth 클라이언트를 사용하여 OAuth 액세스 토큰을 만들어야 합니다.
OAuth 액세스 토큰은 API 토큰과 같지 않습니다. developer.zendesk.com에서 API 토큰과 액세스 토큰의 차이점을 참조하세요.
이 섹션에서는 다음과 같은 주제를 다룹니다.
OAuth 액세스 토큰으로 API 요청을 인증하려면 developer.zendesk.com에서 OAuth 액세스 토큰을 참조하세요.
OAuth 클라이언트 만들기
OAuth 클라이언트를 사용하면 API 요청을 인증하는 데 사용할 수 있는 OAuth 액세스 토큰을 만들 수 있습니다. OAuth 액세스 토큰은 API 토큰과 다릅니다. OAuth 액세스 토큰은 Zendesk 사용자들의 API 토큰을 저장 및 사용하지 않고서도 애플리케이션이 Zendesk API에 액세스할 수 있는 안전한 방법을 제공합니다.
OAuth 클라이언트를 만들려면 다음과 같이 하세요.
- 관리 센터의 사이드바에서 앱 및 연동 서비스를 클릭한 다음 API > Zendesk API를 선택합니다.
- OAuth 클라이언트 탭을 선택합니다.
- 클라이언트를 만들려면 OAuth 클라이언트 추가 버튼을 클릭하고 애플리케이션을 Zendesk에 등록하기에 나와 있는 안내를 따릅니다.
- 클라이언트를 삭제하려면 목록에서 클라이언트를 선택한 다음 오른쪽에 있는 삭제를 클릭합니다.
이제 OAuth 클라이언트를 사용하여 하나 이상의 OAuth 액세스 토큰을 만듭니다.
OAuth 클라이언트로 액세스 토큰 만들기
관리 센터에서 OAuth 클라이언트를 만든 후에는 정의된 권한 부여 플로우와 함께 사용하여 OAuth 액세스 토큰을 만들 수 있습니다.
API로 OAuth 클라이언트를 사용하여 권한 부여 플로우 없이 액세스 토큰을 만들 수도 있습니다. API 토큰을 사용하여 이러한 API 요청을 인증할 수 있습니다. developer.zendesk.com에서 API로 OAuth 액세스 토큰 만들기 및 사용하기를 참조하세요.
OAuth 클라이언트 및 토큰 삭제하기
OAuth 클라이언트를 삭제하여 이 클라이언트로 만든 모든 액세스 토큰을 비활성화할 수 있습니다. 개별 액세스 토큰을 취소할 수도 있습니다.
OAuth 클라이언트를 삭제하려면 다음과 같이 하세요.
- 관리 센터의 사이드바에서 앱 및 연동 서비스를 클릭한 다음 API > Zendesk API를 선택합니다.
- OAuth 클라이언트 탭을 선택합니다.
- 목록에서 클라이언트를 선택한 다음 오른쪽에 있는 삭제를 클릭합니다.
특정 액세스 토큰을 취소하려면 다음과 같이 하세요.
- developer.zendesk.com에서 액세스 토큰 취소하기를 참조하세요.