View a markdown version of this page

Mengatur proses masuk perusahaan dengan Identitas Ping untuk Amazon Quick di desktop - Amazon Quick
Langkah 1: Buat aplikasi OIDC di Identitas PingLangkah 2: Tambahkan akses ekstensi di konsol administrasi Amazon QuickLangkah 3: Buat ekstensi di konsol Amazon QuickLangkah 4: Unduh, verifikasi, dan distribusikan aplikasi desktop

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

Mengatur proses masuk perusahaan dengan Identitas Ping untuk Amazon Quick di desktop

 Berlaku untuk: Enterprise Edition 
   Audiens yang dituju: Administr ator sistem 

Halaman ini memandu Anda melalui keempat langkah untuk mengatur login perusahaan dengan: Ping Identity

  1. Buat aplikasi OIDC di Ping Identity produk Anda (PingFederateatauPingOne) dan catat nilainya.

  2. Tambahkan akses ekstensi di konsol administrasi Amazon Quick.

  3. Buat ekstensi di konsol Amazon Quick.

  4. Unduh, verifikasi, dan distribusikan aplikasi desktop.

catatan

Sebelum Anda mulai, tinjau prasyarat diMenyiapkan Amazon Quick di desktop untuk penerapan perusahaan.

Langkah 1: Buat aplikasi OIDC di Identitas Ping

Daftarkan klien OIDC publik di Ping Identity produk Anda. Aplikasi desktop Amazon Quick menggunakan klien ini untuk mengotentikasi pengguna melalui aliran kode otorisasi dengan PKCE. Klien ini tidak memerlukan rahasia klien. Aktifkan jenis hibah Refresh Token dan berikan ruang offline_access lingkup. Pilih instruksi untuk Ping Identity produk Anda.

PingFederate

Untuk informasi selengkapnya, lihat Men yiapkan aplikasi OIDC di PingFederate dalam Ping Identity dokumentasi.

Untuk membuat PingFederate Klien OIDC

  1. Di konsol PingFederate administratif, buka Aplikasi → OAuth → Klien, dan pilih Tam bah Klien.

  2. Di bidang ID Klien, masukkan pengidentifikasi unik untuk klien ini.

  3. Di bidang Nama, masukkan Amazon Quick Desktop.

  4. Untuk O tentikasi Kli en, pilih Tidak Ada.

  5. Di bagian URI Pengalihan, masukkan http://localhost:18080 dan pilih Tam bah.

  6. Dalam daftar Jenis Hibah yang Diizinkan, pilih Kode Otorisasi dan Segarkan Token.

  7. Pilih kotak centang Memerlukan Kunci Bukti untuk Pertukaran Kode (PKCE).

  8. Di bawah Cak upan Umum, berikan yang berikut: openidemail,,profile,offline_access.

  9. Pilih Simpan.

  10. Perhatikan ID Klien. Anda membutuhkan nilai ini di langkah selanjutnya.

Untuk mengkonfigurasi kebijakan OIDC

  1. Di konsol PingFederate administratif, buka Aplikasi → OAuth → OpenID Connect Policy Management.

  2. Pilih kebijakan OIDC yang terkait dengan klien ini, atau pilih Tam bah Kebijakan untuk membuatnya.

  3. Pilih kotak centang Ret urn ID Token On Refresh Grant. Ini memastikan bahwa aplikasi desktop menerima token ID baru dengan klaim saat ini saat menyegarkan sesi.

  4. Di bawah Kontrak Atribut, verifikasi bahwa email klaim disertakan dan dipetakan ke atribut pengguna yang sesuai di sumber otentikasi Anda. K email laim harus ada dalam token yang dikeluarkan selama otentikasi awal dan pemberian token penyegaran.

  5. Pilih Simpan.

Catat titik akhir OIDC berikut. Anda memasukkan nilai-nilai ini, bersama dengan ID Klien yang Anda catat sebelumnya, di Langkah 2. Ganti <PINGFEDERATE_HOST> dengan nama PingFederate host server Anda.

Bidang Nilai
ID klien ID Klien yang Anda masukkan saat membuat klien
URL Penerbit https://<PINGFEDERATE_HOST>
Titik akhir otorisasi https://<PINGFEDERATE_HOST>/as/authorization.oauth2
Titik akhir token https://<PINGFEDERATE_HOST>/as/token.oauth2
JWKS TYPE https://<PINGFEDERATE_HOST>/pf/JWKS

PingOne

Untuk informasi selengkapnya, lihat Meng edit aplikasi — Asl i dalam Ping Identity dokumentasi.

