개발자

앱은 사용자보다 더 많은 권한을 받지 않습니다.

REZICS는 로그인, 대표 ID, 리소스 권한, 앱 승인을 각각 기록합니다. 앱과 AI 에이전트의 토큰 권한은 이 경계 안에서 더 좁혀집니다.

네 단계

안쪽으로 갈수록 좁아집니다

계정, ID, 설치와 동의, 토큰 범위를 네 단계로 나눠 기록합니다. 안쪽 단계는 항상 바깥 단계 안에 있습니다. 앱은 가장 안쪽 단계의 권한만 받습니다.

정사각형 종이 네 장이 크기순으로 겹쳐 있습니다. 가장 바깥은 짙은 청회색이고 맨 위에는 가장 작은 연한 파란 종이가 놓여 있습니다.

단계별

각 단계의 역할

  • 계정

    계정 서비스가 사용자를 확인합니다. 로그인만으로 리소스를 조작할 수는 없습니다.

  • ID

    개인이나 조직 ID로 작업하면 서버가 대표 관계와 리소스 권한을 확인합니다.

  • 설치와 동의

    설치와 동의는 서로 독립된 권한 상한입니다. 앱 등록만으로 리소스 권한을 얻지는 않습니다.

  • 토큰 범위

    토큰에는 library:write처럼 동의한 범위만 담깁니다. 각 작업은 어떤 ID로 수행되는지 다시 확인합니다.

승인

승인 코드와 PKCE

GET /api/auth/oauth2/authorize
  ?response_type=code
  &client_id=…
  &redirect_uri=https://a.example/
  &scope=work:read%20library:write
  &code_challenge=…
  &code_challenge_method=S256
  &state=…
승인 요청은 REZICS 계정 서비스로 전송됩니다. 돌아올 URL은 등록한 주소와 정확히 일치해야 합니다.

동의

동의 화면에 표시되는 내용

REZICS 제품은 동의 화면을 표시하지 않습니다. 계정 페이지에 제품 세션으로 표시됩니다.

  • name · uri

    앱 이름과 웹사이트

  • scopes[].description

    각 권한의 설명은 사용자 언어로 표시하고, 번역이 없으면 영어 사용

  • unverified

    검증되지 않은 앱임을 명확히 표시

  • redirectHost

    승인 후 돌아갈 도메인

  • policy · terms

    앱의 개인정보 처리방침과 서비스 약관

철회

언제든 철회

  • 확인

    계정의 “연결된 앱” 페이지에서 각 앱이 할 수 있는 작업, 승인 시점, 마지막 사용 시점을 볼 수 있습니다.

  • 재확인

    앱을 삭제하기 전에 사용자 ID를 다시 확인합니다.

  • 무효화

    삭제하면 앱이 가진 토큰을 더는 사용할 수 없습니다. 토큰 갱신용 토큰도 마찬가지입니다.

  • 비활성화

    REZICS에서 비활성화한 앱은 표시되며, 해당 앱에 남은 승인은 계속 삭제할 수 있습니다.

같은 API로 도구를 만드세요.

프로그램으로 작품, 서재, 커뮤니티 데이터를 읽고 쓰세요. 모든 작업에 REZICS의 ID와 권한 규칙이 적용됩니다.