OAuth 액세스 토큰을 사용하여 API 요청을 인증할 수 있습니다. OAuth는 민감한 정보인 API 토큰을 저장 및 사용하지 않고서도 애플리케이션이 Zendesk 데이터에 액세스할 수 있는 안전한 방법을 제공합니다.

사용 중인 플랜
모든 Suite Team, Growth, Professional, Enterprise 또는 Enterprise Plus
Support Team, Professional 또는 Enterprise

검증된 AI 요약 ◀▼

API 액세스에 대한 OAuth 토큰을 관리하세요. 이 접근 방식은 API 토큰을 저장하거나 사용할 필요 없이 안전한 API 인증을 보장합니다. OAuth 클라이언트를 만들어 토큰을 생성하고, 필요할 때 토큰을 보고 삭제하며, 클라이언트 세부 정보를 편집하세요. Enterprise 플랜에서는 감사 로그를 보면서 OAuth 클라이언트 활동을 추적하세요.

위치: 관리 센터 > 앱 및 연동 서비스 > API > OAuth 클라이언트

OAuth 액세스 토큰을 사용하여 API 요청을 인증할 수 있습니다. OAuth는 민감한 정보인 API 토큰을 저장 및 사용하지 않고서도 애플리케이션이 Zendesk 데이터에 액세스할 수 있는 안전한 방법을 제공합니다.

API 토큰처럼 관리 센터에서 직접 OAuth 액세스 토큰을 만들 수는 없습니다. 먼저 관리 센터에서 OAuth 클라이언트를 만든 다음 정의된 OAuth 권한 부여 플로우에서 OAuth 클라이언트를 사용하여 OAuth 액세스 토큰을 만들어야 합니다.

OAuth 액세스 토큰은 API 토큰과 같지 않습니다. Zendesk 개발자 문서에서 API 토큰과 액세스 토큰의 차이점을 참조하세요.

이 문서는 다음 섹션으로 구성되어 있습니다.

  • OAuth 클라이언트 만들기
  • OAuth 클라이언트로 액세스 토큰 만들기
  • OAuth 클라이언트 토큰 보기
  • OAuth 클라이언트 토큰에 대한 범위 보기
  • OAuth 클라이언트 토큰 삭제하기
  • OAuth 클라이언트 편집하기
  • OAuth 클라이언트 삭제하기
  • OAuth 클라이언트에 대한 감사 로그 보기(Enterprise)

OAuth 액세스 토큰으로 API 요청을 인증하려면 developer.zendesk.com에서 OAuth 액세스 토큰을 참조하세요.

OAuth 클라이언트 만들기

OAuth 클라이언트를 사용하면 API 요청을 인증하는 데 사용할 수 있는 OAuth 액세스 토큰을 만들 수 있습니다. OAuth 액세스 토큰은 API 토큰과 다릅니다. OAuth 액세스 토큰은 Zendesk 사용자들의 API 토큰을 저장 및 사용하지 않고서도 애플리케이션이 Zendesk API에 액세스할 수 있는 안전한 방법을 제공합니다.

참고: 이 섹션에서는 단일 Zendesk 인스턴스에 대한 OAuth 클라이언트를 만드는 방법에 대해 설명합니다. 글로벌 OAuth 클라이언트를 만들려면 글로벌 OAuth 클라이언트 설정하기를 참조하세요.

이러한 로컬(비전역) OAuth 클라이언트는 2026년 4월 30일 이후에 만든 경우 자동으로 기본 액세스 토큰 및 새로 고침 토큰 만료 시간이 적용됩니다. 만료 한도는 애플리케이션에 OAuth 인증 사용하기를 참조하세요.

OAuth 클라이언트를 만들려면 다음과 같이 하세요.

  1. 관리 센터의 사이드바에서 앱 및 연동 서비스를 클릭한 다음 API > OAuth 클라이언트를 선택합니다.

    관리자가 계정에 추가한 OAuth 클라이언트 목록이 나타납니다.

  2. 클라이언트를 만들려면 OAuth 클라이언트 추가를 클릭하고 애플리케이션을 Zendesk에 등록하기에 나와 있는 안내를 따릅니다.

OAuth 클라이언트로 액세스 토큰 만들기

관리 센터에서 OAuth 클라이언트를 만든 후에는 정의된 권한 부여 플로우와 함께 사용하여 OAuth 액세스 토큰을 만들 수 있습니다. API로 OAuth 클라이언트를 사용하여 권한 부여 플로우 없이 액세스 토큰을 만들 수도 있습니다. API 토큰을 사용하여 이러한 API 요청을 인증할 수 있습니다. 개발자 문서에서 API로 OAuth 액세스 토큰 만들기 및 사용하기를 참조하세요.

OAuth 클라이언트 토큰 보기

OAuth 클라이언트에 대해 만들어 놓은 액세스 토큰을 볼 수 있습니다.

OAuth 클라이언트에 대한 액세스 토큰을 보려면 다음과 같이 하세요.

  1. 관리 센터의 사이드바에서 앱 및 연동 서비스를 클릭한 다음 API > OAuth 클라이언트를 선택합니다.

    OAuth 클라이언트 목록이 나타납니다. 클라이언트 식별자, 이름, 만든 날짜, 토큰 수, 상태를 포함한 OAuth 클라이언트 정보를 표시합니다.

  2. 토큰을 보려면 목록에서 클라이언트를 찾습니다
  3. 클라이언트 옆에 있는 옵션 메뉴 아이콘()을 클릭한 다음 토큰 보기를 선택합니다.

    OAuth 클라이언트에 대한 액세스 토큰 목록이 나타납니다.

    토큰이 없는 클라이언트에게는 토큰 보기 옵션이 표시되지 않습니다.