Untuk membuat PingOne Aplikasi asli OIDC

  1. Di konsol PingOne admin, buka Aplikasi → Aplikasi dan pilih ikon +.

  2. Masukkan Amazon Quick Desktop sebagai nama aplikasi.

  3. Di bagian Jenis Aplikasi, pilih Asli, lalu pilih S impan.

  4. Pada tab Konfigurasi, pilih Edit dan konfigurasikan pengaturan berikut:

    Pengaturan Nilai
    Jenis Respon Kode
    Jenis Hibah Kode Otorisasi dan Refresh Token
    Penegakan PKCE S256
    URI Pengalihan http://localhost:18080
    Metode Otentikasi Titik Akhir Token Tidak ada

  5. Pilih Simpan.

  6. Pada tab Resources, tambahkan cakupan berikut:openid,email,profile,offline_access.

    Tambahkan cakupan pada tab Resources, bukan tab Configuration

    Ini adalah langkah terpisah dari tab Konfigurasi. PingOnehanya memberikan openid ruang lingkup secara default, jadi Anda harus secara eksplisit menambahkan emailprofile,, dan offline_access pada tab Sumber daya. Jika Anda melewatkan langkah ini, login gagal dengan “Permintaan info pengguna gagal (HTTP 401)”. Kesalahan ini terjadi karena masuk memerlukan token yang dikeluarkan dengan cakupan ini, dan PingOne tidak memberikannya kecuali Anda menambahkannya di tab ini.

  7. Pada tab Pemetaan Atribut, verifikasi bahwa email atribut dipetakan ke alamat email pengguna.

  8. Alihkan aplikasi ke Aktifkan.

  9. Perhatikan ID Klien dan ID Lingkungan dari tab Konfigurasi.

catatan

PingOneDomain bervariasi menurut wilayah. Contoh-contoh berikut digunakan.com. Ganti domain dengan domain untuk lingkungan Anda (misalnya,.ca,.eu, atau.asia).

Catat titik akhir OIDC berikut. Anda memasukkan nilai-nilai ini, bersama dengan ID Klien yang Anda catat sebelumnya, di Langkah 2. Ganti <ENV_ID> dengan ID PingOne lingkungan Anda.

Bidang Nilai
ID klien ID Klien dari tab Konfigurasi
URL Penerbit https://auth.pingone.com/<ENV_ID>/as
Titik akhir otorisasi https://auth.pingone.com/<ENV_ID>/as/authorize
Titik akhir token https://auth.pingone.com/<ENV_ID>/as/token
JWKS TYPE https://auth.pingone.com/<ENV_ID>/as/jwks
Gunakan jalur URI JWKS yang benar untuk PingOne

Untuk URI JSON Web Key Set (JWKS), gunakan /as/jwks jalur yang ditunjukkan pada tabel sebelumnya. Jangan gunakan/.well-known/jwks.json, yang dapat muncul sebagai placeholder dalam beberapa PingOne bentuk. PingOnetidak menggunakan jalur ini, dan validasi token masuk gagal jika Anda memasukkannya.

Langkah 2: Tambahkan akses ekstensi di konsol administrasi Amazon Quick

Di konsol administrasi Amazon Quick, tambahkan akses ekstensi menggunakan nilai titik akhir OIDC dan ID Klien yang Anda rekam di Langkah 1.

Untuk menambahkan akses ekstensi

  1. Masuk ke konsol administrasi Amazon Quick dan pilih Kel ola akun.

  2. Di panel navigasi kiri, di bawah Izin, pilih Ak ses ekstensi.

  3. Pilih Tambahkan akses ekstensi.

  4. Di bawah Pilih Layanan, pilih Amazon Quick (Aplikasi Desktop untuk Cepat), lalu pilih Ber ikutnya.

  5. Masukkan detail ekstensi menggunakan nilai yang Anda rekam di Langkah 1:

    Bidang Nilai
    Nama Nama untuk akses ekstensi ini (misalnya,QuickDesktop-access). Ini hanya referensi internal dan tidak dikonfigurasi di IdP Anda. Gunakan karakter alfanumerik dan tanda hubung saja, tanpa spasi.
    Deskripsi (Opsional) Deskripsi akses ekstensi ini, hanya untuk referensi Anda.
    URL Penerbit URL penerbit OIDC yang tepat dari Langkah 1, termasuk akhiran jalur yang diperlukan.
    Titik Akhir Otorisasi URL titik akhir otorisasi OIDC dari Langkah 1
    Titik Akhir Token URL titik akhir token OIDC dari Langkah 1
    JWKS TYPE URI Set Kunci Web JSON dari Langkah 1
    ID klien Pengidentifikasi klien OIDC (ID Klien atau ID Aplikasi (klien)) yang Anda rekam pada Langkah 1. Wajib.

  6. Pilih Tambahkan.

    penting

    Pastikan semua nilai sudah benar sebelum Anda memilih Tam bah. Konfigurasi akses ekstensi tidak dapat diedit setelah pembuatan. Jika ada nilai yang salah, Anda harus menghapus akses ekstensi dan membuat yang baru.

