Skip to main content

​
SharePoint & OneDrive — Add from SharePoint

이 연동을 사용하면 사용자가 첨부 버튼의 Add from SharePoint 옵션을 통해 SharePoint 사이트(Teams 사이트 포함), OneDrive, 나와 공유됨의 파일을 채팅에서 바로 첨부할 수 있습니다. 설정은 셀프서비스입니다. 귀사의 관리자가 귀사의 Microsoft Entra ID 디렉터리에 SecureAI를 애플리케이션으로 등록하고 식별자를 Admin → Integrations → Files에 등록합니다. 티켓을 열거나 Hiper AI를 기다릴 필요가 없습니다. 설정을 저장하는 즉시 채팅에 옵션이 표시됩니다. 예상 소요 시간: 10분.

​
작동 방식

  1. 사용자가 Attach → Add from SharePoint를 클릭합니다. 처음에는 Microsoft가 본인의 Microsoft 365 계정으로 로그인하도록 요청합니다.
  2. Microsoft Graph 기반의 SecureAI 탐색기가 열리며 사이트, 라이브러리, 폴더, 검색, 사용자와 공유된 파일이 표시됩니다. 사용자가 파일을 하나 이상 선택합니다.
  3. 사용자의 브라우저가 사용자 본인의 토큰으로 선택한 파일만 다운로드하여 메시지에 첨부합니다.
  4. 파일은 다른 첨부 파일과 동일한 경로를 따릅니다. 모델에 도달하기 전에 DLP와 귀사의 정책을 거칩니다.
위임된 권한만 사용하며, 애플리케이션 권한은 사용하지 않습니다. SecureAI는 항상 로그인한 사용자를 대신하여 동작합니다. 사용자는 SharePoint에서 이미 열 수 있는 항목만 보고 첨부할 수 있습니다. 이 애플리케이션은 클라이언트 비밀이 없는 “단일 페이지 애플리케이션”(SPA)이며, SecureAI는 백그라운드에서 아무것도 읽지 않습니다.

​
사전 요구 사항

  • 애플리케이션을 등록하고 Microsoft Graph 권한에 대해 관리자 동의를 부여할 수 있는 Entra ID 역할(예: 클라우드 애플리케이션 관리자 또는 전역 관리자).
  • SecureAI 관리자 액세스 권한(Integrations 섹션에 대한 Administrator 권한).
  • Attach from Drive / SharePoint가 포함된 SecureAI 요금제. 포함되어 있지 않아도 설정은 미리 해 둘 수 있지만, 사용자에게는 옵션이 표시되지 않습니다.

​
1단계: SecureAI에서 리디렉션 URI 복사

  1. 관리자로 SecureAI에 로그인합니다.
  2. Admin → Integrations로 이동하여 Files 카테고리로 필터링합니다.
  3. SharePoint & OneDrive 카드에서 Connect integration을 클릭합니다.
  4. 1. Register SecureAI in Microsoft Entra ID 섹션에서 Redirect URI 옆의 Copy를 클릭합니다.
SecureAI 사이드 패널의 리디렉션 URI
URI는 귀사 인스턴스의 주소입니다. 예: https://<회사명>.hiperai.ai. 항상 귀사의 인스턴스에 표시되는 값을 사용하십시오. 정확히 일치해야 합니다.

​
2단계: Entra ID에 애플리케이션 등록

  1. Microsoft Entra 관리 센터를 열고 ID → 애플리케이션 → 앱 등록(Identity → Applications → App registrations)으로 이동합니다.
  2. 새 등록(New registration)을 클릭합니다.
앱 등록 → 새 등록
  1. 다음 항목을 입력합니다.
    • 이름(Name): 예: SecureAI — Add from SharePoint
    • 지원되는 계정 유형(Supported account types): 이 조직 디렉터리의 계정만(Accounts in this organizational directory only, 단일 테넌트)
    • 리디렉션 URI(Redirect URI): 드롭다운에서 단일 페이지 애플리케이션(SPA)(Single-page application)을 선택하고 1단계에서 복사한 URI를 붙여넣습니다.
  2. 등록(Register)을 클릭합니다.
플랫폼은 웹이 아니라 **단일 페이지 애플리케이션(SPA)**이어야 합니다. 웹으로 등록하면 로그인이 AADSTS9002326 오류로 실패합니다. 이미 웹으로 등록했다면 인증(Authentication)으로 이동하여 같은 URI로 단일 페이지 애플리케이션 플랫폼을 추가하고 웹 플랫폼은 제거하십시오.
  1. 애플리케이션의 개요(Overview)에서 애플리케이션(클라이언트) ID(Application (client) ID)와 디렉터리(테넌트) ID(Directory (tenant) ID)를 복사합니다. 클라이언트 비밀을 만들 필요는 없습니다.
