Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Hubungkan sumber data Confluence
Setelah Anda mengatur otentikasi dan menyimpan kredensyal Anda secara AWS Secrets Manager rahasia, buat sumber data Confluence di basis pengetahuan Anda. Halaman ini menjelaskan cara membuat sumber data dengan Konsol Manajemen AWS atau API, diikuti dengan referensi untuk parameter konektor yang dapat Anda konfigurasi.
**catatan**
Selesaikan pengaturan otentikasi terlebih dahulu. Lihat [Menyiapkan otentikasi dasar untuk Confluence](kb-managed-confluence-basic-setup.md) atau [Siapkan otentikasi OAuth 2.0 untuk Confluence](kb-managed-confluence-oauth2-setup.md). Anda memerlukan ARN rahasia dan URL host Confluence.
## Buat sumber data
------
#### [ Console ]
**Untuk menghubungkan Confluence ke basis pengetahuan terkelola Anda**
1. Di bawah **Sumber data**, berikan nama untuk sumber data Anda.
1. Pilih **Confluence dari dropdown** sumber data.
1. Di bawah **Sumber**, masukkan URL Confluence Anda (misalnya,`https://example.atlassian.net`).
1. Di bawah **Otentikasi**, pilih Autentikasi **dasar atau otentikasi** **OAuth 2.0**.
1. Pilih atau buat AWS Secrets Manager rahasia untuk menyimpan kredensyal Anda.
1. (Opsional, Hanya autentikasi dasar) Untuk mengaktifkan kontrol akses tingkat dokumen, pilih **Kontrol akses dokumen** dengan ACL. Rahasia yang Anda pilih harus mencakup`adminApiKey`,`organizationId`, dan`directoryId`. Opsi ini tidak dapat diubah setelah pembuatan. Lihat perinciannya di [Document-level kontrol akses](kb-managed-ds-confluence-acl.md).
1. (Opsional) Perluas **cakupan Sinkronisasi** untuk memilih jenis entitas mana yang akan dirayapi (halaman, blog, lampiran halaman, lampiran blog, ruang arsip, halaman yang diarsipkan, ruang pribadi).
1. (Opsional) Perluas **URL Entitas** untuk menggunakan URL-based pemfilteran untuk menyinkronkan ruang, halaman, dan blog Confluence tertentu.
1. (Opsional) Perluas **pola regex tipe Mime** untuk menyertakan atau mengecualikan tipe MIME tertentu.
------
#### [ API ]
Untuk membuat sumber data Confluence, kirim [CreateDataSource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_CreateDataSource.html)permintaan dengan titik akhir waktu build Agen untuk Amazon Bedrock. AWS Command Line Interface Contoh berikut membuat sumber data yang menggunakan otentikasi Dasar. Untuk menggunakan OAuth 2.0 sebagai gantinya, ubah `authType` ke. `OAUTH2` Untuk mengaktifkan kontrol akses tingkat dokumen, setel ke. `aclEnabled` `true` Untuk deskripsi setiap bidang, lihat referensi parameter konektor berikut.
```
aws bedrock-agent create-data-source \
--name "{{Confluence-connector}}" \
--knowledge-base-id "{{your-knowledge-base-id}}" \
--data-source-configuration file://confluence-managed-connector.json
```
`confluence-managed-connector.json`File tersebut berisi yang berikut:
```
{
"type": "MANAGED_KNOWLEDGE_BASE_CONNECTOR",
"managedKnowledgeBaseConnectorConfiguration": {
"connectorParameters": {
"type": "CONFLUENCE",
"version": "1",
"aclEnabled": false,
"connectionConfiguration": {
"secretArn": "{{arn:aws:secretsmanager:us-west-2:123456789012:secret:bedrock-confluence-basic-creds}}",
"type": "SAAS",
"authType": "BASIC",
"hostUrl": "{{https://example.atlassian.net}}"
},
"dataEntityConfiguration": {
"crawlPage": true,
"crawlBlog": true,
"crawlPageAttachment": true,
"crawlBlogAttachment": true
},
"filterConfiguration": {
"inclusionSpaceKeys": ["{{ENG}}", "{{DOCS}}"]
}
}
}
}
```
Untuk basis pengetahuan terkelola, `CreateDataSource` asinkron: transisi status sumber data dari `CREATING` ke `AVAILABLE` saat operasi selesai.
------
## Parameter konektor
Konfigurasi sumber data menggunakan parameter konektor berikut. Untuk terhubung ke Confluence, tentukan `CONFLUENCE` sebagai tipe konektor di. `connectorParameters` Untuk bidang yang membungkus `connectorParameters` (seperti `deletionProtectionConfiguration` dan`mediaExtractionConfiguration`), lihat[Connect sumber data](kb-managed-connect-ds.md).
**Setel `ACLEnabled secara eksplisit`**
Jika Anda menghilangkan`aclEnabled`, defaultnya bergantung pada`authType`: `BASIC` default ke`true`, dan default ke. `OAUTH2` `false` Karena konfigurasi ACL bersifat permanen setelah sumber data dibuat, atur `aclEnabled` secara eksplisit sehingga sumber data memiliki perilaku kontrol akses yang Anda inginkan. Lihat perinciannya di [Document-level kontrol akses](kb-managed-ds-confluence-acl.md).
**ConnectionConfiguration**
| Bidang | Diperlukan | Deskripsi |
| --- | --- | --- |
| secretArn | Ya | ARN AWS Secrets Manager rahasia yang berisi kredenal Confluence Anda. |
| type | Ya | Jenis penyebaran Confluence. Setel keSAAS. Server Confluence dan Pusat Data tidak didukung. |
| authType | Ya | Jenis otentikasi. Setel ke BASIC atauOAUTH2. Lihat [Metode autentikasi](kb-managed-ds-confluence.md#kb-managed-confluence-auth-methods). |
| hostUrl | Ya | URL dasar instans Confluence Cloud Anda (misalnya,https://example.atlassian.net). |
**data EntityConfiguration (opsional)**
| Bidang | Diperlukan | Deskripsi |
| --- | --- | --- |
| crawlPage | Tidak | Apakah akan merayapi halaman. |
| crawlBlog | Tidak | Apakah akan merayapi posting blog. |
| crawlPageAttachment | Tidak | Apakah akan merayapi lampiran halaman. Merangkak hanya ketika crawlPage jugatrue. |
| crawlBlogAttachment | Tidak | Apakah akan merayapi lampiran posting blog. Merangkak hanya ketika crawlBlog jugatrue. |
| crawlArchivedSpace | Tidak | Apakah akan merayapi ruang yang diarsipkan. |
| crawlArchivedPage | Tidak | Apakah akan merayapi halaman yang diarsipkan. |
| crawlPersonalSpace | Tidak | Apakah akan merangkak ruang pribadi. |
**FilterConfiguration (opsional)**
| Bidang | Diperlukan | Deskripsi |
| --- | --- | --- |
| inclusionSpaceKeys | Tidak | Tombol spasi untuk disertakan. |
| inclusionSpaceUrls | Tidak | URL luar angkasa untuk disertakan. |
| inclusionMimeTypes | Tidak | Jenis MIME untuk disertakan. |
| exclusionMimeTypes | Tidak | Jenis MIME untuk dikecualikan. |
| maxFileSizeInMegaBytes | Tidak | Ukuran maksimum, dalam megabyte, dari setiap file tunggal yang dicerna konektor. Berikan sebagai string numerik (misalnya,"500"). Default ke "500". |
**ACLENabled (opsional)**
| Bidang | Diperlukan | Deskripsi |
| --- | --- | --- |
| aclEnabled | Tidak | Apakah kontrol akses tingkat dokumen diaktifkan. Setel true untuk mengaktifkan, atau false untuk menonaktifkan. Jika Anda menghilangkan bidang ini, defaultnya bergantung padaauthType: BASIC default ke; default ketrue. OAUTH2 false ACL on BASIC membutuhkan rahasia yang mencakup kredensyal admin organisasi Atlassian. Anda tidak dapat mengubah pengaturan ini setelah Anda membuat sumber data. Lihat perinciannya di [Document-level kontrol akses](kb-managed-ds-confluence-acl.md). |
## Ubah metode otentikasi
Anda dapat mengubah metode otentikasi sumber data (misalnya, dari OAuth 2.0 ke Basic) dengan memperbarui sumber data dengan yang baru `authType` dan rahasia yang berisi kredensyal yang cocok, menggunakan operasi atau. [UpdateDataSource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_UpdateDataSource.html) Konsol Manajemen AWS Pengaturan kontrol akses tingkat dokumen diperbaiki saat Anda membuat sumber data, jadi untuk menambah atau menghapus ACL, Anda harus membuat sumber data baru.
## Langkah selanjutnya
Setelah Anda membuat sumber data, sinkronkan untuk menyerap konten ke basis pengetahuan Anda. Lihat perinciannya di [Sinkronkan sumber data](kb-managed-sync.md). Untuk memfilter hasil kueri berdasarkan izin pengguna, lihat[Document-level kontrol akses](kb-managed-ds-confluence-acl.md).