Langkah 3: Buat ekstensi di konsol Amazon Quick

Setelah Anda menambahkan akses ekstensi di konsol administrasi Amazon Quick, buat ekstensi di halaman Ekstensi di konsol Amazon Quick.

Untuk membuat ekstensi

  1. Di konsol Amazon Quick, di panel navigasi kiri, pilih Eksten si. Jika Anda tidak melihat Eksten si, pilih Lain nya untuk menemukannya.

  2. Pilih Tambahkan ekstensi.

  3. Pilih aplikasi Desktop untuk akses ekstensi cepat yang Anda buat di Langkah 2, lalu pilih Ber ikutnya.

  4. Pilih Buat.

penting

Langkah 2 dan Langkah 3 diperlukan. Jika Anda menambahkan akses ekstensi tetapi tidak membuat ekstensi, login perusahaan tidak tersedia dan pengguna melihat kesalahan: “Masuk perusahaan untuk Desktop Cepat belum dikonfigurasi untuk akun ini.”

catatan

Membuat ekstensi adalah tindakan tingkat akun satu kali. Setelah administrator membuat ekstensi, login perusahaan tersedia untuk semua pengguna di akun. Pengguna individu tidak perlu mengaktifkan ekstensi itu sendiri - mereka hanya perlu mengunduh aplikasi desktop dan masuk.

Langkah 4: Unduh, verifikasi, dan distribusikan aplikasi desktop

Pada langkah ini, Anda mengunduh dan menginstal aplikasi desktop, memverifikasi bahwa proses masuk perusahaan berfungsi, dan kemudian mendistribusikan aplikasi ke pengguna Anda.

Pertama, unduh aplikasi dari konsol Amazon Quick.

Untuk mengunduh aplikasi desktop

  1. Di konsol Amazon Quick, di panel navigasi kiri, pilih Eksten si. Jika Anda tidak melihat Eksten si, pilih Lain nya untuk menemukannya.

  2. Pilih ekstensi Quick Desktop yang Anda buat di Langkah 3.

  3. Pilih ikon opsi lainnya (... ) untuk ekstensi.

  4. Pilih Unduh untuk Windows atau Unduh untuk Mac, tergantung pada sistem operasi Anda.

Kemudian, instal aplikasi. Untuk instruksi instalasi, lihat Memulai.

Setelah Anda menginstal aplikasi, verifikasi bahwa proses masuk perusahaan berfungsi.

Untuk memverifikasi proses masuk perusahaan

  1. Buka aplikasi desktop Amazon Quick.

  2. Pada layar masuk, pilih L anjutkan dengan SS O.

  3. (Opsional) Pilih Wilayah AWS dari daftar, atau pilih Dinamis agar aplikasi mendeteksi Wilayah Anda secara otomatis.

  4. Otentikasi dengan kredensi perusahaan Anda. Aplikasi mengalihkan ke penyedia identitas Anda, dan kemudian kembali ke layar Beranda setelah otentikasi berhasil.

Tip

Jika login gagal, verifikasi nilai yang Anda masukkan di Langkah 2 terhadap titik akhir OIDC dan ID Klien dari Langkah 1. Jika ada nilai yang salah, hapus akses ekstensi di bawah Izin → Akses ekstensi di konsol administrasi Amazon Quick, dan ulangi Langkah 2 dengan nilai yang benar. Untuk bantuan lebih lanjut, lihatMemecahkan masalah masuk perusahaan untuk Amazon Quick di desktop.

Terakhir, setelah Anda memverifikasi pengaturan, distribusikan aplikasi ke pengguna Anda. Arahkan mereka ke Memulai untuk petunjuk pengunduhan, pemasangan, dan masuk. Pengguna memilih Lanjutkan dengan SSO dan masuk dengan kredentif perusahaan mereka — tidak diperlukan konfigurasi per pengguna tambahan.