이 문서에서는 Chat API 클라이언트 및 OAuth 토큰을 관리하는 방법에 대한 일반적인 개요를 제공하며, OAuth 액세스 토큰을 만들고 취소하는 것은 물론 기존 클라이언트를 만들고 삭제하는 방법을 자세히 안내해 드립니다.
API 클라이언트는 OAuth 액세스 토큰을 만들어 API 요청을 인증하는 데 사용됩니다. 레거시 Chat 전용 계정을 사용하는 경우에는 다음과 같은 두 가지 방법으로 API 요청을 인증합니다.
- 사용자 이름 및 비밀번호를 사용한 기본 인증
- OAuth 액세스 토큰
Chat+Support 또는 Phase 4 계정을 사용하는 경우에는 다음 한 가지 방법으로만 API 요청을 인증합니다.
- OAuth 액세스 토큰
Chat 계정 유형에 대한 자세한 내용은 Chat 계정 유형에 대한 정보를 참조하세요. API 인증에 대한 자세한 내용은 Chat API 문서에서 보안 및 인증을 참조하세요.
이 문서는 다음 섹션으로 구성되어 있습니다.
API 클라이언트 관리하기
관리자는 Chat 인터페이스에서 활성 API 클라이언트를 쉽게 보고 삭제할 수 있습니다. 사용자는 자신이 만든 클라이언트만 볼 수 있습니다.
활성 클라이언트를 보려면 Chat 대시보드로 가서 설정 > 계정 > API 및 SDK를 선택합니다.
여기에서 보거나 업데이트하려는 클라이언트를 선택할 수 있습니다. 클라이언트 비밀키를 다시 생성하거나 클라이언트를 삭제할 수도 있습니다.
API 클라이언트 만들기
내부용으로 OAuth 토큰을 만드는 경우에는 다음 안내를 따르세요. 타사 연동 서비스용 클라이언트인 경우에는 개발자가 제공한 설치 안내를 따르세요.
클라이언트를 만들려면 Chat 대시보드로 가서 설정 > 계정 > API 및 SDK를 선택한 다음 API 클라이언트 추가 버튼을 클릭합니다.
클라이언트 필드를 작성하는 데 대한 자세한 안내는 Chat API 문서에서 API 클라이언트 추가하기를 참조하세요.
API 클라이언트 삭제하기
클라이언트를 삭제하기 전에 타사 서비스에 어떤 영향을 미칠 수 있는지 반드시 확인하세요. 클라이언트의 리디렉션 URL 필드가 localhost가 아닌 다른 것으로 설정된 경우에는 클라이언트가 외부 연동 서비스와 상호작용할 가능성이 있습니다. 클라이언트를 삭제하면 다른 클라이언트를 만들어야 합니다. 토큰을 만드는 중 외부 연동 서비스의 사용자는 연동 서비스에 Chat 계정에 대한 액세스 권한을 다시 부여해야 합니다. 리디렉션 URL이 localhost인 경우에는 클라이언트가 내부 API 사용을 위해 만들어졌을 가능성이 있습니다.
클라이언트를 삭제하려면 다음과 같이 하세요.
- Chat 대시보드에서 설정 > 계정 > API 및 SDK를 선택한 다음 목록에서 클라이언트를 선택합니다.
- 선택한 항목 삭제 버튼을 클릭합니다.
API로 API 클라이언트를 관리할 수도 있습니다. API 문서에서 OAuth 클라이언트를 참조하세요.
토큰 만들기
API 클라이언트가 있으면 OAuth 액세스 토큰을 만들어 API 요청을 인증할 수 있습니다.
프로덕션 환경을 위한 좀 더 길고 공식적인 방법과 테스트 환경을 위한 좀 더 짧고 편리한 방법, 이 두 가지 방법으로 액세스 토큰을 만들 수 있습니다.
두 방법 모두에 대한 안내는 Chat 연동 계정을 위한 REST API 토큰 생성하기를 참조하세요.
토큰 취소하기
토큰을 만든 사용자만 해당 토큰을 취소할 수 있습니다. 관리자는 다른 사용자가 만든 토큰을 취소할 수 있는 권한이 없습니다.
OAuth 토큰 API를 사용하여 토큰을 취소하세요. 절차는 다음 단계로 구성됩니다.
- 토큰을 나열하여 삭제하려는 토큰의 ID를 가져옵니다.
API 문서에서 토큰 나열을 참조하세요.
토큰이 많은 경우에는 토큰을 만든 대략적인 날짜와 시간을 알면 목록에서 식별하는 데 도움이 됩니다.
- ID로 토큰을 취소합니다.
API 문서에서 토큰 취소를 참조하세요.
추가 리소스
이 문서에서는 API 클라이언트 및 OAuth 액세스 토큰의 일반적인 개요를 제공합니다. 자세한 내용은 다음 문서를 참조하세요.
- Chat API 문서에서 OAuth 인증
- Chat용 REST API 토큰 생성하기