누가 무엇을 만들고 관리하나요?
각 키가 볼 수 있는 노트는 외부 앱이 볼 수 있는 데이터에 정리돼 있어요.
조직 API Key를 만들 때 무엇을 정하나요?
[API Key 만들기] 에서 아래 항목을 정해요. 키 값은 만든 직후 한 번만 보여주니 바로 안전한 곳에 저장하세요.- [권한]: [모든 권한] 또는 [선택한 권한만]. 연동에 필요한 권한만 고르세요. [모든 권한] 도 키 종류에 따른 노트 범위 제한은 그대로예요.
- [접근할 워크스페이스]: [현재와 앞으로 추가할 모든 워크스페이스] 또는 [선택한 워크스페이스만].
- [만료 기한]: 연동 기간이 정해져 있으면 기한을 두세요.
- [허용 호스트]: 키를 쓸 수 있는 호스트를 제한해요. 조직 전체에 공통으로 적용할 호스트는 조직 보안 설정의 [API Key 허용 호스트] 에서 관리해요.
OAuth 앱은 어떻게 관리하나요?
OAuth 앱은 사내 시스템이 구성원의 동의를 받아 그 구성원의 노트를 조회할 때 써요. 등록 절차는 개발자 문서의 OAuth 앱 연동에 있어요. 등록한 앱은 목록에서 상태를 바꿀 수 있어요.- [신규 승인 중단]: 새로운 승인 요청을 막아요. 이미 발급된 토큰으로 맺은 연결은 유지돼요. 다만 이전에 승인한 구성원도 다시 연결하려면 신규 승인을 재개해야 해요.
- [Secret 재발급]: 기존 Client Secret을 바로 쓸 수 없게 하고 새 값을 받아요. 앱을 쓰는 서버 설정을 바꿀 준비를 하고 진행하세요.
키가 노출된 것 같으면 어떻게 하나요?
노출이 의심되는 키는 바로 삭제하고 새 키를 만들어 연동에 넣으세요. 키를 삭제하면 그 키를 쓰는 연동이 멈추고, 삭제는 되돌릴 수 없어요. OAuth 앱의 Client Secret이 노출됐다면 [Secret 재발급] 으로 바꾸세요.SSO·SCIM은 어디서 설정하나요?
SSO와 SCIM은 사내 인증 체계와 맞물려 있어서 도입 과정에서 담당 매니저와 함께 구성해요. 준비할 항목은 조직 관리자 가이드에 있어요.관련 페이지: 외부 앱이 볼 수 있는 데이터 · 조직 관리자 가이드 · 조직 보안 설정