기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# Microsoft OneDrive 작업 통합
Microsoft OneDrive 작업 커넥터를 사용하여 자연어를 통해 Amazon Quick에서 직접 OneDrive 파일, 폴더 및 Excel 통합 문서를 관리할 수 있습니다.
이 통합을 설정하려면 두 단계가 필요합니다. 먼저 Microsoft Entra에 애플리케이션을 등록하고 해당 권한을 구성합니다. 그런 다음 Amazon Quick에서 통합을 생성하고 Entra 앱에 연결합니다. Amazon Quick에서 지원하는 인증 방법에 대한 자세한 내용은 섹션을 참조하세요[인증 방법](quick-action-auth.md).
## 시작하기 전 준비 사항
통합을 설정하기 전에 다음 사항이 있는지 확인합니다.
+ OneDrive 액세스 권한이 있는 Microsoft 365 계정.
+ 최소한 Application Developer 권한이 있는 [Microsoft Entra 관리자 센터에](https://entra.microsoft.com/) 액세스합니다.
+ 구독 요구 사항은 섹션을 참조하세요[콘솔에서 통합 설정](integration-console-setup-process.md).
## Microsoft Entra 구성
Amazon Quick을 구성하기 전에 Microsoft Entra에서 앱 등록을 생성합니다. Amazon Quick 콘솔로 이동하기 전에 Entra에서 다음 단계를 모두 완료합니다.
앱 등록에 대한 자세한 내용은 [Microsoft 설명서의 Microsoft 자격 증명 플랫폼에 애플리케이션 등록](https://learn.microsoft.com/en-us/entra/identity-platform/quickstart-register-app)을 참조하세요.
### 애플리케이션 등록
1. [Microsoft Entra 관리자 센터를](https://entra.microsoft.com/) 엽니다.
1. 왼쪽 탐색 창에서 **Entra ID**를 선택한 다음 **앱 등록을** 선택합니다.
1. **새 등록**을 선택합니다.
1. **이름**에 통합을 설명하는 이름을 입력합니다.
1. **지원되는 계정 유형****에서이 조직 디렉터리에서만 계정을** 선택합니다.
1. **리디렉션 URI**에서 **웹**을 선택하고를 입력합니다`https://{region}.quicksight.aws.amazon.com/sn/oauthcallback`. *\$1region\$1*을 Amazon Quick 인스턴스가 배포된 AWS 리전으로 바꿉니다.
1. **등록**을 선택합니다.
1. 개요 페이지에서 **애플리케이션(클라이언트) ID**와 **디렉터리(테넌트) ID**를 복사합니다. Amazon Quick 구성에는 이러한 값이 필요합니다.
### 클라이언트 보안 암호 생성
Amazon Quick에서 Microsoft Entra로 인증하려면 클라이언트 보안 암호가 필요합니다. 이 보안 암호는 앱 등록을 위한 암호 역할을 합니다.
1. 앱 등록에서 **인증서 및 보안 암호를** 선택합니다.
1. **새 클라이언트 암호를** 선택합니다.
1. 설명을 입력하고 만료 기간을 선택합니다.
1. **추가**를 선택합니다.
1. **값을** 즉시 복사합니다. 이 값은 한 번만 표시됩니다.
**중요**
보안 암호 ID가 아닌 보안 암호 **값을** 복사합니다. 값은 인증에 사용되는 더 긴 문자열입니다.
### API 권한 구성
이 통합은 앱이 로그인한 사용자를 대신하여 작동할 수 있는 위임된 권한을 사용합니다. 자세한 내용은 [Microsoft 설명서의 Microsoft 그래프 권한 개요를](https://learn.microsoft.com/en-us/graph/permissions-overview) 참조하세요.
1. 앱 등록에서 **API 권한을** 선택합니다.
1. **권한 추가를** 선택한 다음 **Microsoft 그래프**를 선택합니다.
1. **위임된 권한을** 선택하고 아래 표에서 권한을 추가합니다.
1. **[테넌트 이름]에 대한 관리자 동의 부여**를 선택하여 권한을 승인합니다.
Entra 앱 등록에 다음을 위임된 권한으로 추가합니다. 전체 권한 참조는 [Microsoft 설명서의 Microsoft Graph 권한 참조](https://learn.microsoft.com/en-us/graph/permissions-reference)를 참조하세요.
**OneDrive 작업 통합 - 위임된 권한**
| 권한 | 설명 |
| --- | --- |
| Files.ReadWrite | 앱이 로그인한 사용자의 파일을 읽고, 생성하고, 업데이트하고, 삭제할 수 있도록 허용합니다. |
| User.Read.All | 앱이 로그인한 사용자를 대신하여 조직 내 모든 사용자의 전체 프로필 속성 세트를 읽을 수 있도록 허용합니다. |
| offline\$1access | 사용자가 다시 로그인할 필요 없이 앱이 액세스 토큰을 새로 고칠 수 있도록 허용합니다. 이렇게 하면 사용자가 재인증해야 하는 빈도가 줄어듭니다. |
### 자격 증명 기록
Microsoft Entra 관리자 센터를 떠나기 전에 다음 값이 있는지 확인합니다. Amazon Quick 구성에 필요합니다.
**Microsoft Entra의 필수 자격 증명**
| 값 | 찾을 수 있는 위치 |
| --- | --- |
| 애플리케이션(클라이언트) ID | 앱 등록 개요 페이지 |
| 디렉터리(테넌트) ID | 앱 등록 개요 페이지 |
| 클라이언트 시크릿 값 | 인증서 및 보안 암호 페이지 |
## Amazon Quick에서 통합 설정
Entra 구성을 완료한 후 Amazon Quick에서 통합을 생성합니다.
1. Amazon Quick 콘솔에서 **통합을** 선택합니다.
1. **Microsoft OneDrive**를 선택하고 추가(더하기 "\$1") 버튼을 선택합니다.
1. **추가 기능** 탭을 선택합니다.
1. **Microsoft OneDrive에서 작업 수행을** 선택합니다.
1. 통합 세부 정보를 입력합니다.
+ **이름** - OneDrive 통합에 대한 설명 이름입니다.
+ **설명**(선택 사항) - 통합의 목적입니다.
1. 연결 설정을 입력합니다.
+ **기본 URL** - `https://graph.microsoft.com/v1.0`
+ **클라이언트 ID** - Entra 앱 등록의 애플리케이션(클라이언트) ID입니다.
+ **클라이언트 보안 암호** - Entra 앱 등록의 클라이언트 보안 암호 값입니다.
+ **토큰 URL** - `https://login.microsoftonline.com/{tenant-id}/oauth2/v2.0/token`
+ **인증 URL** - `https://login.microsoftonline.com/{tenant-id}/oauth2/v2.0/authorize`
+ **리디렉션 URL** - `https://{region}.quicksight.aws.amazon.com/sn/oauthcallback`
1. **Create and continue**를 선택합니다.
1. 통합을 공유할 사용자를 선택합니다.
1. **다음**을 선택합니다.
## 사용 가능한 작업
통합을 설정한 후 다음 작업을 사용할 수 있습니다.
**Microsoft OneDrive 사용 가능한 작업**
| 카테고리 | 작업 | 설명 |
| --- | --- | --- |
| 드라이브 및 항목 | 드라이브 가져오기 | 드라이브의 속성 및 관계를 검색합니다. |
| 드라이브 및 항목 | 항목 나열 | 드라이브에 포함된 모든 항목을 가져옵니다. |
| 드라이브 및 항목 | 항목 가져오기 | 드라이브에 포함된 항목을 가져옵니다. |
| 드라이브 및 항목 | Create Folder | 사용자 드라이브에 새 폴더를 생성합니다. |
| 드라이브 및 항목 | 항목 업데이트 | 파일 또는 폴더의 메타데이터를 업데이트합니다. |
| 드라이브 및 항목 | 항목 삭제 | 파일 또는 폴더를 삭제합니다. 항목을 휴지통으로 이동합니다. |
| 드라이브 및 항목 | 하위 폴더 나열 | 폴더의 하위 항목에 있는 항목 모음을 반환합니다. |
| 드라이브 및 항목 | 항목 복사 | 파일 또는 폴더의 사본을 다른 위치에 생성합니다. |
| 드라이브 및 항목 | 권한 추가 | 파일 또는 폴더에 대한 공유 초대장을 보냅니다. |
| 드라이브 및 항목 | 파일 업로드 | 새 파일을 업로드하거나 기존 파일을 업데이트합니다. 최대 250MB의 파일을 지원합니다. |
| Excel 통합 문서 | List Sheets | 워크시트 객체 목록을 검색합니다. |
| Excel 통합 문서 | 시트 추가 | 통합 문서에 새 워크시트를 추가합니다. |
| Excel 통합 문서 | 읽기 시트 | 워크시트 객체의 속성을 검색합니다. |
| Excel 통합 문서 | 업데이트 시트 | 워크시트 객체의 속성을 업데이트합니다. |
| Excel 통합 문서 | 시트 삭제 | 통합 문서에서 워크시트를 삭제합니다. |
| Excel 통합 문서 | 셀 읽기 | 행 및 열 번호별로 단일 셀의 값을 가져옵니다. |
| Excel 통합 문서 | 셀 쓰기 | 행 및 열 번호별로 단일 셀의 값을 설정합니다. |
| Excel 통합 문서 | 읽기 범위 | 범위의 값을 가져옵니다. |
| Excel 통합 문서 | 쓰기 범위 | 범위의 값을 업데이트합니다. |
| Excel 통합 문서 | 범위 지우기 | 범위 값, 형식, 채우기 및 테두리를 지웁니다. |
| Excel 통합 문서 | 범위 삭제 | 범위와 연결된 셀을 삭제합니다. |
| Excel 통합 문서 | 사용된 범위 가져오기 | 값 또는 형식이 있는 셀을 포함하는 가장 작은 범위를 가져옵니다. |
## 관리 및 문제 해결
통합을 편집, 공유 또는 삭제하려면 섹션을 참조하세요[기존 통합 관리](integration-workflows.md#managing-existing-integrations).
### 인증 문제
+ **잘못된 앱 등록** - Microsoft Entra의 앱 등록에 필요한 API 권한이 포함되어 있고 관리자 동의가 부여되었는지 확인합니다.
+ **만료된 클라이언트 보안** 암호 - 인증서 및 보안 암호에서 **클라이언트 보안 암호가 만료되었는지 확인하고 필요한 경우 새 보안 암호를** 생성합니다.
+ **잘못된 리디렉션 URI** - Microsoft Entra의 리디렉션 URI가와 일치하는지 확인합니다`https://{region}.quicksight.aws.amazon.com/sn/oauthcallback`.
### 일반적인 오류 메시지
+ **`Access denied. You do not have permission to perform this action`** - 인증된 사용자에게 필요한 권한이 없습니다. 관리자에게 문의하여 적절한 권한을 확인하고 부여합니다.
+ **`AADSTS50020: User account from identity provider does not exist in tenant`** - 사용자 계정이 올바른 Microsoft Entra 테넌트에 구성되지 않았습니다. 앱 등록의 디렉터리(테넌트) ID와 일치하는 사용자 계정이 테넌트에 있는지 확인합니다.