

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Menghubungkan pipeline Amazon OpenSearch Ingestion ke Atlassian Jira atau Confluence menggunakan 2.0 OAuth
<a name="configure-client-atlassian-OAuth2-setup"></a>

Gunakan informasi dalam topik ini untuk membantu Anda mengonfigurasi dan menghubungkan pipeline Amazon OpenSearch Ingestion ke akun Jira atau Confluence menggunakan autentikasi 2.0. OAuth Lakukan tugas ini saat menyelesaikan [Prasyarat](configure-client-atlassian.md#atlassian-prerequisites) untuk menggunakan pipeline OpenSearch Ingestion dengan Atlassian Services tetapi pilih untuk tidak menggunakan kredenal kunci API.

**Topics**
+ [Buat aplikasi integrasi OAuth 2.0](#create-OAuth2-integration-app)
+ [Menghasilkan dan menyegarkan token akses Pengembang Atlassian](#generate-and-refresh-jira-access-token)

## Buat aplikasi integrasi OAuth 2.0
<a name="create-OAuth2-integration-app"></a>

Gunakan prosedur berikut untuk membantu Anda membuat aplikasi integrasi OAuth 2.0 di situs web Pengembang Atlassian.

**Untuk membuat aplikasi integrasi OAuth 2.0**

1. [Masuk ke akun Atlassian Developer Anda di https://developer.atlassian.com/console/ myApps/.](https://developer.atlassian.com/console/myapps/)

1. Pilih **Buat**, **integrasi OAuth 2.0**.

1. Untuk **Nama**, masukkan nama untuk mengidentifikasi tujuan aplikasi.

1. **Pilih kotak centang **I agree to be bound by Atlassian Developer terms**, lalu pilih Create.**

1. Di navigasi kiri, pilih **Otorisasi**, lalu pilih **Tambah**.

1. Untuk **URL Callback**, masukkan URL apa pun, seperti **https://www.amazon.com** atau**https://www.example.com**, lalu pilih **Simpan perubahan**.

1. Di navigasi kiri, pilih halaman **Izin**, dan kemudian di baris untuk JIRA API, pilih **Tambah**, lalu pilih **Konfigurasi**. dan pilih semua izin Baca Lingkup Klasik (daftar yang diberikan di bawah) dan kemudian pilih Simpan

1. Pilih tab **Granular scopes**, lalu pilih **Edit Scopes** untuk membuka kotak dialog **Edit Jira API**.

1. Pilih izin untuk plugin sumber yang Anda gunakan:

------
#### [ Jira ]

   ```
   read:audit-log:jira
   read:issue:jira
   read:issue-meta:jira
   read:attachment:jira
   read:comment:jira
   read:comment.property:jira
   read:field:jira
   read:field.default-value:jira
   read:field.option:jira
   read:field-configuration-scheme:jira
   read:field-configuration:jira
   read:issue-link:jira
   read:issue-link-type:jira
   read:issue-link-type:jira
   read:issue.remote-link:jira
   read:issue.property:jira
   read:resolution:jira
   read:issue-details:jira
   read:issue-type:jira
   read:issue-worklog:jira
   read:issue-field-values:jira
   read:issue.changelog:jira
   read:issue.transition:jira
   read:issue.vote:jira
   read:jira-expressions:jira
   ```

------
#### [ Confluence ]

   ```
   read:content:confluence
   read:content-details:confluence
   read:space-details:confluence
   read:audit-log:confluence
   read:page:confluence
   read:blogpost:confluence
   read:custom-content:confluence
   read:comment:confluence
   read:space:confluence
   read:space.property:confluence
   read:space.setting:confluence
   read:content.property:confluence
   read:content.metadata:confluence
   read:task:confluence
   read:whiteboard:confluence
   read:app-data:confluence
   manage:confluence-configuration
   ```

------

1. Pilih **Simpan**.

Untuk informasi terkait, lihat [Menerapkan OAuth 2.0 (3LO)](https://developer.atlassian.com/cloud/oauth/getting-started/implementing-oauth-3lo/) dan [Menentukan cakupan yang diperlukan untuk operasi di situs](https://developer.atlassian.com/cloud/oauth/getting-started/determining-scopes/) web Pengembang Atlassian.

## Menghasilkan dan menyegarkan token akses Pengembang Atlassian
<a name="generate-and-refresh-jira-access-token"></a>

Gunakan prosedur berikut untuk membantu Anda membuat dan menyegarkan token akses Pengembang Atlassian di situs web Pengembang Atlassian.

**Untuk menghasilkan dan menyegarkan token akses Jira**

1. [Masuk ke akun Atlassian Developer Anda di https://developer.atlassian.com/console/ myApps/.](https://developer.atlassian.com/console/myapps/)

1. Pilih aplikasi yang Anda buat[Buat aplikasi integrasi OAuth 2.0](#create-OAuth2-integration-app).

1. Di navigasi kiri, pilih **Otorisasi**.

1. Salin nilai URL otorisasi API Atlassian granular dari bagian bawah halaman dan tempel ke editor teks pilihan Anda.

   Format URL adalah sebagai berikut:

   ```
   https://auth.atlassian.com/authorize?
   audience=api.atlassian.com 
   &client_id=YOUR_CLIENT_ID
   &scope=REQUESTED_SCOPE%20REQUESTED_SCOPE_TWO
   &redirect_uri=https://YOUR_APP_CALLBACK_URL
   &state=YOUR_USER_BOUND_VALUE 
   &response_type=code
   &prompt=consent
   ```

1. Untuk`state=YOUR_USER_BOUND_VALUE`, ubah nilai parameter menjadi apa pun yang Anda pilih, seperti state=””. **sample\$1text**

   Untuk informasi selengkapnya, lihat [Untuk apa parameter status digunakan?](https://developer.atlassian.com/cloud/jira/platform/oauth-2-3lo-apps/#what-is-the-state-parameter-used-for-) di situs web Pengembang Atlassian.

1. Perhatikan bahwa `scope` bagian ini mencantumkan cakupan granular yang Anda pilih dalam tugas sebelumnya. Misalnya: `scope=read%3Ajira-work%20read%3Ajira-user%20offline_access`

   `offline_access`menunjukkan bahwa Anda ingin menghasilkan`refresh_token`.

1. Buka jendela browser web dan masukkan URL otorisasi yang Anda salin ke bilah alamat jendela browser.

1. Saat halaman target terbuka, verifikasi bahwa informasinya benar, lalu pilih **Terima** untuk diarahkan ke beranda Jira atau Confluence Anda.

1. Setelah beranda dimuat, salin URL halaman ini. Ini berisi kode otorisasi untuk aplikasi Anda. Anda menggunakan kode ini untuk menghasilkan token akses Anda. Seluruh bagian setelahnya `code=` adalah kode otorisasi.

1. Gunakan perintah cURL berikut untuk menghasilkan token akses. Ganti *placeholder values* dengan informasi Anda sendiri.
**Tip**  
Anda juga dapat menggunakan layanan pihak ketiga seperti Tukang Pos.

   ```
   curl --request POST --url 'https://auth.atlassian.com/oauth/token' \
   --header 'Content-Type: application/json' \
   --data '{"grant_type": "authorization_code",
   "client_id": "YOUR_CLIENT_ID",
   "client_secret": "YOUR_CLIENT_SECRET",
   "code": "AUTHORIZATION_CODE",
   "redirect_uri": "YOUR_CALLBACK_URL"}'
   ```

   Respons terhadap perintah ini mencakup nilai-nilai untuk `access_code` dan`refresh_token`.