API 토큰 만들기와 폐기하기

토큰으로 할 수 있는 일

토큰은 그것을 만든 사람을 대신해, 만든 시점에 활성화되어 있던 팀에서 동작합니다. 만들 때 허용한 일만 할 수 있습니다. 다음 중 하나를 고릅니다.

  • 스크린과 장면 제어: 스크린, 콘텐츠, 장면을 보고, 스크린에 콘텐츠를 표시하고, 장면을 시작하고 중지할 수 있습니다. Bitfocus Companion에 쓸 때 고르세요.
  • 읽기 전용: 스크린, 콘텐츠, 장면을 보기만 하고 다른 것은 할 수 없습니다.
  • 전체 접근 권한(디자인 만들기 포함): 위의 모든 것에 더해 디자인도 만들 수 있습니다.

토큰을 만든 사람이 팀에 대한 접근 권한을 잃으면 그 토큰은 동작하지 않습니다.

토큰 만들기

  1. 설정 > 연결 메뉴로 이동하세요.
  2. API 토큰 아래에서 새 API 토큰 버튼을 클릭하세요.
  3. 토큰에 이름을 지정하세요. 예를 들어 행사장 이름이나 토큰을 쓰는 프로그램 이름이 좋습니다.
  4. 접근 권한 항목에서 토큰이 할 수 있는 일을 고르세요.
  5. 토큰 만들기 버튼을 클릭하세요.
  6. 복사 버튼을 클릭하고 토큰을 안전한 곳에 보관하세요. 예를 들어 그 토큰이 필요한 프로그램 안에 넣어 두면 됩니다.
  7. 완료 버튼을 클릭하세요.

토큰은 한 번만 표시됩니다. 잃어버렸다면 폐기하고 새로 만드세요.

토큰은 만들 때 활성화되어 있던 팀에서 동작합니다. 다른 팀의 스크린을 제어하려면 먼저 그 팀으로 전환한 다음 별도의 토큰을 만드세요. 프로그램마다 별도의 토큰을 쓰면 다른 프로그램을 멈추지 않고 하나만 폐기할 수 있습니다.

기본적으로 소유자와 관리자가 토큰을 만들 수 있습니다. 이는 역할에 따라 정해집니다. 역할별 설정은 팀과 역할 관리 문서에서 바꿀 수 있습니다.

토큰을 만들면 오는 메일

누군가 토큰을 만들면 만든 사람과 계정 소유자에게 이메일이 갑니다. 이메일에는 어떤 토큰인지, 누가 만들었는지, 어느 팀인지, 언제인지, 무엇을 할 수 있는지가 적혀 있습니다. 이메일에는 토큰 자체가 들어 있지 않습니다. 짐작 가는 바가 없는 토큰이라면 즉시 폐기하세요.

토큰 확인하기

API 토큰 카드에는 토큰마다 다음 정보가 표시됩니다.

  • 이름과 접근 권한의 종류
  • 토큰을 구별할 수 있도록 토큰의 마지막 네 글자
  • 팀
  • 마지막으로 사용된 시점 또는 사용 안 함

소유자는 계정에 있는 모든 사람의 토큰을 볼 수 있습니다. 그 밖의 사람은 자신의 토큰만 봅니다.

토큰 폐기하기

  1. 설정 > 연결 메뉴로 이동하세요.
  2. 토큰 옆의 폐기 버튼을 클릭하세요.
  3. 폐기 버튼을 한 번 더 클릭해 확인하세요.

그 토큰을 쓰는 모든 것이 즉시 멈춥니다.

만료되는 토큰

일 년 동안 쓰지 않은 토큰은 저절로 폐기됩니다. 한 번도 쓰지 않은 토큰은 만든 날부터 셉니다. 다시 필요하면 새 토큰을 만드세요.

한도

계정마다 만들 수 있는 토큰 수에는 한도가 있습니다. 한도에 이르면 Screenbird가 먼저 토큰 하나를 폐기하라고 안내합니다.

연결된 앱

토큰 대신 Screenbird 로그인으로 연결한 앱은 같은 페이지의 별도 연결된 앱 카드에 나타납니다. 연결 해제 버튼을 클릭하면 앱을 제거할 수 있습니다.

직접 연결 만들기

Screenbird에는 공개 API가 있습니다. 요청마다 토큰을 Bearer 토큰으로 보내세요. 모든 요청과 요청별 필요 권한이 담긴 API 전체 설명은 api.screenbird.app/v1/openapi.json에 있습니다.

© screenbird.app