Microsoft SharePoint 통합 - Amazon Quick
할 수 있는 작업시작하기 전 준비 사항Microsoft 앱 등록 및 인증 준비SharePoint 통합 설정사용 가능한 작업 작업지식 기반 관리SharePoint 통합 관리문제 해결

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

Microsoft SharePoint 통합

Microsoft SharePoint 통합을 사용하면 SharePoint 목록 및 항목에 대한 작업을 수행할 수 있습니다. 문서 라이브러리, 사이트 및 페이지를 포함하여 SharePoint 콘텐츠에서 지식 기반을 생성할 수도 있습니다.

할 수 있는 작업

SharePoint 사용자는 SharePoint 사이트 및 문서 라이브러리에 저장된 콘텐츠에 대해 질문할 수 있습니다. 예를 들어 사용자는 프로젝트 문서, 팀 사이트에 대해 질문하거나 여러 라이브러리에서 특정 정보를 검색할 수 있습니다. 통합을 통해 사용자는 위치나 유형에 관계없이 SharePoint 콘텐츠의 정보에 빠르게 액세스하고 이해할 수 있으며 게시 날짜, 수정 기록, 문서 소유권과 같은 컨텍스트 세부 정보를 제공하여 보다 효율적인 정보 검색과 정보에 입각한 의사 결정에 기여합니다.

시작하기 전 준비 사항

SharePoint 통합을 설정하기 전에 다음 사항이 있는지 확인합니다.

  • Microsoft SharePoint Online

  • 작업 커넥터의 경우: Amazon Quick Enterprise 구독

  • 데이터 액세스의 경우: Amazon Quick Professional 구독 이상 - 관리자의 일회성 단계로 사용자가 데이터를 가져오는 SharePoint 통합을 생성하기 전에 Microsoft 관리자가 먼저 조직 동의를 부여해야 할 수 있습니다. 이는 사용자 동의 설정이 관리자 승인을 우회하도록 허용하지 않는 한 Microsoft가 새 애플리케이션(이 경우 관리형 OAuth 애플리케이션)을 사용할 때 관리자 승인을 요구하기 때문입니다. 관리자는 SharePoint용 통합 생성 중에 로그인하고 "조직을 대신하여 동의"를 확인하여 조직 전체의 동의를 부여할 수 있습니다.

Microsoft 앱 등록 및 인증 준비

Amazon Quick에서 통합을 설정하기 전에 Microsoft 앱 등록 및 인증 자격 증명을 준비합니다. SharePoint 통합은 통합 유형 및 사용자 계층에 따라 다양한 인증 방법을 지원합니다.

작업 커넥터 인증 설정

작업 커넥터의 경우 다음 방법 중 하나를 사용하여 인증 자격 증명을 준비합니다.

사용자 인증(3LO)

Microsoft Azure AD 앱 등록에서 다음 정보를 수집합니다.

  • 기본 URL - SharePoint 사이트 URL입니다.

  • 클라이언트 ID - AWS 애플리케이션 클라이언트 ID입니다.

  • 클라이언트 보안 암호 - AWS 애플리케이션 클라이언트 보안 암호입니다.

  • 토큰 URL - OAuth 토큰 엔드포인트.

  • 인증 URL - OAuth 권한 부여 엔드포인트입니다.

  • 리디렉션 URL - OAuth 리디렉션 URI.

필수 OAuth 범위:

  • offline_access

  • Notes.Read.All

  • Sites.Read.All

  • AllSites.Read(공유점)

  • User.Read

서비스 인증(API 키)

SharePoint 관리자로부터 다음 정보를 수집합니다.

  • 기본 URL - SharePoint 사이트 URL입니다.

  • API 키 - SharePoint API 액세스 키입니다.

  • 이메일 - 연결된 서비스 계정 이메일입니다.

토큰 생성에 필요한 범위:

  • .default - 기본 애플리케이션 권한 범위입니다.

데이터 액세스 인증 설정

Amazon Quick은 3각 OAuth(3LO)를 사용하여 SharePoint 지식 기반 통합 생성을 지원합니다. 이 접근 방식을 위해 Amazon Quick은 Microsoft Entra 계정에 위임된 권한(Sites.Read.All)이 있는 다중 테넌트 앱을 등록합니다. 위임된 권한 모델은 멀티 테넌트 애플리케이션임에도 불구하고 위험을 낮게 유지합니다. Quick은 인증된 사용자의 권한을 통해서만 SharePoint에 액세스할 수 있습니다. 보안 모델은 Quick이 사용자가 액세스할 수 있는 것으로 제한되도록 합니다.

관리자가 사용자가 Amazon Quick으로 데이터를 가져오도록 허용하는 조직의 동의를 제공하면 Azure는 고객 테넌트에 서비스 보안 주체(엔터프라이즈 애플리케이션)를 자동으로 생성합니다. 엔터프라이즈 애플리케이션에서 언제든지이 서비스 보안 주체를 비활성화하거나 삭제하여 모든 액세스를 즉시 취소할 수 있습니다.

