개요
워크스페이스 관리자는 SharePoint 제어를 사용하여 승인된 사이트 모음을 허용하고, 선택한 사이트 모음을 차단하며, 선택한 Microsoft Purview 민감도 레이블이 있는 지원 대상 파일을 제외할 수 있습니다.
SPSite라고도 하는 SharePoint 사이트 모음에는 여러 사이트가 포함될 수 있습니다. 사이트 모음 규칙은 각 사용자의 기존 Microsoft 권한 내에서 사이트 모음 전체에 적용됩니다. 사용자가 Microsoft 365에서 액세스할 수 없는 콘텐츠에 대한 액세스 권한을 부여하지는 않습니다.
사이트 제한은 지원되는 SharePoint 검색, 탐색, 파일 가져오기, 읽기/쓰기 작업에 적용됩니다. OneDrive 액세스는 별도로 관리됩니다.
정책에 맞는 액세스 모드를 선택하세요.
허용된 사이트: 허용 목록에 항목이 있으면 사용자는 앱을 통해 목록에 있는 사이트 모음에만 액세스할 수 있습니다.
차단된 사이트: 사용자는 자신의 Microsoft 권한 내에서 차단 목록에 없는 사이트 모음에 액세스할 수 있습니다.
한 번에 하나의 목록에만 항목을 넣을 수 있습니다. 허용 목록이 비어 있다고 해서 모든 사이트가 차단되는 것은 아닙니다. 두 목록이 모두 비어 있으면 SharePoint 사이트 제한이 해제됩니다. Microsoft 권한과 설정된 다른 제어는 계속 적용됩니다.
사용 가능 여부
이 제어와 워크스페이스 Admin API를 사용하려면 해당 워크스페이스에서 활성화되어 있어야 합니다. 사용 가능한 제어에는 사이트 모음 허용 목록, 사이트 모음 차단 목록, CSV 사이트 가져오기, 민감도 레이블 제외가 포함됩니다.
규칙은 사이트 모음 전체에 적용됩니다. 이 사이트 모음 제어에는 특정 개별 사이트, 폴더 또는 파일 단위로 범위를 지정하는 기능이나 Microsoft Sites.Selected 적용 기능이 포함되지 않습니다.
시작하기 전에
조직에서 허용하거나 차단할 사이트 모음을 파악하세요.
각 사이트 모음의 GUID를 확보하세요. 전체 Microsoft Graph 사이트 ID에서 가운데 값이 사이트 모음 GUID입니다. Admin API는 사이트 모음 GUID를 사용합니다. UI의 CSV 가져오기 기능은 세 값으로 구성된 Graph 사이트 ID에서도 사이트 모음 GUID를 추출할 수 있습니다.
ChatGPT 권한 설정과 Microsoft Entra 양쪽에서
Sites.Read.All및Files.Read.All을 비롯해 SharePoint 앱에 필요한 Microsoft 권한을 활성화하세요. 이 제어는 OpenAI 측에서 액세스를 필터링하며, Microsoft의 위임된 권한을 대체하지 않습니다.민감도 레이블 제외를 설정하려면 Microsoft 365 또는 Purview 관리자에게 암호화가 적용되지 않는 각 레이블의 변경 불가능한 GUID를 요청하세요.
API로 관리하려면 워크스페이스 UUID와 ChatGPT 워크스페이스 관리자 키를 확보하세요. SharePoint URL의 식별자를 조회해야 한다면 Microsoft Graph 토큰도 필요합니다. 이 두 자격 증명은 용도가 서로 다릅니다.
OpenAI Cookbook 소개
OpenAI Cookbook은 OpenAI가 공개한 예제 코드와 가이드 모음입니다. 이 문서에서는 GitHub에 게시된 Cookbook의 SharePoint 사이트 액세스 가이드와 Python 관리 스크립트를 사용합니다. 브라우저에서 이 링크를 열어 파일을 읽을 수 있습니다. 스크립트를 실행하려면 다운로드한 후 가이드의 설정 및 명령어 안내를 따르세요.
이 문서에서 ‘Cookbook’은 위의 SharePoint 가이드를, ‘Cookbook 유틸리티’는 링크된 Python 스크립트를 가리킵니다. 명령어 예시와 API 기반 허용 목록 관리 방법은 이 자료들을 참고하세요.
API 관리용 자격 증명 설정
참고: 관리자 키를 만들려면 워크스페이스 관리자여야 합니다. 자세히 알아보기.
ChatGPT 워크스페이스 관리자 키 만들기
ChatGPT 관리자 콘솔을 열고 원하는 워크스페이스를 선택하세요.
자격 증명으로 이동하여 관리자 키를 선택하세요.
제한됨 권한으로 키를 만들고 앱을 쓰기로 설정하세요.
키를 안전하게 보관하세요. 이 키는 워크스페이스의 SharePoint 정책을 조회하고 변경할 수 있는 권한을 부여합니다.
필요한 권한은 chatgpt.enterprise.apps.write입니다. API 플랫폼 키나 Microsoft Graph 토큰으로는 ChatGPT 워크스페이스 관리자 키를 대체할 수 없습니다.
자세한 내용은 자격 증명 탭에서 관리자 키 관리하기를 참고하세요. 스크립트의 자격 증명 환경 변수와 안전한 입력 예시는 Cookbook의 자격 증명 안내를 참고하세요.
Microsoft Graph 토큰 받기
조직에서 승인한 Microsoft 인증 절차를 사용하세요. 조직에서 Graph Explorer 사용을 허용하는 경우, 대화형 조회를 하려면 다음 단계를 따르세요.
Microsoft Graph Explorer를 열고 SharePoint 사이트가 있는 테넌트의 회사 계정으로 로그인하세요.
권한 수정 또는 권한에 동의를 사용하여 사이트를 읽는 데 필요한 권한(일반적으로
Sites.Read.All)을 선택하세요. 조직에서 요구하는 경우 Microsoft 관리자에게 액세스 승인을 요청하세요.액세스 토큰 탭을 열고 Microsoft Graph에 사용할 토큰을 복사하세요.
Microsoft의 안내는 Graph Explorer 사용하기를 참고하세요.
Graph 토큰은 SharePoint URL을 조회하여 식별자로 변환하는 데 사용됩니다. ChatGPT 관리자 키는 ChatGPT 정책을 조회하거나 업데이트하는 데 사용됩니다. Cookbook 유틸리티에서 Graph 토큰은 URL의 식별자를 조회하는 명령에만 필요합니다. 기존 허용 목록을 조회하거나 비우려면 ChatGPT 관리자 키만 있으면 됩니다.
두 자격 증명 모두 소스 코드 저장소, 공유 문서, 스크린샷 또는 로그에 포함하지 마세요.
사이트 모음 GUID 찾기
SharePoint 사이트 URL 사용
해당 사이트에 액세스할 수 있는 계정으로 Microsoft에 로그인한 상태에서 SharePoint 사이트를 여세요.
사이트 URL 끝에
/_api/site/id를 추가하세요. 예를 들어https://contoso.sharepoint.com/sites/Finance/_api/site/id를 사용하세요.응답으로 반환된 GUID를 복사하세요.
참고: 이 문서의 예시 도메인과 식별자는 실제 값이 아닌 자리 표시자입니다.
Microsoft Graph 사용
Microsoft Graph는 호스트 이름, 사이트 모음 GUID, 사이트 GUID라는 세 가지 구성 요소가 쉼표로 구분된 사이트 ID를 반환합니다. 사이트 모음 규칙에는 가운데 값을 사용하세요. 서로 다른 사이트 URL을 조회해도 동일한 사이트 모음 GUID가 반환될 수 있습니다.
조회 및 식별자 예시는 SharePoint 사이트 식별자 이해하기를 참고하세요. ChatGPT 정책을 변경하지 않고 여러 URL의 식별자를 조회하려면 Cookbook의 검사 안내와 Python 관리 스크립트를 사용하세요.
Microsoft의 조회 요구 사항은 경로로 SharePoint 사이트 가져오기를 참고하세요.
허용 및 차단할 사이트 모음 관리
워크스페이스 제어 사용
워크스페이스에서 SharePoint 앱의 안전 및 보안 제어를 여세요.
액세스 모드에서 허용된 사이트 또는 차단된 사이트를 선택하세요.
선택한 목록에 사이트 모음을 추가하세요. 아래에 설명된 CSV 업로드를 사용할 수도 있습니다.
변경 사항을 검토하고 저장을 선택하세요.
저장된 정책을 확인하고 설정을 테스트하세요.
Admin API를 통해 추가한 사이트는 워크스페이스 제어 설정에 표시됩니다. UI에서 추가한 사이트도 API를 통해 조회하고 관리할 수 있습니다. 어느 쪽에서든 항목을 추가하거나 제거할 수 있습니다. 사이트를 추가할 때 사용한 방식으로만 관리해야 하는 것은 아닙니다.
허용된 사이트와 차단된 사이트 간 전환
한 번에 하나의 목록에만 항목을 넣을 수 있습니다. 다른 모드에서 항목을 추가하기 전에 기존 목록을 비우고 변경 사항을 저장하세요. 그런 다음 다른 모드를 선택하고 원하는 사이트 모음을 추가한 후 다시 저장하세요.
사용 중인 목록을 비우고 저장하면 액세스가 즉시 변경됩니다. 허용 목록을 비우면 해당 목록의 사이트 제한이 해제되고, 차단 목록을 비우면 해당 목록의 차단이 해제됩니다. 한 목록을 비운 후 다른 목록을 저장하기 전까지는 최종 정책에서 제한할 액세스가 허용될 수 있으므로, 다른 관리자와 함께 전환을 계획하세요.
CSV에서 사이트 모음 업로드
CSV 업로드는 사이트 모음만 지원합니다. 민감도 레이블을 기준으로 파일을 제외하려면 암호화가 없는 제외 대상 민감도 레이블에 레이블 GUID를 추가하세요.
안전 및 보안 제어를 열고 원하는 액세스 모드를 선택하세요.
사이트 모음 GUID 또는 세 값으로 구성된 Microsoft Graph 사이트 ID가 포함된 CSV를 준비하세요. 파일 전체에서 하나의 식별자 형식만 사용하세요.
CSV 파일 업로드를 선택하고 파일을 고르세요.
가져오기 결과와 선택한 목록을 검토하세요. 계속하기 전에 각 행의 오류나 경고를 해결하세요.
저장을 선택하여 변경 사항을 적용한 후 저장된 목록을 확인하세요.
CSV 요구 사항 및 동작:
최대 파일 크기: 1 MB.
헤더는 선택 사항입니다.
행마다 사이트 모음 GUID 하나 또는 세 값으로 구성된 Graph 사이트 ID 하나를 사용하세요. 세 값은 따옴표로 묶어 하나의 필드에 넣거나 세 개의 열로 나눌 수 있습니다.
Graph의 세 값으로 구성된 ID는 사이트 모음 GUID로 변환됩니다. 세 값으로 구성된 ID를 가져와도 특정 개별 사이트에만 적용되는 규칙이 생성되지는 않습니다.
가져온 항목은 선택한 목록에 추가되며, 기존 항목은 유지됩니다. 중복된 사이트 모음은 하나로 처리됩니다. 가져오기 개수에는 새로 추가된 사이트 모음 수가 표시됩니다.
형식이 혼재되어 있거나 행 형식이 잘못된 경우에는 거부됩니다. 사이트 URL만 포함된 파일을 업로드하면 경고가 표시되고 사이트는 추가되지 않습니다. 먼저 URL을 조회하여 사이트 모음 GUID로 변환하세요.
업로드는 아직 저장되지 않은 목록만 변경합니다. 저장을 선택하기 전까지는 워크스페이스 액세스가 업데이트되지 않습니다.
여기서 설명하는 CSV 업로드는 사이트 모음을 관리하는 기능입니다. 민감도 레이블 제외는 별도로 설정하세요.
SharePoint URL이 포함된 CSV가 있다면 Cookbook 유틸리티의 CSV 워크플로를 통해 URL의 식별자를 조회하고 API로 허용 목록을 관리할 수 있습니다. 이 유틸리티의 site_url 또는 url 입력은 UI의 식별자 업로드와 형식 및 워크플로가 다릅니다.
정책 및 요청 한도 이해하기
기본 정책 한도는 사이트 모음 10,000개입니다. 워크스페이스 정책 한도를 최대 120,000개의 사이트 모음까지 높이려면 OpenAI의 활성화가 필요합니다. 더 큰 규모의 배포를 계획하기 전에 OpenAI 담당 팀에 문의하세요.
개별 API 변경 작업과 현재 Cookbook 스크립트는 요청당 최대 10,000개의 사이트 모음 GUID를 허용합니다. 워크스페이스 정책 한도를 높여도 이 요청당 한도는 늘어나지 않습니다. 원본 URL 수가 아니라 중복을 제외한 사이트 모음 수를 세세요. 여러 URL이 같은 사이트 모음을 가리킬 수 있습니다.
워크스페이스 Admin API 사용
워크스페이스 UUID와 ChatGPT 워크스페이스 관리자 키를 사용하여 https://api.chatgpt.com에 요청하세요.
최신 상태로 관리되는 허용 목록 명령어와 요청 예시는 Cookbook을 참고하세요.
사이트 모음 미리 보기 및 추가. 새 항목을 추가해도 기존에 허용된 사이트 모음은 유지됩니다.
변경하기 전에 현재 정책을 검토하고, 변경 후 다시 조회하여 실제 액세스 결과를 테스트하세요. 마지막으로 남은 허용된 사이트 모음을 제거하거나 허용 목록을 비우면 해당 사이트 제한이 해제됩니다. 허용 목록 제한을 해제하려는 경우가 아니라면 빈 추가 요청을 보내지 마세요.
공개된 Cookbook 유틸리티는 현재 허용 목록만 관리합니다. 차단 목록이나 민감도 레이블 제외는 관리하지 않습니다. 이러한 작업에는 위에서 설명한 워크스페이스 제어를 사용하세요.
민감도 레이블이 있는 파일 제외
레이블 GUID 찾기
Microsoft 365 또는 Purview 관리자에게 대상 레이블의 변경 불가능한 GUID를 요청하세요. 표시 이름이 아닌 GUID를 사용하세요.
관리자는 Microsoft Graph를 통해 레이블 목록을 조회할 수 있습니다. 토큰에는 상황에 맞는 SensitivityLabel.Read 또는 SensitivityLabels.Read.All 권한이 필요합니다. 대상 레이블의 이름에 해당하는 ID를 찾고 보호 설정을 확인하세요.
요구 사항과 예시는 민감도 레이블 목록 조회와 민감도 레이블 속성을 참고하세요. 이 레이블 권한은 SharePoint URL의 식별자를 조회할 때 사용하는 사이트 읽기 권한과는 별개입니다.
제외할 레이블 추가
SharePoint 앱의 안전 및 보안 제어를 여세요.
암호화가 없는 제외 대상 민감도 레이블에 암호화가 적용되지 않는 각 레이블의 GUID를 입력하세요.
설정을 저장하고, 제외 대상 레이블이 있는 지원 대상 파일로 테스트하세요.
지원되는 레이블 중 제외 대상으로 지정한 레이블이 있는 파일은 SharePoint 앱 결과에서 제외됩니다. 암호화를 적용하는 레이블이 있는 파일은 이미 기본적으로 제외됩니다.
설정 테스트
조직에서 승인한 테스트 파일과 계정을 사용하세요. 테스트하기 전에 동일한 Microsoft 계정으로 SharePoint에서 각 파일에 직접 액세스할 수 있는지 확인하세요.
목록에 항목이 있는 허용된 사이트 모드에서 허용된 사이트 모음의 파일과 목록에 없는 사이트 모음의 파일을 확인하세요. 앱을 통해서는 허용된 사이트 모음에만 액세스할 수 있어야 합니다.
차단된 사이트 모드에서 차단된 사이트 모음의 파일과 차단되지 않은 사이트 모음의 파일을 확인하세요. 차단된 사이트 모음에는 액세스할 수 없어야 합니다. 차단되지 않은 사이트 모음에는 Microsoft 권한과 기타 제어가 계속 적용됩니다.
제외 대상 민감도 레이블이 있는 지원 대상 테스트 파일을 확인하세요. 해당 파일은 앱 결과에 표시되지 않아야 합니다.
API로 변경한 후에는 UI에 저장된 목록과 API가 반환하는 정책을 비교하세요.
CSV를 업로드한 후에는 변경 사항을 저장하고 제어 설정을 다시 열어, 의도한 사이트 모음이 유지되었는지 확인하세요.
결과가 의도한 정책과 다르면 워크스페이스, 선택한 액세스 모드, 저장된 목록, 사이트 모음 GUID, 레이블 GUID, 지원되는 파일 형식, 사용자의 Microsoft 권한을 확인하세요. 목록을 비웠을 때 발생하는 액세스 변경을 의도한 경우가 아니라면, 문제 해결을 위해 목록을 비우지 마세요.
제어 설정이 보이지 않거나 예상과 다르게 액세스되는 문제에 대한 도움말은 OpenAI 지원팀에 문의하기를 참고하세요. 지원 요청에 관리자 키나 Microsoft Graph 토큰을 포함하지 마세요.
제한 사항 이해하기
사이트 모음 규칙은 사이트 모음 전체에 적용됩니다. 특정 하위 사이트, 폴더 또는 파일 단위로 액세스를 제한할 수는 없습니다.
SharePoint 사이트 제한이 OneDrive 액세스까지 자동으로 제한하지는 않습니다.
민감도 레이블 필터링은 지원되는 Office 문서, PDF, MP4 파일 등 Microsoft Graph가 지원 대상 레이블 메타데이터를 제공하는 파일에만 적용됩니다.
TXT 및 CSV 파일처럼 민감도 레이블이 지원되지 않는 파일 형식은 레이블이 없는 것으로 처리됩니다. 다른 조건에서 액세스가 허용된다면 이러한 파일에는 계속 액세스할 수 있습니다. 이 파일 형식 제한은 사이트 액세스를 설정하기 위한 CSV 업로드와는 별개입니다.
CSV 업로드와 공개 예제 유틸리티로는 민감도 레이블 제외를 설정할 수 없습니다. 이 문서에서는 레이블 일괄 관리 API를 다루지 않습니다.
정책이 저장되거나 API 응답이 성공했다고 해서 대상 계정으로 액세스를 테스트하는 과정을 생략해서는 안 됩니다.
Python 관리 유틸리티 사용
전체 예제 코드와 명령어는 OpenAI Cookbook에서 관리됩니다.
Python 3.10 이상을 사용하세요. 이 유틸리티는 Python 표준 라이브러리를 사용합니다. 실행하기 전에 가이드를 읽고, 모의 실행으로 변경 사항을 검토하세요.
현재 유틸리티는 환경 변수에서 자격 증명을 읽습니다. 가이드의 안전한 입력 안내를 따르세요. 허용 목록을 비우려면 명시적인 확인이 필요합니다. 개별 항목 제거는 이 확인 없이도 실행될 수 있으므로, 먼저 모의 실행으로 제거 내용을 검토하세요.
재시도 동작과 선택적으로 사용하는 멱등성 키에 대해서는 정책 업데이트를 안전하게 재시도하기를 참고하세요. 워크스페이스에서 지원하는 경우에만 멱등성 키를 사용하고, 실패 후 결과가 불분명하다면 현재 정책을 확인하세요.
이 유틸리티는 워크스페이스 기능을 활성화하거나 정책이 실제로 적용되는지 검증하지 않습니다. 오프라인 테스트에서는 Microsoft Graph 및 ChatGPT Admin API 호출을 모킹하여 사용합니다.
여러 요청으로 이루어진 변경은 원자적으로 처리되지 않습니다. 여러 사이트 모음을 제거하는 작업이 도중에 실패하면, 앞서 요청한 제거는 이미 성공했을 수 있습니다. 재시도하기 전에 현재 정책을 조회하세요.
자주 묻는 질문
사이트 제어가 Microsoft 권한을 대체하나요?
아니요. 앱은 계속해서 각 사용자의 Microsoft 권한을 사용합니다. OpenAI는 사용자와 모델에 응답이 제공되기 전에 설정된 사이트 필터링을 적용합니다.
허용 목록이 비어 있으면 모든 사이트가 차단되나요?
아니요. 빈 허용 목록은 ‘모두 차단’을 의미하지 않습니다. 차단 목록에 항목이 있으면 해당 사이트 모음은 계속 차단됩니다. 두 목록 모두에 항목이 없으면 사용자의 Microsoft 권한과 설정된 다른 제어에 따라 액세스가 결정됩니다.
Admin API 변경 사항은 로그에 기록되나요?
Admin API를 통한 정책 변경은 워크스페이스 감사 및 규정 준수 로깅을 통해 기록됩니다.