애플리케이션 ID와 디렉터리 ID

​
3단계: Microsoft Graph 권한 추가

  1. 애플리케이션에서 API 권한 → 권한 추가 → Microsoft Graph → 위임된 권한(API permissions → Add a permission → Microsoft Graph → Delegated permissions)으로 이동합니다.
  2. 다음을 검색하여 선택합니다.
    • Files.Read.All — 사용자가 액세스할 수 있는 파일을 읽습니다.
    • Sites.Read.All — 사용자가 액세스할 수 있는 SharePoint 사이트를 나열하고 검색합니다.
  3. 권한 추가(Add permissions)를 클릭합니다. User.Read는 기본으로 이미 추가되어 있으므로 그대로 두십시오.
Microsoft Graph 위임된 권한

​
4단계: 관리자 동의 부여

  1. API 권한에서 <조직 이름>에 대한 관리자 동의 허용(Grant admin consent for <org>)을 클릭하고 예로 확인합니다.
  2. 세 가지 권한의 상태가 모두 <조직 이름>에 허용됨이어야 합니다.
부여된 관리자 동의
이 단계를 건너뛰면 각 사용자에게 동의 요청이 표시됩니다(조직에서 사용자 동의를 허용하지 않는 경우 AADSTS65001 오류가 표시됩니다).

​
5단계: SecureAI에 입력, 테스트 및 활성화

  1. SecureAI의 SharePoint & OneDrive 사이드 패널로 돌아갑니다.
  2. 2. Paste the identifiers에서 Directory (tenant) ID와 Application (client) ID를 붙여넣습니다.
  3. 3. Test it에서 다음을 수행합니다.
    • Test connection은 SecureAI 서버에서 디렉터리가 존재하는지 확인합니다.
    • Try signing in은 사용자에게 표시되는 것과 동일한 Microsoft 창을 엽니다. 본인 계정으로 로그인하십시오. SecureAI가 리디렉션 URI가 SPA 유형인지, Files.Read.All과 Sites.Read.All에 동의가 부여되었는지, Microsoft Graph가 응답하는지 확인합니다.
SecureAI 사이드 패널에서 통과한 테스트
  1. **4.**에서 Show “Add from SharePoint” to users를 켠 상태로 두고 Save를 클릭합니다.
카드가 Available in the chat으로 바뀝니다.

​
6단계: 사용자의 사용 방법

  1. 채팅에서 사용자가 첨부 버튼을 클릭하고 Add from SharePoint를 선택합니다.
첨부 메뉴의 Add from SharePoint
  1. 처음에는 Sign in with Microsoft를 클릭하고 조직 계정을 선택합니다.
  2. Sites, Shared 또는 검색으로 이동하여 파일을 하나 이상 선택하고 Add를 클릭합니다.
  3. 파일이 SharePoint 아이콘과 함께 메시지에 첨부됩니다.

​
사용 가능한 사용자 제한(선택 사항)

일부 사용자 또는 그룹만 Add from SharePoint를 사용할 수 있도록 하려면 다음과 같이 합니다.
  1. Entra에서 엔터프라이즈 애플리케이션(Enterprise applications)으로 이동하여 등록한 애플리케이션을 엽니다.
  2. 속성(Properties)에서 할당 필요?(Assignment required?)를 켜고 저장합니다.
  3. 사용자 및 그룹(Users and groups)에서 사용을 허용할 사용자 또는 그룹을 할당합니다.
할당되지 않은 사용자는 로그인 시 AADSTS50105 오류가 표시되며 파일을 첨부할 수 없습니다.

​
문제 해결

​
자주 묻는 질문

SecureAI는 무엇을 읽을 수 있나요? 로그인한 사용자가 이미 읽을 수 있는 항목만, 그리고 사용자가 탐색기에서 파일을 선택할 때만 읽을 수 있습니다. 권한은 위임된 것이며, SecureAI가 “애플리케이션으로서” 귀사의 SharePoint에 접근하는 경로는 없습니다. 조건부 액세스 정책이 적용되나요? 예. 로그인은 일반적인 Microsoft 365 로그인이며 MFA, 관리되는 디바이스 및 기타 정책을 준수합니다. 어떻게 비활성화하나요? Show “Add from SharePoint” to users를 끄고 저장하거나, Remove configuration을 클릭합니다. 이미 발급된 토큰도 취소하려면 Entra ID에서 앱 등록을 삭제하거나 엔터프라이즈 애플리케이션의 로그인을 비활성화하십시오. Hiper AI가 이미 SharePoint를 설정해 주었습니다. 따로 해야 할 일이 있나요? 아니요. 자체 설정을 저장하지 않는 한 카드에는 Configured by Hiper AI가 표시되며 모든 것이 그대로 작동합니다. 자체 설정을 저장하면 기존 설정을 대체합니다.