데이터 액세스 통합의 경우 Microsoft 3LO 인증을 준비합니다. 통합 설정 중에 다음을 수행해야 합니다.

  1. SharePoint 콘텐츠에 액세스할 수 있는 Microsoft 계정으로 로그인합니다.

  2. Amazon Quick이 SharePoint 데이터에 액세스할 수 있도록 요청된 권한을 부여합니다.

  3. 인증 프로세스를 완료합니다.

SharePoint 통합 설정

Microsoft 앱 등록 및 인증 자격 증명을 준비한 후 Amazon Quick 콘솔의 통합 탭을 사용하여 SharePoint 통합을 설정합니다. 설정 프로세스는 작업을 수행할지, 데이터에 액세스할지 또는 둘 다 수행할지에 따라 달라집니다.

  1. Amazon Quick 콘솔에서 통합을 선택합니다.

  2. 통합 옵션에서 Microsoft SharePoint를 선택하고 추가(+) 버튼을 클릭합니다.

  3. 통합 유형을 선택합니다.

    • Microsoft SharePoint에서 데이터 가져오기 - 지식 기반 생성을 위한 데이터 연결을 설정합니다.

    • Microsoft SharePoint에서 작업 수행 - SharePoint 목록 및 항목에 대한 작업을 활성화합니다.

  4. 지식 기반 생성(Microsoft SharePoint에서 데이터 가져오기):

    1. 다음을 선택합니다.

    2. 이름을 입력하고 인증을 완료합니다.

    3. 추가할 pages/files/folders를 선택합니다.

    4. 이름, 설명 및 콘텐츠 URLs과 같은 세부 정보를 입력합니다.

    5. 생성 및 계속을 선택합니다.

  5. 작업의 경우(Microsoft SharePoint에서 작업 수행):

    1. 다음을 선택합니다.

    2. 이름 및 설명을 추가합니다.

    3. 연결 유형을 선택합니다.

      • 사용자 인증 - 개별 사용자 액세스를 위한 3LO-based 인증입니다.

      • 서비스 인증 - 서비스 액세스를 위한 API 키 기반 인증입니다.

    4. 이전에 준비한 자격 증명을 사용하여 선택한 인증 방법(사용자 또는 서비스)을 기반으로 연결 설정을 입력합니다.

    5. 생성 및 계속을 선택합니다.

    6. 통합을 공유할 사용자를 선택합니다.

    7. 다음을 클릭합니다.

생성을 클릭하면 데이터 동기화가 자동으로 시작됩니다.

사용 가능한 작업 작업 검토

작업 기능과 SharePoint 통합을 설정한 후 사용 가능한 작업 작업을 검토하여 수행할 수 있는 작업을 이해합니다. 사용 가능한 작업의 전체 목록은 사용 가능한 작업 작업 섹션을 참조하세요.

지식 기반 구성

데이터 액세스 기능과 SharePoint 통합을 설정한 후 추가 지식 기반을 생성할 수 있습니다. 자세한 구성 옵션은 섹션을 참조지식 기반 관리하세요.

사용 가능한 작업 작업

SharePoint 작업 커넥터는 SharePoint 콘텐츠를 관리하기 위한 19가지 작업을 제공합니다.

SharePoint 작업
작업 이름 설명 형식
항목 생성 새 목록 항목 생성 쓰기
항목 업데이트 기존 목록 항목 업데이트 쓰기
항목 삭제 목록 항목 삭제 쓰기
항목 가져오기 특정 목록 항목 검색 읽기
항목 나열 SharePoint 목록의 항목 나열 읽기
목록 가져오기 SharePoint 목록의 세부 정보 검색 읽기
참고

Excel 파일 관리, 사이트 작업 및 고급 목록 관리에 대한 추가 작업을 사용할 수 있습니다. 통합을 생성한 후 전체 작업 목록을 검토합니다.

지식 기반 관리

SharePoint 통합을 설정한 후 SharePoint 콘텐츠에서 지식 기반을 생성하고 관리할 수 있습니다.

기존 지식 기반 편집

기존 SharePoint 지식 기반을 수정할 수 있습니다.

  1. Amazon Quick 콘솔에서 지식 기반을 선택합니다.

  2. 목록에서 SharePoint 지식 기반을 선택합니다.

  3. 작업에서 점 3개 아이콘을 선택한 다음 지식 기반 편집을 선택합니다.

  4. 필요에 따라 구성 설정을 업데이트하고 저장을 선택합니다.

추가 지식 기반 생성

