Tutorial: Amazon Quick Suite dan federasi identitas IAM

Masuk ke dasbor Okta Anda. Jika Anda tidak memilikinya, buat akun Okta Developer Edition gratis dengan menggunakan URL bermerek Amazon Quick Suite ini. Setelah Anda mengaktifkan email Anda, masuk ke Okta.

Di situs web Okta, pilih <> Konsol Pengembang di kiri atas, lalu pilih UI Klasik.

Pilih Add Applications, dan pilih Add app.

Masuk aws untuk Pencarian, dan pilih Federasi AWS Akun dari hasil pencarian.

Pilih Tambah untuk membuat instance dari aplikasi ini.

Untuk label Aplikasi, masukkanAWS Account Federation - Amazon Quick Suite.

Pilih Berikutnya.

Untuk SAMP 2.0, Status Relay Default, masukkanhttps://quicksight.aws.amazon.com.

Buka menu konteks (klik kanan) untuk metadata Penyedia Identitas, dan pilih untuk menyimpan file. Beri nama filemetadata.xml. Anda memerlukan file ini di prosedur selanjutnya.

Isi file terlihat mirip dengan yang berikut ini.

<md:EntityDescriptor xmlns:md="urn:oasis:names:tc:SAML:2.0:metadata" entityID="http://www.okta.com/exkffz2hATwiVft645d5">
    <md:IDPSSODescriptor WantAuthnRequestsSigned="false" protocolSupportEnumeration="urn:oasis:names:tc:SAML:2.0:protocol">
    <md:KeyDescriptor use="signing">
        <ds:KeyInfo xmlns:ds="http://www.w3.org/2000/09/xmldsig#">
        <ds:X509Data>
            <ds:X509Certificate>
            MIIDpjCCAo6gAwIBAgIGAXVjA82hMA0GCSqGSIb3DQEBCwUAMIGTMQswCQYDVQQGEwJVUzETMBEG 
            . 
            .        (certificate content omitted)
            . 
            QE/6cRdPQ6v/eaFpUL6Asd6q3sBeq+giRG4=
            </ds:X509Certificate>
        </ds:X509Data>
        </ds:KeyInfo>
    </md:KeyDescriptor>
    <md:NameIDFormat>urn:oasis:names:tc:SAML:1.1:nameid-format:emailAddress</md:NameIDFormat>
    <md:NameIDFormat>urn:oasis:names:tc:SAML:2.0:nameid-format:unspecified</md:NameIDFormat>
    <md:SingleSignOnService Binding="urn:oasis:names:tc:SAML:2.0:bindings:HTTP-POST" Location="https://dev-1054988.okta.com/app/amazon_aws/exkffz2hATwiVft645d5/sso/saml"/>
    <md:SingleSignOnService Binding="urn:oasis:names:tc:SAML:2.0:bindings:HTTP-Redirect" Location="https://dev-1054988.okta.com/app/amazon_aws/exkffz2hATwiVft645d5/sso/saml"/>
    </md:IDPSSODescriptor>
    </md:EntityDescriptor>

Setelah Anda menyimpan file XHTML, gulir ke bagian bawah halaman Okta, dan pilih Selesai.

Biarkan jendela browser ini tetap terbuka, jika memungkinkan. Anda membutuhkannya nanti di tutorial.

Masuk ke Konsol Manajemen AWS dan buka konsol IAM di https://console.aws.amazon.com/iam/.

Di panel navigasi, pilih Penyedia identitas, Buat Penyedia.

Masukkan setelan berikut:

Pilih Langkah Berikutnya, Buat.

Temukan iDP yang Anda buat dan pilih untuk melihat pengaturan. Perhatikan Penyedia ARN. Anda membutuhkan ini untuk menyelesaikan tutorial.

Verifikasi bahwa penyedia identitas dibuat dengan pengaturan Anda. Di IAM, pilih Penyedia identitas, Okta (IDP yang Anda tambahkan), Unduh metadata. File harus menjadi file yang baru saja Anda unggah.

Masuk ke Konsol Manajemen AWS dan buka konsol IAM di https://console.aws.amazon.com/iam/.

Dalam panel navigasi, pilih Roles (Peran), Create role (Buat Peran).

Untuk Pilih jenis entitas tepercaya, pilih kartu berlabel federasi SAMP 2.0.

