연결된 앱 관리
설정하러 가기스트리머가 내 채널에 연결한 외부 앱을 확인하고 연결을 해제하는 방법입니다.
목차
스트리머가 외부 앱에 내 채널 접근을 허용하고, 허용한 앱을 확인하거나 해제하는 방법입니다. 앱을 쓰기만 하는 스트리머는 앱을 등록하거나 client_id 를 만들 필요가 없습니다.
연결된 앱 확인
대시보드 → 관리 · 설정 → 개발자센터(API)의 내 채널에 연결된 앱 카드에서 내가 동의해 내 채널에 접근 중인 앱을 봅니다. 스트리머 본인만 열 수 있으며 매니저 대행 화면에는 나오지 않습니다.
| 열 | 내용 |
|---|---|
| 앱 | 앱 이름 |
| 개발자 | 앱을 등록한 계정의 닉네임 |
| 허용한 권한 | 내가 허용한 권한 이름 |
| 연결일 | 처음 허용한 날짜와 시각 |
| 해제 | 연결을 끊는 버튼 |
허용한 앱이 없으면 연결된 앱이 없어요 가 나오며 정상입니다. 모르는 앱이나 더 쓰지 않는 앱은 해제합니다.
동의 화면
앱이 내 채널 접근을 요청하면 브라우저에 앱 인가 요청 화면이 나옵니다. 로그인하지 않았다면 먼저 치지직으로 로그인하고 이 화면으로 돌아옵니다.
| 화면에 나오는 것 | 확인할 점 |
|---|---|
… 채널로 로그인됨 |
연결될 채널입니다. 다른 계정이면 위쪽 로그아웃을 누르고 앱에서 연결을 다시 시작합니다. |
| 앱 이름과 설명 | 내가 쓰려는 앱이 맞는지 봅니다. |
| 요청 권한 목록 | 권한 이름과 scope 가 함께 나옵니다. 뜻은 Scope 목록에 있습니다. |
인가 후 … 로 이동합니다. |
허용하거나 거부한 뒤 돌아갈 앱 주소입니다. |
허용하기를 누르면 앱이 위 권한 범위 안에서 내 채널 데이터에 접근할 수 있습니다. 거부하면 앱에는 거부했다는 결과만 전달되고, 이미 연결된 앱이었다면 기존 연결은 그대로 남습니다. 권한을 골라 일부만 허용할 수는 없습니다.
- 이미 연결된 앱이 허용한 권한 안에서 다시 요청하면 동의 화면 없이 바로 앱으로 돌아갑니다. 허용한 범위를 넘는 권한을 요청할 때만 동의 화면이 다시 나오고, 그때 허용하면 허용한 권한이 이번 요청 목록으로 바뀝니다. 연결일은 처음 날짜 그대로입니다.
- 동의 화면에는 앱을 만든 개발자가 나오지 않습니다. 허용한 뒤 목록의 개발자 칸에서 확인할 수 있습니다.
- 명령어를 바꾸는 권한(
commands:write)이나 시청자 포인트를 보는 권한(points:read)은 채널 데이터를 다룹니다. 앱과 권한을 확인하고 믿을 수 있는 앱에만 허용하세요.
연결 해제
- 내 채널에 연결된 앱에서 앱 줄의 해제를 누릅니다.
'…' 앱의 접근을 해제할까요? 해제 즉시 이 앱의 토큰이 무효화됩니다.창에서 확인을 누릅니다.앱 연결을 해제했습니다알림이 뜨고 목록에서 빠집니다.
해제하면 바로 아래가 적용됩니다.
- 이 채널에 대한 동의, 토큰, 아직 쓰지 않은 인가 코드가 지워집니다. 앱의 API 호출은 401 이 됩니다.
- 앱이 열어 둔 실시간 연결은 늦어도 30초 안에 끊깁니다.
- 같은 앱을 쓰는 다른 채널에는 영향이 없습니다.
- 앱이 이미 바꾼 명령어·룰렛 설정은 되돌아가지 않습니다.
다시 쓰려면 앱에서 연결(인가)을 새로 요청하고 동의 화면에서 다시 허용합니다.
스트리머와 앱 개발자의 역할
| 구분 | 스트리머 | 앱 개발자 |
|---|---|---|
| 하는 일 | 동의 화면에서 권한을 확인하고 허용·거부, 연결된 앱 확인·해제 | 앱 등록, 리디렉션 URL·권한·시크릿 관리, 앱 서버에서 토큰 교환·갱신 |
| 필요한 것 | 치지직 계정 로그인 | 개발자센터의 앱(client_id, client_secret)과 앱 서버 |
| 쓰는 화면 | 동의 화면, 내 채널에 연결된 앱 | 내 애플리케이션과 앱 상세 (앱 등록·관리) |
- 내가 만든 앱이라도 채널 데이터를 다루려면 그 채널 스트리머의 동의가 필요합니다. 내 채널이면 내 계정으로 동의 화면에서 허용합니다.
- 동의는 로그인한 계정의 채널에 대해 이뤄집니다. 매니저는 스트리머 대신 허용하거나 해제할 수 없고, 매니저 계정으로 허용하면 매니저 자신의 채널이 연결됩니다.
참고
연동이 끊겼을 때
| 증상 | 확인할 것 | 해결 |
|---|---|---|
API 가 401 유효하지 않거나 만료된 액세스 토큰입니다 |
액세스 토큰 만료(2시간), 스트리머의 연결 해제, 앱 권한 축소로 남은 권한 없음, 앱 삭제 | 앱은 리프레시 토큰으로 갱신하고, 갱신이 invalid_grant 면 스트리머에게 다시 동의를 받습니다. 스트리머는 목록에 앱이 남아 있는지 봅니다. |
API 가 403 이 작업에는 '…' 권한(scope)이 필요합니다 |
토큰에 그 작업의 권한이 없음 (요청하지 않았거나, 스트리머가 더 좁게 다시 허용했거나, 앱 선언에서 빠짐) | 앱 선언에 권한을 넣고 그 권한을 담아 다시 요청한 뒤 스트리머가 허용합니다. |
| 인가 화면에 인가할 수 없습니다 | client_id 가 틀렸거나 redirect_uri 가 등록한 값과 다름 |
등록한 리디렉션 URL 과 글자 그대로 맞춥니다. |
콜백에 error=invalid_scope, 또는 처음 연결하는 스트리머에게 인가할 수 없습니다 (invalid_scope) |
요청 scope 가 비었거나 앱이 선언하지 않은 권한이 있음 |
앱 상세의 API Scopes 와 요청 scope 를 맞춥니다. |
토큰 교환·갱신이 invalid_client |
시크릿을 재발급한 뒤 옛 시크릿을 씀 | 앱 서버 설정을 새 시크릿으로 바꿉니다. |
| 실시간 연결이 4401 로 끊김 | 토큰 무효, events:subscribe 없음, 연결 해제 |
갱신한 토큰으로 다시 연결합니다. |
시크릿 재발급은 앱 서버 설정을 바꾸는 작업이고, 연결 해제는 그 채널의 토큰을 무효로 만드는 작업입니다. 재발급해도 연결은 끊기지 않고, 해제해도 시크릿은 그대로입니다. 오류 코드는 인가·토큰 오류와 공통 오류를 참고하세요.
이 가이드로 해결이 안 됐나요?
디스코드로 문의하기