동기화 토큰이라는 것이 왜 생겼나요?

여러분들이 오해하시고 굉장한… 불만을 가지시는 부분인데, 이 동기화 토큰이라는 것은 애초부터! 원래부터! 있었습니다.

그리고 60회 제한은 제가 설정한 것이 아닙니다. 2019년 첫 사용부터 항상 제한된 상태였습니다.

단지 차이가 있다면 구 해루봇에서는 여러분들께 상황 정보를 감췄고, 신 해루봇은 전부 보여준다는 점이죠.

동기화 토큰 제한으로 발생하는 오류를 마치 심각한 오류로 오해하시는 경우가 너무 많아서, 신 해루봇에서는 모든 정보와 상황을 오픈한 것입니다.

정확히는 Rate limit라고 표현하는데요.

해당 단어가 사용자에게는 썩 와닿지 않는 것 같아서, 제가 임의로 동기화에 필요한 자원이라는 뜻으로 '토큰'이라고 칭하고 있습니다.

제가 설명서에 대략적으로 써두긴 했었는데, 그럼에도 불구하고 동기화 과정에 대한 설명이 많이 부족한 것 같아서 뒤늦게나마 덧붙여보겠습니다. 배경 지식이 없으면 조금 어려운 내용일 수도 있는데 최대한 쉽게 풀어보겠습니다.

해루봇에서 공유 중인 모든 파일은 Github라는 사이트의 리포지토리에 올라가 있습니다.

여기서 리포지토리란 대충 개발자의 공개된 저장소라고 생각하시면 되겠습니다. 보통 소스 코드나 개발한 파일을 게시합니다.

해루봇이 다운로드에 필요한 데이터를 조회하려면 이 리포지토리에 접근을 해야 합니다.

이때 사용하는 것이 Github에서 제공하고 있는 api입니다. 여기서 api는 전달자로 이해하시면 되겠습니다.

 

해루봇이 api에게 '데이터를 주세요.'라고 요청하면, api가 서버에게 '해루봇이 이러이러한 데이터를 요청한다.'고 전달합니다.

바로 이 과정에서 토큰이 소모되는 것입니다.

api 요청은 서버의 네트워크 자원을 사용합니다.

따라서 서버의 과부하를 막기 위해 짧은 시간 내 과도한 요청은 Github에서 강력히 제한하고 있습니다.

제한 기준은 요청을 시도하는 ip입니다. 우리는 바로 이 제한에 걸려서 1시간당 60회만 접근할 수 있는 것입니다.

물론 여러 가지 인증 방식을 거치면 시간당 횟수를 크게 늘릴 수 있습니다.

간단하게 예를 들자면 일종의 로그인으로 사용자 정보를 받아서 서버에 인증하면 됩니다.

그런데 해루봇에서 관리하는 파일이 60개는커녕 그 절반도 안 되기도 하고, 설치할 때 아니면 하루에 요청을 많이 해봤자 10회 전후일 텐데 횟수를 늘리자고 여러분들의 개인 정보를 받는 것은 저도 사양입니다. 너무 번거로워요.

여러분들도 회원 가입하라고 하면 귀찮아하실 테고요.

그래서 제가 내린 결론은 현재 해루봇은 60회 제한으로도 충분히 운용 가능하다는 것입니다.

이해되셨나요? 그러면 앞으로는 조금만 인내심을 갖고 사용을 부탁드립니다. 🙏🙏🙏

 

+ 2022.09.12 추가 : 동기화 토큰 횟수를 최대 5,000회까지 늘리는 옵션을 해루봇 1.0.4.4부터 제공합니다. 해당 옵션 사용법은 여기를 참고하시기 바랍니다. 

 

---

 

그러면 지금부터 앞서 알려 드린 개념을 바탕으로 동기화 영역에 대해 설명해 보겠습니다.

이 내용은 📖 Haerubot 기능 설명서에도 있는 내용입니다.

 

• ① 자동동기화 토글 스위치입니다. 이 스위치가 켜져 있으면 해루봇을 켤 때마다 모든 설치항목의 리포지토리를 조회합니다.
  
  
• ② 해루봇이 api로 데이터를 요청했을 때 성공적으로 서버의 응답을 받은 시각입니다.
  
  
• ③ 동기화 토큰 상태입니다. (사용 가능한 남은 횟수 / 최대 횟수)입니다.
  
  
• ④ 동기화 토큰이 최대 횟수 60으로 초기화되기까지 남은 시간입니다. 최대 1시간입니다.
  
  
• ⑤ 일괄 새로고침 버튼입니다. 모든 설치 항목의 업데이트 여부를 알기 위해 데이터를 다시 요청합니다.
  동기화 토큰이 있어야 사용 가능합니다. 이 때 공지사항 등 콘텐츠 데이터도 같이 요청합니다.
  참고로 콘텐츠 데이터는 동기화 토큰을 소모하지 않습니다.
  
  

자주 껐다 켰다 해야할 상황이라면 진짜 필요할 때 쓸 수 있게 동기화 토큰 스위치를 아예 꺼 두는 것이 좋을 수도 있습니다.

차라리 일괄 새로고침으로 수동 동기화를 진행하는 것도 상황에 따라서는 나쁘지 않습니다.

그리고 각 플러그인의 '새로고침' 버튼은 동기화 토큰을 소모해서 대상 항목만 조회하는 기능입니다. 

 

그럼 이제는 좀 더 유연하게 사용하실 수 있으시겠죠? 😅