Untuk penyedia SAMP, pilih IDP yang Anda buat di prosedur sebelumnya, misalnya. Okta

Aktifkan opsi Izinkan akses Konsol Terprogram dan AWS Manajemen.

Pilih Berikutnya: Izin.

Tempelkan kebijakan berikut ke editor.

Di editor kebijakan, perbarui JSON dengan Nama Sumber Daya Amazon (ARN) penyedia Anda.

{
    "Version": "2012-10-17"		 	 	 ,
    "Statement": [
    {
        "Effect": "Allow",
        "Action": "sts:AssumeRoleWithSAML",
        "Resource": "arn:aws:iam::111111111111:saml-provider/Okta",
        "Condition": {
        "StringEquals": {
            "saml:aud": "https://signin.aws.amazon.com/saml"
        }
        }
    }
    ]
    }

Pilih Tinjau kebijakan.

Untuk Nama, masukkan QuicksightOktaFederatedPolicy, lalu pilih Buat kebijakan.

Pilih Buat kebijakan, JSON untuk kedua kalinya.

Tempelkan kebijakan berikut ke editor.

Di editor kebijakan, perbarui JSON dengan Akun AWS ID Anda. Ini harus ID akun yang sama dengan yang Anda gunakan dalam kebijakan sebelumnya di penyedia ARN.

{
    "Version": "2012-10-17"		 	 	 ,
    "Statement": [
        {
            "Action": [
                "quicksight:CreateReader"
            ],
            "Effect": "Allow",
            "Resource": [
                "arn:aws:quicksight::111111111111:user/${aws:userid}"
            ]
        }
    ]
    }

Anda dapat menghilangkan Wilayah AWS nama di ARN, seperti yang ditunjukkan berikut.

arn:aws:quicksight::111111111111:user/$${aws:userid}

Pilih Tinjau kebijakan.

Untuk Nama, masukkan QuicksightCreateReader, lalu pilih Buat kebijakan.

Segarkan daftar kebijakan dengan memilih ikon penyegaran di sebelah kanan.

Untuk Pencarian, masukkanQuicksightOktaFederatedPolicy. Pilih kebijakan untuk mengaktifkannya ( ).

Jika Anda tidak ingin menggunakan penyediaan otomatis, Anda dapat melewati langkah berikut.

Untuk menambahkan pengguna Amazon Quick Suite, gunakan register-user. Untuk menambahkan grup Amazon Quick Suite, gunakan create-group. Untuk menambahkan pengguna ke grup Amazon Quick Suite, gunakan create-group-membership.

(Opsional) Untuk Pencarian, masukkanQuicksightCreateReader. Pilih kebijakan untuk mengaktifkannya ( ).

Lakukan langkah ini jika Anda ingin menyediakan pengguna Amazon Quick Suite secara otomatis, daripada menggunakan Amazon Quick Suite API.

QuicksightCreateReaderKebijakan mengaktifkan penyediaan otomatis dengan mengizinkan penggunaan tindakan. quicksight:CreateReader Melakukan hal ini memberikan pelanggan dasbor (tingkat pembaca) akses ke pengguna pertama kali. Administrator Amazon Quick Suite nantinya dapat memutakhirkannya dari menu profil Amazon Quick Suite, Kelola Amazon Quick Suite, Kelola pengguna.

Untuk terus melampirkan kebijakan atau kebijakan IAM, pilih Berikutnya: Tag.

Pilih Berikutnya: Tinjauan.

Untuk nama Peran, masukkanQuicksightOktaFederatedRole, dan pilih Buat peran.

Verifikasi bahwa Anda berhasil menyelesaikan ini dengan mengambil langkah-langkah berikut:

1. Kembali ke halaman utama konsol IAM di https://console.aws.amazon.com/iam/. Anda dapat menggunakan tombol Kembali browser Anda.

2. Pilih Peran.

3. Untuk Pencarian, masukkan Okta. Pilih QuicksightOktaFederatedRoledari hasil pencarian.

4. Pada halaman Ringkasan kebijakan, periksa tab Izin. Verifikasi bahwa peran tersebut memiliki kebijakan atau kebijakan yang Anda lampirkan padanya. Seharusnya adaQuicksightOktaFederatedPolicy. Jika Anda memilih untuk menambahkan kemampuan untuk membuat pengguna, itu juga harus memilikiQuicksightCreateReader.

