

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

# Siapkan aplikasi OAuth 2.0 yang dikelola pelanggan untuk propagasi identitas tepercaya
<a name="customermanagedapps-trusted-identity-propagation-set-up-your-own-app-OAuth2"></a>

Untuk menyiapkan aplikasi OAuth 2.0 yang dikelola pelanggan untuk propagasi identitas tepercaya, Anda harus terlebih dahulu menambahkannya ke Pusat Identitas IAM. Gunakan prosedur berikut untuk menambahkan aplikasi Anda ke Pusat Identitas IAM. 

**Topics**
+ [Langkah 1: Pilih jenis aplikasi](#customermanagedapps-trusted-identity-propagation-set-up-your-own-app-OAuth2-select-app-type)
+ [Langkah 2: Tentukan detail aplikasi](#customermanagedapps-trusted-identity-propagation-set-up-your-own-app-OAuth2-specify-app-details)
+ [Langkah 3: Tentukan pengaturan otentikasi](#customermanagedapps-trusted-identity-propagation-set-up-your-own-app-OAuth2-specify-authentication-settings)
+ [Langkah 4: Tentukan kredenSIAL aplikasi](#customermanagedapps-trusted-identity-propagation-set-up-your-own-app-OAuth2-specify-application-credentials)
+ [Langkah 5: Tinjau dan konfigurasikan](#customermanagedapps-trusted-identity-propagation-set-up-your-own-app-OAuth2-review-and-configure)

## Langkah 1: Pilih jenis aplikasi
<a name="customermanagedapps-trusted-identity-propagation-set-up-your-own-app-OAuth2-select-app-type"></a>

1. Buka konsol [ Pusat Identi ](https://console.aws.amazon.com/singlesignon) tas IAM.

1. Pilih **Aplikasi**.

1. Pilih ** tab ** Customer managed.

1. Pilih ** Tambah aplikasi**.

1. Pada ** halaman ** Pilih jenis aplikasi, di bawah preferensi ** Setup**, pilih ** Saya memiliki aplikasi yang ingin saya atur**.

1. Di bawah ** Jenis aplikasi**, pilih ** OAuth 2.0. **

1. Pilih ** Ber ** ikutnya untuk melanjutkan ke halaman berikutnya[Langkah 2: Tentukan detail aplikasi](#customermanagedapps-trusted-identity-propagation-set-up-your-own-app-OAuth2-specify-app-details). 

## Langkah 2: Tentukan detail aplikasi
<a name="customermanagedapps-trusted-identity-propagation-set-up-your-own-app-OAuth2-specify-app-details"></a>

1. Pada ** halaman ** Tentukan detail ** aplikasi, di bawah Nama dan deskripsi aplikasi**, masukkan Nama ** tampilan ** untuk aplikasi, seperti**MyApp**. Kemudian, masukkan ** Deskripsi**.

1. Di bawah Metode penugasan ** pengguna dan grup**, pilih salah satu opsi berikut:
   + **Memerlukan ** penugasan — Izinkan hanya pengguna dan grup Pusat Identitas IAM yang ditugaskan ke aplikasi ini untuk mengakses aplikasi. 

     **Visi ** bilitas ubin aplikasi — Hanya pengguna yang ditugaskan ke aplikasi secara langsung atau melalui penugasan grup yang dapat melihat ubin aplikasi di portal AWS akses, asalkan visibilitas ** Aplikasi di portal AWS akses ** disetel ke Terlihat.
   + **Tidak memerlukan penugasan ** — Izinkan semua pengguna dan grup IAM Identity Center resmi untuk mengakses aplikasi ini.

     Visibilitas ubin aplikasi — Ubin aplikasi terlihat oleh semua pengguna yang masuk ke portal AWS akses, kecuali visibilitas ** aplikasi di portal AWS akses ** disetel ke ** Tidak terlihat**. 

1. Di bawah portal **AWS akses**, masukkan URL tempat pengguna dapat mengakses aplikasi dan tentukan apakah ubin aplikasi akan terlihat atau tidak terlihat di portal AWS akses. Jika Anda memilih ** Tidak terlihat**, bahkan pengguna yang ditugaskan tidak dapat melihat ubin aplikasi.

1. Di bawah ** Tag (opsional)**, pilih ** Tambahkan tag baru**, lalu tentukan nilai untuk K ** unci ** dan ** Nilai (opsional)**. 

   Untuk informasi tentang tanda, lihat [Sumber daya penandaan AWS IAM Identity Center](tagging.md).

1. Pilih ** Berikutnya**, dan lanjutkan ke halaman berikutnya[Langkah 3: Tentukan pengaturan otentikasi](#customermanagedapps-trusted-identity-propagation-set-up-your-own-app-OAuth2-specify-authentication-settings).

## Langkah 3: Tentukan pengaturan otentikasi
<a name="customermanagedapps-trusted-identity-propagation-set-up-your-own-app-OAuth2-specify-authentication-settings"></a>

Untuk menambahkan aplikasi yang dikelola pelanggan yang mendukung OAuth 2.0 ke Pusat Identitas IAM, Anda harus menentukan penerbit token tepercaya. Penerbit token tepercaya adalah server otorisasi OAuth 2.0 yang membuat token yang ditandatangani. Token ini mengotorisasi aplikasi yang memulai permintaan (meminta aplikasi) untuk akses ke aplikasi yang AWS dikelola (menerima aplikasi). 

1. Pada ** halaman T ** entukan pengaturan otentikasi, di bawah ** Penerbit token tepercaya**, lakukan salah satu dari hal berikut:
   + Untuk menggunakan penerbit token tepercaya yang ada: 

     Pilih kotak centang di samping nama penerbit token tepercaya yang ingin Anda gunakan.
   + Untuk menambahkan penerbit token tepercaya baru:

     1. Pilih ** Buat penerbit token tepercaya**.

     1. Tab browser baru terbuka. Ikuti langkah 5 hingga 8 inci[Cara menambahkan penerbit token tepercaya ke konsol Pusat Identitas IAM](setuptrustedtokenissuer.md#how-to-add-trustedtokenissuer).

     1. Setelah Anda menyelesaikan langkah-langkah ini, kembali ke jendela browser yang Anda gunakan untuk pengaturan aplikasi Anda dan pilih penerbit token tepercaya yang baru saja Anda tambahkan.

     1. Dalam daftar penerbit token tepercaya, pilih kotak centang di sebelah nama penerbit token tepercaya yang baru saja Anda tambahkan.

        Setelah Anda memilih penerbit token tepercaya, ** bagian ** Konfigurasikan penerbit token tepercaya yang dipilih akan muncul. 

1. Di bawah ** Konfigurasikan penerbit token tepercaya yang dipilih**, masukkan klaim ** ** Aud. K ** laim Aud ** mengidentifikasi audiens (penerima) yang dituju untuk token yang dihasilkan oleh penerbit token tepercaya. Untuk informasi selengkapnya, lihat [Klaim Aud](trusted-token-issuer-configuration-settings.md#trusted-token-issuer-aud-claim).

1. Untuk mencegah pengguna Anda harus melakukan autentikasi ulang saat mereka menggunakan aplikasi ini, pilih ** Aktifkan pemberian token penyegaran. ** Ketika dipilih, opsi ini menyegarkan token akses untuk sesi setiap 60 menit, hingga sesi berakhir atau pengguna mengakhiri sesi.

1. Pilih ** Berikutnya**, dan lanjutkan ke halaman berikutnya[Langkah 4: Tentukan kredenSIAL aplikasi](#customermanagedapps-trusted-identity-propagation-set-up-your-own-app-OAuth2-specify-application-credentials).

## Langkah 4: Tentukan kredenSIAL aplikasi
<a name="customermanagedapps-trusted-identity-propagation-set-up-your-own-app-OAuth2-specify-application-credentials"></a>

Selesaikan langkah-langkah dalam prosedur ini untuk menentukan kredensional yang digunakan aplikasi Anda untuk melakukan tindakan pertukaran token dengan aplikasi tepercaya. KredenSIAL ini digunakan dalam kebijakan berbasis sumber daya. Kebijakan mengharuskan Anda menentukan prinsipal yang memiliki izin untuk melakukan tindakan yang ditentukan dalam kebijakan. **Anda harus menentukan prinsi ** pal, bahkan jika aplikasi tepercaya sama Akun AWS. 

**catatan**  
Saat Anda menetapkan izin dengan kebijakan, berikan hanya izin yang diperlukan untuk melakukan tugas. Anda melakukannya dengan mendefinisikan tindakan yang dapat diambil pada sumber daya tertentu dalam kondisi tertentu, yang juga dikenal sebagai izin dengan hak akses paling rendah.

Kebijakan ini memerlukan tindakan [`CreateTokenWithIAM`](https://docs.aws.amazon.com/singlesignon/latest/OIDCAPIReference/API_CreateTokenWithIAM.html) API. Untuk informasi selengkapnya tentang kebijakan ini, dan contoh yang dapat Anda sesuaikan sesuai kebutuhan untuk lingkungan Anda, lihat[Resource-based contoh kebijakan untuk Pusat Identitas IAM](iam-auth-access-using-resource-based-policies.md).

1. Pada ** halaman T ** entukan kredenSIAL aplikasi, lakukan salah satu hal berikut:
   + Untuk menentukan satu atau beberapa peran IAM dengan cepat:

     1. Pilih ** Masukkan satu atau beberapa peran ** IAM.

     1. Di bawah ** Masukkan peran IAM**, tentukan Nama Sumber Daya Amazon (ARN) dari peran IAM yang ada. Untuk menentukan ARN, gunakan sintaks berikut. Bagian Wilayah ARN kosong karena sumber daya IAM bersifat global. 

        ```
          arn:aws:iam::{{account}}:role/{{role-name-with-path}}
        ```

        Untuk informasi selengkapnya, lihat [ Cross-account akses menggunakan kebijakan berbasis sumber daya ](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies-cross-account-resource-access.html#access_policies-cross-account-using-resource-based-policies) dan ARN [ IAM ](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_identifiers.html#identifiers-arns) di Panduan Pengguna. *AWS Identity and Access Management *
   + Untuk mengedit kebijakan secara manual (diperlukan jika Anda menentukan non-AWS kredensional):

     1. Pilih ** Edit kebijakan aplikasi**.

     1. Ubah kebijakan Anda dengan mengetik atau menempelkan teks di kotak teks JSON. 

     1. Selesaikan peringatan keamanan, kesalahan, atau peringatan umum yang dihasilkan selama validasi kebijakan. Untuk informasi selengkapnya, lihat [ Memvalidasi kebijakan IAM ](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_policy-validator.html) di Panduan *AWS Identity and Access Management Pengguna. * 

1. Pilih ** Berikutnya ** dan lanjutkan ke halaman berikutnya[Langkah 5: Tinjau dan konfigurasikan](#customermanagedapps-trusted-identity-propagation-set-up-your-own-app-OAuth2-review-and-configure).

## Langkah 5: Tinjau dan konfigurasikan
<a name="customermanagedapps-trusted-identity-propagation-set-up-your-own-app-OAuth2-review-and-configure"></a>

1. Pada ** halaman T ** injau dan konfigurasi, tinjau pilihan yang Anda buat. Untuk membuat perubahan, pilih bagian konfigurasi yang Anda inginkan, pilih ** Edit**, lalu buat perubahan yang diperlukan. 

1. Setelah selesai, pilih ** Tambahkan aplikasi**.

1. Aplikasi yang Anda tambahkan muncul di ** daftar aplikasi yang dikelola ** pelanggan.

1. Setelah menyiapkan aplikasi yang dikelola pelanggan di Pusat Identitas IAM, Anda harus menentukan satu atau lebih Layanan AWS, atau aplikasi tepercaya, untuk propagasi identitas. Ini memungkinkan pengguna untuk masuk ke aplikasi yang dikelola pelanggan Anda dan mengakses data di aplikasi tepercaya. 

   Untuk informasi selengkapnya, lihat [Tentukan aplikasi tepercaya](trustedidentitypropagation-using-customermanagedapps-specify-trusted-apps.md).