Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# OneNote Integrasi Microsoft
Dengan konektor OneNote tindakan Microsoft, Anda dapat mengelola notebook, bagian, dan halaman dari akun Microsoft 365 Anda langsung di Amazon Quick melalui bahasa alami. Konektor menggunakan Microsoft Graph untuk OneNote operasi.
Amazon Quick mendukung dua metode otentikasi untuk Microsoft OneNote. Pilih metode yang paling sesuai dengan persyaratan keamanan organisasi Anda.
+ Aplikasi **OAuth default — Menggunakan aplikasi** OAuth yang AWS dikelola. Tidak diperlukan kredensi tambahan. Pengguna mengautentikasi langsung dengan akun Microsoft 365 mereka.
+ Aplikasi **OAuth khusus — Menggunakan aplikasi** yang dikelola pelanggan yang terdaftar di Microsoft Entra ID. Opsi ini memberi organisasi Anda kontrol penuh atas konfigurasi OAuth.
Untuk informasi selengkapnya tentang metode otentikasi yang didukung Amazon Quick, lihat[Metode autentikasi](quick-action-auth.md).
## Sebelum Anda mulai
Pastikan Anda memiliki yang berikut ini sebelum Anda mengatur integrasi.
+ Akun Microsoft 365 aktif dengan akses ke OneNote notebook yang ingin Anda gunakan.
+ Untuk **aplikasi OAuth Kustom**: Akses ke Microsoft Entra ID (sebelumnya Azure Active Directory) untuk mendaftarkan aplikasi dan mengonfigurasi izin Microsoft Graph untuk. OneNote
+ Untuk persyaratan berlangganan Amazon Quick, lihat[Siapkan integrasi di konsol](integration-console-setup-process.md).
## Mengkonfigurasi Microsoft Entra ID
Jika Anda menggunakan otentikasi **aplikasi OAuth Default**, lewati bagian ini dan lanjutkan ke. [Menyiapkan konektor di Amazon Quick](#microsoft-onenote-quicksuite-setup)
Untuk otentikasi aplikasi OAuth Kustom, daftarkan aplikasi di pusat [admin Microsoft Entra dan](https://entra.microsoft.com/) konfigurasikan izin Microsoft Graph untuk OneNote (seperti`Notes.Read`,`Notes.ReadWrite`, atau sesuai kebutuhan). `Notes.Read.All` Tambahkan URL callback Amazon Quick `https://{{{region}}}.quicksight.aws.amazon.com/sn/oauthcallback` sebagai URI pengalihan. Ganti {{{region}}} dengan AWS Wilayah Anda (misalnya,`us-east-1`). Untuk petunjuk langkah demi langkah, lihat [Dasar-dasar otentikasi dan otorisasi](https://learn.microsoft.com/en-us/graph/auth/auth-concepts) dalam dokumentasi Microsoft Graph. Rekam ID Aplikasi (klien) dan nilai rahasia klien — Anda memerlukannya saat mengonfigurasi Amazon Quick.
## Menyiapkan konektor di Amazon Quick
### Connect dari tab Tersedia
Jika Anda ingin menggunakan otentikasi aplikasi OAuth Default, Anda dapat terhubung langsung dari tab **Tersedia** tanpa konfigurasi tambahan.
1. Di konsol Amazon Quick, pilih **Konektor**.
1. Pada tab **Tersedia**, temukan **OneNote**dan pilih **Connect**.
1. Selesaikan alur masuk Microsoft dan berikan izin yang diminta.
Untuk mengonfigurasi konektor dengan aplikasi Custom OAuth sebagai gantinya, gunakan tab **Buat untuk tim Anda** seperti yang dijelaskan di bawah ini.
### Buat dari tab Buat untuk tim Anda
1. Di konsol Amazon Quick, pilih **Konektor**.
1. Pilih tab **Buat untuk tim Anda**.
1. Temukan dan pilih **OneNote**.
1. Masukkan **Nama** untuk konektor Anda. Secara opsional, pilih **\+ Tambahkan Deskripsi** untuk menambahkan deskripsi.
1. Untuk **jenis Koneksi**, pilih **Jaringan publik**.
1. Untuk **Konfigurasi OAuth**, pilih salah satu metode otentikasi berikut dan konfigurasikan bidang yang diperlukan.
1. Untuk aplikasi **OAuth Default**:
Tidak diperlukan kredensi tambahan. Pilih **Next** untuk melanjutkan.
1. Untuk **aplikasi Custom OAuth**, konfigurasikan bidang berikut:
+ **URL Dasar** (Opsional) — URL dasar Microsoft Graph. Contoh: `https://graph.microsoft.com/v1.0`
+ **ID Klien — ID** Aplikasi (klien) dari pendaftaran aplikasi Microsoft Entra ID Anda.
+ **Klien OAuth Publik** (Opsional) - Pilih opsi ini jika aplikasi Microsoft Entra ID Anda dikonfigurasi sebagai klien publik (tidak ada rahasia klien).
+ **Rahasia klien** — Nilai rahasia klien dari pendaftaran aplikasi Microsoft Entra ID Anda.
+ **URL Token** — Titik akhir token platform identitas Microsoft. Contoh: `https://login.microsoftonline.com/common/oauth2/v2.0/token`
+ **URL Otorisasi** — Titik akhir otorisasi platform identitas Microsoft. Contoh: `https://login.microsoftonline.com/common/oauth2/v2.0/authorize`
+ **Redirect URL** — Pre-filled dengan URL callback Amazon Quick.
**catatan**
Untuk otentikasi khusus penyewa, ganti `common` URL Token dan URL Otorisasi dengan ID penyewa ID Microsoft Entra Anda.
1. Pilih **Berikutnya**.
1. Jendela masuk Microsoft terbuka. Tinjau izin yang diminta dan pilih **Terima**.
1. Pada halaman **Ulasan**, tinjau tindakan yang tersedia untuk konektor. Pilih **Berikutnya**.
1. Pada halaman **Publikasikan**, pilih siapa yang dapat mengakses konektor. Anda dapat mengaktifkan akses untuk semua orang di organisasi Anda atau mencari tim atau grup tertentu.
1. Pilih **Terbitkan**.
## Tindakan yang tersedia
Setelah Anda mengatur konektor, tindakan yang diekspos oleh OneNote tersedia. Untuk melihat rangkaian tindakan saat ini untuk konektor Anda, buka tampilan **Tindakan yang tersedia** konektor di konsol Amazon Quick.
## Mengelola dan memecahkan masalah
Untuk mengedit, membagikan, atau menghapus konektor Anda, lihat[Mengelola integrasi yang ada](integration-workflows.md#managing-existing-integrations).
### Masalah otentikasi
+ **Sign-in gagal (Aplikasi OAuth default atau aplikasi Custom OAuth)** — Verifikasi bahwa akun Microsoft 365 Anda aktif dan Anda dapat masuk ke OneNote web secara langsung. Untuk aplikasi OAuth Khusus, konfirmasikan bahwa URI pengalihan di aplikasi Microsoft Entra ID cocok dengan URL callback Amazon Quick.
+ **Izin tidak memadai** — Verifikasi bahwa izin Microsoft Graph yang dikonfigurasi di aplikasi Microsoft Entra ID Anda menyertakan OneNote cakupan yang diperlukan untuk operasi yang ingin Anda gunakan, dan bahwa persetujuan admin telah diberikan jika diperlukan.
+ **Kredensi klien tidak valid (aplikasi OAuth Kustom)** — Verifikasi bahwa ID Klien dan rahasia Klien cocok dengan nilai dalam pendaftaran aplikasi Microsoft Entra ID Anda. Konfirmasikan bahwa rahasia klien belum kedaluwarsa.