5. Gunakan ikon untuk membuka setiap kebijakan. Verifikasi bahwa teks cocok dengan apa yang ditampilkan dalam prosedur ini. Periksa kembali apakah Anda menambahkan nomor Anda sendiri sebagai pengganti contoh Akun AWS nomor akun 111111111111.

6. Pada tab Hubungan kepercayaan, verifikasi bahwa bidang Entitas tepercaya berisi ARN untuk penyedia identitas. Anda dapat memeriksa ulang ARN di konsol IAM dengan membuka penyedia Identity, Okta.

Masuk ke Konsol Manajemen AWS dan buka konsol IAM di https://console.aws.amazon.com/iam/.

Tambahkan kebijakan yang memungkinkan Okta menampilkan daftar peran IAM ke pengguna. Untuk melakukan ini, pilih Kebijakan, Buat kebijakan.

Pilih JSON, lalu masukkan kebijakan berikut.

{
    "Version": "2012-10-17"		 	 	 ,
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "iam:ListRoles",
                "iam:ListAccountAliases"
            ],
            "Resource": "*"
        }
    ]
    }

Pilih Tinjau Kebijakan.

Untuk Nama, masukkan OktaListRolesPolicy. Kemudian pilih Buat kebijakan.

Tambahkan pengguna sehingga Anda dapat memberikan Okta dengan kunci akses.

Di panel navigasi, pilih Pengguna, Tambahkan Pengguna.

Gunakan pengaturan berikut:

Pilih Berikutnya: Izin.

Pilih Lampirkan kebijakan yang sudah ada secara langsung.

Untuk PenelusuranOktaListRolesPolicy, masukkan, dan pilih OktaListRolesPolicydari hasil pencarian.

Pilih Selanjutnya: Tags, lalu pilih Selanjutnya: Tinjau.

Pilih Create user (Buat pengguna). Sekarang Anda bisa mendapatkan kunci akses.

Unduh file kunci dengan memilih Unduh.csv. File tersebut berisi ID kunci akses yang sama dan kunci akses rahasia yang ditampilkan di layar ini. Namun, karena AWS tidak menampilkan informasi ini untuk kedua kalinya, pastikan untuk mengunduh file.

Verifikasi bahwa Anda menyelesaikan langkah ini dengan benar dengan melakukan hal berikut:

1. Buka konsol IAM, dan pilih Pengguna. Cari Okta SSOUser, dan buka dengan memilih nama pengguna dari hasil pencarian.

2. Pada tab Izin, verifikasi bahwa OktaListRolesPolicyterlampir.

3. Gunakan ikon untuk membuka kebijakan. Verifikasi bahwa teks cocok dengan apa yang ditampilkan dalam prosedur ini.

4. Pada tab Security credentials, Anda dapat memeriksa kunci akses, meskipun Anda sudah mengunduhnya. Anda dapat kembali ke tab ini untuk membuat kunci akses saat Anda membutuhkan yang baru.

Kembali ke dasbor Okta Anda. Jika diminta untuk melakukannya, masuk. Jika konsol pengembang tidak lagi terbuka, pilih Admin untuk membukanya kembali.

Jika Anda harus membuka kembali Okta, Anda dapat kembali ke bagian ini dengan mengikuti langkah-langkah berikut:

1. Masuk ke Okta. Pilih Aplikasi.

2. Pilih Federasi AWS Akun - Amazon Quick Suite —aplikasi yang Anda buat di awal tutorial ini.

3. Pilih tab Masuk, antara Umum dan Seluler.

Gulir ke Pengaturan Masuk Tingkat Lanjut.

Untuk Penyedia Identitas ARN (Diperlukan hanya untuk federasi IAM SAMP), masukkan penyedia ARN dari prosedur sebelumnya, misalnya:

arn:aws:iam::111122223333:saml-provider/Okta

Pilih Selesai atau Simpan. Nama tombol bervariasi tergantung apakah Anda membuat atau mengedit aplikasi.

Pilih tab Penyediaan, dan di bagian bawah tab, pilih Konfigurasi Integrasi API.

Aktifkan Aktifkan integrasi API untuk menampilkan pengaturan.

