엔터프라이즈 조직용 관리자 API

Notion의 관리자 API를 사용하면 조직에서 코드를 통해 관리자 작업을 처리할 수 있습니다. 여기에는 워크스페이스 내보내기 시작, 증거보존 조치 생성 및 해제, 관리 대상 사용자의 Notion 로그아웃 등과 같은 일반적인 작업이 포함됩니다.

조직 설정에서 이를 설정할 수 있습니다. 조직을 위한 관리자 봇을 생성한 다음, 필요한 사용 권한만 있는 토큰을 부여하세요.

• 조직은 엔터프라이즈 요금제를 사용해야 합니다.

• 조직 소유자여야 합니다.

• 이 기능은 관리자, IT, 보안 및 규정 준수 팀을 위해 구축되었습니다. 멤버와 게스트는 일상 업무에서 아무런 변화를 느끼지 못할 것입니다.

1. 워크페이스 전환기를 열고 조직 관리를 선택하세요.

2. 일반으로 이동한 다음 조직 수준 관리자 API 토큰 관리를 엽니다.

3. 연결 생성하기를 선택합니다.

4. 팀이 알아볼 수 있는 연결 이름을 지정하고(예: "규정 준수 자동화"), 필요한 사용 권한만 선택하세요. 연결이 내보내기만 실행하는 경우 증거보존 조치 사용 권한을 부여하지 마세요.

5. 토큰 생성하기를 선택한 다음 토큰을 복사하여 팀에서 이미 사용 중인 비밀 관리자에 저장하세요.

조직 설정에 새로 생성된 연결이 생성자 및 생성 시간과 함께 표시됩니다. 언제든지 연결 메뉴에서 다시 돌아와 토큰을 복사할 수 있습니다.

• 작업을 수행하는 데 필요한 최소한의 사용 권한만 선택하세요.

• 보안 팀이 설정한 일정에 따라 토큰을 교체하세요.

• 실수로 토큰이 공유되었거나 토큰 소유자의 역할이 변경된 경우 즉시 토큰을 삭제하세요. 해당 토큰을 사용하는 모든 스크립트는 즉시 작동이 중단됩니다.

• 관리자 토큰을 특정 IP 주소나 네트워크로 제한할 수는 없습니다. 토큰을 비밀 관리자에 저장하고 신뢰할 수 있는 시스템에서 전화를 실행하는 등 이미 보유하고 있는 제어 수단을 사용하세요.

관리자 토큰으로 수행된 작업은 감사 로그에 표시됩니다. 관리자 봇이 작업자로 표시되므로 자동화된 작업과 사람이 수행한 작업을 구분할 수 있습니다.

• 전화가 거부되었습니다. 조직이 엔터프라이즈 요금제를 사용 중인지 확인하세요.

• 권한 오류가 발생합니다. 토큰이 전화하려는 작업에 대한 사용 권한이 있는지 확인하세요. 내보내기 범위로 지정된 토큰은 증거보존 조치를 생성할 수 없습니다.

• 로그아웃 전화가 작동하지 않습니다. 계정이 관리 대상 사용자인지 확인하세요. 인증된 도메인 외부의 계정은 적용 대상이 아닙니다.

요청 형식, 매개변수 및 코드 샘플은 개발자 문서의 관리자 API 참조를 확인하세요.