동일한 SharePoint 통합에서 여러 지식 기반을 생성할 수 있습니다.

  1. Amazon Quick 콘솔에서 통합을 선택한 다음 데이터 탭을 선택합니다.

  2. 목록에서 기존 SharePoint 통합을 선택합니다.

  3. 작업에서 점 3개 아이콘을 선택한 다음 지식 기반 생성을 선택합니다.

  4. 지식 기반 설정을 구성하고 생성을 선택합니다.

지식 기반 구성 옵션에 대한 자세한 내용은 섹션을 참조하세요공통 구성 설정.

지원되는 콘텐츠 유형

이러한 SharePoint 콘텐츠 유형에서 지식 기반을 생성할 수 있습니다.

  • 문서 라이브러리: Word, Excel, PowerPoint, PDF, OneNote(.one)

  • 미디어 파일: MP3, MP4, MOV, WMV

  • 사이트 페이지 및 Wiki 페이지

SharePoint 통합 관리

참고

Amazon Quick은 데이터 소스의 ACLs 동기화하지 않습니다. Amazon Quick에서 지식 기반을 생성할 때 기본적으로 지식 기반에서 인사이트를 얻을 수 있습니다. 공유 콘텐츠의 경우 지식 기반 권한을 업데이트하여 다양한 사용자 및 그룹에 대한 액세스를 제공할 수 있습니다.

문제 해결

이 섹션을 사용하여 SharePoint 통합과 관련된 일반적인 문제를 해결합니다.

인증 문제

Azure AD 문제

증상: Azure AD 오류, 토큰 새로 고침 실패 또는 권한 거부 메시지와 함께 인증이 실패합니다.

원인 및 해결 방법:

  • 잘못된 앱 등록: Azure AD 앱 등록에 필요한 API 권한 및 OAuth 범위가 포함되어 있는지 확인합니다.

  • 만료된 클라이언트 보안 암호: 클라이언트 보안 암호가 만료되었는지 확인하고 필요한 경우 새 보안 암호를 생성합니다.

  • 권한 부족: 앱 등록에 필요한 권한에 대한 관리자 동의가 부여되었는지 확인합니다.

  • 잘못된 리디렉션 URI: Azure AD의 리디렉션 URI가 Amazon Quick에 구성된 URI와 일치하는지 확인합니다.

권한 동기화 실패

증상: 사용자는 권한이 있어야 하는 콘텐츠에 액세스하거나 액세스해서는 안 되는 콘텐츠를 볼 수 없습니다.

원인 및 해결 방법:

  • 권한 전파 지연: SharePoint 권한이 전파되는 데 시간이 걸릴 수 있습니다. 15~30분 정도 기다렸다가 다시 시도하세요.

  • 중첩 그룹 권한: 사용자가 권한에 영향을 미칠 수 있는 중첩 보안 그룹의 일부인지 확인합니다.

  • 중단된 권한 상속: SharePoint 항목이 권한 상속을 예기치 않게 중단하지 않았는지 확인합니다.

동기화 성능 문제

느린 동기화

증상: 지식 기반 동기화가 예상보다 오래 걸리거나 중단되는 것처럼 보입니다.

원인 및 해결 방법:

  • 대용량 콘텐츠 볼륨: 더 제한적인 필터를 적용하여 동기화되는 콘텐츠의 범위를 줄입니다.

  • 네트워크 연결: 네트워크 연결 안정성 및 대역폭 가용성을 확인합니다.

  • SharePoint 제한: SharePoint에서 요청을 제한하고 있을 수 있습니다. 사용량이 적은 시간에 동기화를 다시 시도합니다.

콘텐츠 검색 문제

증상: 예상 SharePoint 콘텐츠가 지식 기반에 표시되지 않습니다.

원인 및 해결 방법:

  • 콘텐츠 필터가 너무 제한적임: 누락된 콘텐츠를 포함하도록 콘텐츠 필터링 설정을 검토하고 조정합니다.

  • 지원되지 않는 콘텐츠 유형: 콘텐츠 유형이 SharePoint 통합에서 지원되는지 확인합니다.

  • 권한 제한: 통합에 콘텐츠에 액세스할 수 있는 적절한 권한이 있는지 확인합니다.

일반적인 오류 메시지

AADSTS50020: User account from identity provider does not exist in tenant

원인: Azure AD에서 사용자 계정이 제대로 구성되지 않았습니다.

해결 방법: 사용자 계정이 올바른 Azure AD 테넌트에 있고 적절한 라이선스가 있는지 확인합니다.

Access denied. You do not have permission to perform this action

원인: 요청된 작업에 대한 SharePoint 권한이 부족합니다.

해결 방법: SharePoint 관리자에게 문의하여 적절한 권한을 확인하고 부여합니다.

The request is throttled

원인: SharePoint는 사용량이 많아 요청 수를 제한하고 있습니다.

해결 방법: 작업을 기다렸다가 다시 시도합니다. 사용량이 적은 시간에 요청 빈도를 줄이거나 동기화하는 것이 좋습니다.