Untuk Kunci Akses dan Kunci Rahasia, berikan kunci akses dan kunci rahasia yang Anda unduh sebelumnya ke file bernama OktaSSOUser_credentials.csv.

Pilih Test API Credentials. Lihat di atas pengaturan Aktifkan integrasi API untuk pesan yang mengonfirmasi bahwa Federasi AWS Akun berhasil diverifikasi.

Pilih Simpan.

Pastikan To App disorot di sebelah kiri, dan pilih Edit di kanan.

Untuk Buat Pengguna, aktifkan opsi Aktifkan.

Pilih Simpan.

Pada tab Penugasan, dekat Penyediaan dan Impor, pilih Tetapkan.

Lakukan satu atau beberapa hal berikut untuk mengaktifkan akses federasi:

Untuk setiap pengguna atau grup IAM, lakukan hal berikut:

1. Pilih Tetapkan, Peran.

2. Pilih QuicksightOktaFederatedRoledari daftar peran IAM.

3. Untuk Peran Pengguna SAMP, aktifkan QuicksightOktaFederatedRole.

Pilih Simpan dan Kembali, lalu pilih Selesai.

Pastikan Anda menyelesaikan langkah ini dengan benar dengan memilih filter Orang atau Grup di sebelah kiri, dan memeriksa pengguna atau grup yang Anda masukkan. Jika Anda tidak dapat menyelesaikan proses ini karena peran yang Anda buat tidak muncul dalam daftar, kembali ke prosedur sebelumnya untuk memverifikasi pengaturan.

Jika Anda menggunakan akun administrator Okta, beralihlah ke mode pengguna.

Masuk ke dasbor Aplikasi Okta Anda dengan pengguna yang telah diberikan akses federasi. Anda akan melihat aplikasi baru dengan label Anda, misalnya Federasi AWS Akun - Amazon Quick Suite.

Pilih ikon aplikasi untuk meluncurkan Federasi AWS Akun - Amazon Quick Suite.

Buka Amazon Quick Suite, dan pilih Kelola Amazon Quick Suite dari menu profil Anda.

Pilih Single sign-on (IAM federation) dari panel navigasi.

Untuk Konfigurasi, URL iDP, masukkan URL yang disediakan IDP Anda untuk mengautentikasi pengguna, misalnya https://dev - .okta. 1-----0 com/home/amazon_aws/0oabababababaGQei5d5/282. Anda dapat menemukannya di halaman aplikasi Okta Anda, di tab Umum, di Tautan Sematkan.

Untuk URL iDP, masukkan. RelayState

Lakukan salah satu tindakan berikut:

Untuk Status, pilih ON.

Pilih Simpan untuk menjaga pengaturan Anda.

Temukan URL single sign-on (IAM federation) aplikasi Okta di metadata.xml file yang Anda unduh di awal tutorial. Anda dapat menemukan URL di dekat bagian bawah file, dalam elemen bernamamd:SingleSignOnService. Atribut diberi nama Location dan nilai berakhir dengan/sso/saml, seperti yang ditunjukkan pada contoh berikut.

<md:SingleSignOnService Binding="urn:oasis:names:tc:SAML:2.0:bindings:HTTP-Redirect" Location="https://dev-0000001.okta.com/app/amazon_aws/abcdef2hATwiVft645d5/sso/saml"/>

Ambil nilai URL federasi IAM dan tambahkan ?RelayState= diikuti dengan URL dasbor Amazon Quick Suite Anda. RelayStateParameter menyampaikan status (URL) tempat pengguna berada saat mereka dialihkan ke URL otentikasi.

Ke federasi IAM baru dengan status relai ditambahkan, tambahkan URL dasbor Amazon Quick Suite Anda. URL yang dihasilkan harus menyerupai berikut ini.

https://dev-1-----0.okta.com/app/amazon_aws/abcdef2hATwiVft645d5/sso/saml?RelayState=https://us-west-2.quicksight.aws.amazon.com/sn/analyses/12a12a2a-121a-212a-121a-abcd12abc1ab

Jika tautan yang Anda buat tidak terbuka, periksa apakah Anda menggunakan URL federasi IAM terbaru darimetadata.xml. Periksa juga apakah nama pengguna yang Anda gunakan untuk masuk tidak ditetapkan di lebih dari satu aplikasi Okta federasi IAM.