OAuth 클라이언트 토큰에 대한 범위 보기

범위는 토큰으로 인증된 요청이 데이터를 게시하고, 저장, 삭제할 수 있는지, 아니면 데이터만 가져올 수 있는지를 정의합니다.

OAuth 클라이언트 토큰에 대한 범위를 보려면 다음과 같이 하세요.

  1. 관리 센터의 사이드바에서 앱 및 연동 서비스를 클릭한 다음 API > OAuth 클라이언트를 선택합니다.
  2. 목록에서 클라이언트를 찾습니다.
  3. 클라이언트 옆에 있는 옵션 메뉴 아이콘()을 클릭한 다음 토큰 보기를 선택합니다.
  4. 범위를 보려는 토큰을 찾습니다.
  5. 토큰 옆에 있는 옵션 메뉴 아이콘()을 클릭한 다음 범위 보기를 선택합니다.

OAuth 클라이언트 토큰 삭제하기

OAuth 클라이언트에 대한 토큰이 손상된 것으로 의심되면 삭제해야 합니다. 더 이상 사용되지 않거나 활성화되어서는 안 되는 OAuth 클라이언트를 삭제할 수도 있습니다.

OAuth 클라이언트 토큰을 삭제하려면 다음과 같이 하세요.

  1. 관리 센터의 사이드바에서 앱 및 연동 서비스를 클릭한 다음 API > OAuth 클라이언트를 선택합니다.
  2. 목록에서 클라이언트를 찾습니다.
  3. 클라이언트 옆에 있는 옵션 메뉴 아이콘()을 클릭한 다음 토큰 보기를 선택합니다.
  4. 삭제하려는 토큰을 찾습니다.
  5. 토큰 옆에 있는 옵션 메뉴 아이콘()을 클릭한 다음 삭제를 선택합니다.

OAuth 클라이언트 편집하기

관리 센터를 사용하여 OAuth 클라이언트를 편집할 수 있습니다. 클라이언트 이름, 설명, 로고, 리디렉션 URL 등을 업데이트할 수 있습니다.

OAuth 클라이언트를 편집하려면 다음과 같이 하세요.

  1. 관리 센터의 사이드바에서 앱 및 연동 서비스를 클릭한 다음 API > OAuth 클라이언트를 선택합니다.
  2. 목록에서 클라이언트를 찾습니다.
  3. 클라이언트 옆에 있는 옵션 메뉴 아이콘()을 클릭한 다음 편집을 선택합니다.

    클라이언트의 설명이 편집할 수 있는 필드와 함께 나타납니다.

  4. 필요에 따라 변경 작업을 한 다음 저장을 클릭합니다.

OAuth 클라이언트 삭제하기

OAuth 클라이언트를 삭제하면 클라이언트로 만든 모든 액세스 토큰이 비활성화됩니다. OAuth 클라이언트를 삭제하는 것은 영구적입니다. 이 작업은 실행 취소할 수 없습니다. 클라이언트가 제거되면 클라이언트와 연결된 모든 토큰(있는 경우)도 즉시 취소됩니다.

개별 액세스 토큰을 삭제할 수도 있습니다.

OAuth 클라이언트를 삭제하려면 다음과 같이 하세요.

  1. 관리 센터의 사이드바에서 앱 및 연동 서비스를 클릭한 다음 API > OAuth 클라이언트를 선택합니다.
  2. 목록에서 클라이언트를 찾습니다. 클라이언트 옆에 있는 옵션 메뉴 아이콘()을 클릭한 다음 삭제를 선택합니다.

  3. 확인 대화 상자에서 클라이언트 삭제를 클릭합니다.

OAuth 클라이언트에 대한 감사 로그 보기(Enterprise)

Enterprise 플랜에서 감사 로그는 OAuth 클라이언트와 관련된 활동(생성, 비활성화 또는 재활성화 시점 포함)을 기록합니다.

OAuth 클라이언트에 대한 감사 로그를 보려면 다음과 같이 하세요.

  1. 관리 센터의 사이드바에서 앱 및 연동 서비스를 클릭한 다음 API > OAuth 클라이언트를 선택합니다.
  2. 목록에서 클라이언트를 찾습니다.
  3. 클라이언트 옆에 있는 옵션 메뉴 아이콘()을 클릭한 다음 감사 로그 보기를 선택합니다.

    선택한 OAuth 클라이언트에 적용된 필터와 함께 감사 로그가 열립니다. 감사 로그는 클라이언트와 관련된 활동을 보여줍니다.

번역 고지 사항: 본 문서는 콘텐츠에 대한 기본적인 이해를 제공하기 위해 자동 번역 소프트웨어를 사용하여 번역되었습니다. 정확한 번역을 제공하고자 합당한 노력을 기울였으나 Zendesk는 번역의 정확성을 보장하지 않습니다.

번역된 문서에 포함된 정보의 정확성과 관련하여 질문이 있으시면 문서의 공식 버전인 영문 버전을 참조하시기 바랍니다.

Zendesk 제공