Cloud Composer 1 dalam mode pasca-pemeliharaan. Google tidak merilis update lebih lanjut untuk Cloud Composer 1, termasuk versi baru Airflow, perbaikan bug, dan update keamanan. Sebaiknya rencanakan migrasi ke Cloud Composer 2.

Halaman ini diterjemahkan oleh Cloud Translation API.

Mengakses lingkungan dengan Workforce Identity Federation

Cloud Composer 1 | Cloud Composer 2 | Cloud Composer 3

Halaman ini menjelaskan cara mengonfigurasi akses pengguna ke lingkungan Cloud Composer dengan Workforce Identity Federation.

Tentang Workforce Identity Federation di Cloud Composer

Workforce Identity Federation memungkinkan Anda menggunakan penyedia identitas (IdP) eksternal untuk mengautentikasi dan memberi otorisasi kepada tenaga kerja—sekelompok pengguna, seperti karyawan, partner, dan kontraktor—menggunakan IAM, sehingga pengguna dapat mengakses layanan Google Cloud. Untuk informasi selengkapnya tentang Workforce Identity Federation, lihat Workforce Identity Federation.

Jika Workforce Identity Federation dikonfigurasi dalam project, Anda dapat mengakses lingkungan dengan cara berikut:

Halaman Cloud Composer di konsol Google Cloud
UI Airflow
Google Cloud CLI, termasuk menjalankan perintah Airflow CLI
Cloud Composer API
Airflow REST API

Sebelum memulai

Semua lingkungan Cloud Composer baru yang dibuat mulai dari versi 2.1.11 dan Airflow versi 2.4.3 mendukung Workforce Identity Federation. Anda tidak perlu mengonfigurasi lingkungan dengan cara tertentu untuk mendukung Workforce Identity Federation.

Penting: Dukungan Workforce Identity Federation di Cloud Composer tidak otomatis memberikan jalur akses baru untuk identitas eksternal ke lingkungan Anda. Selama Anda tidak mengonfigurasi akses melalui penyedia identitas eksternal dan memberikan izin akses ke identitas eksternal, identitas eksternal tidak dapat mengakses lingkungan Anda.
Lingkungan yang dibuat sebelum versi 2.1.11 dan Airflow versi 2.4.3 serta diupgrade ke versi yang lebih baru tidak mendukung Workforce Identity Federation. Anda dapat memeriksa apakah lingkungan Anda mendukung Workforce Identity Federation.
Batasan Cloud Storage untuk Workforce Identity Federation berlaku untuk bucket lingkungan. Secara khusus, Anda harus mengaktifkan akses level bucket yang seragam di bucket lingkungan untuk mengizinkan identitas eksternal mengupload DAG dan file mereka ke bucket ini.
Email yang dikirim dari Airflow hanya menyertakan URL UI Airflow untuk akun Google. Karena identitas eksternal hanya dapat mengakses UI Airflow melalui URL UI Airflow untuk identitas eksternal, link harus disesuaikan (diubah menjadi URL untuk identitas eksternal).

Menyiapkan akses ke lingkungan Anda dengan Workforce Identity Federation

Bagian ini menjelaskan langkah-langkah untuk mengonfigurasi akses bagi identitas eksternal ke lingkungan Cloud Composer Anda.

Konfigurasikan penyedia identitas Anda

Konfigurasikan Workforce Identity Federation untuk penyedia identitas Anda dengan mengikuti panduan Mengonfigurasi Workforce Identity Federation.

Memberikan peran IAM ke identitas eksternal

Di Identity and Access Management, berikan peran IAM ke kumpulan identitas eksternal, sehingga identitas tersebut dapat mengakses dan berinteraksi dengan lingkungan Anda:

Untuk daftar peran khusus Cloud Composer, lihat Memberikan peran kepada pengguna. Misalnya, peran Environment User and Storage Object Viewer (composer.environmentAndStorageObjectViewer) memungkinkan pengguna untuk melihat lingkungan, mengakses UI Airflow, melihat dan memicu DAG dari UI DAG, dan melihat objek di bucket lingkungan.
Untuk mengetahui petunjuk tentang cara menetapkan peran ini kepada pengguna eksternal, lihat Memberikan peran IAM kepada akun utama.
Untuk format representasi identitas eksternal dalam kebijakan IAM, lihat Merepresentasikan pengguna kumpulan tenaga kerja dalam kebijakan IAM.

Memeriksa apakah pengguna baru menerima peran Airflow yang benar di Kontrol Akses UI Airflow

Cloud Composer menangani pengguna Airflow untuk identitas eksternal dengan cara yang sama seperti untuk pengguna akun Google. Sebagai ganti alamat email, ID utama akan digunakan. Saat identitas eksternal mengakses UI Airflow untuk pertama kalinya, pengguna Airflow akan otomatis terdaftar di sistem kontrol akses berbasis peran Airflow dengan peran default.

Pastikan pengguna baru menerima peran Airflow yang benar di Kontrol Akses UI Airflow. Anda memiliki dua opsi:

Izinkan identitas eksternal menerima peran default setelah mereka mengakses UI Airflow untuk pertama kalinya. Jika diperlukan, pengguna admin Airflow dapat mengubah peran ini menjadi peran lain.
Pradaftarkan identitas eksternal dengan kumpulan peran yang diperlukan dengan menambahkan kumpulan pengguna Airflow dengan kolom nama pengguna dan email yang ditetapkan ke ID utama mereka. Dengan cara ini, identitas eksternal akan mendapatkan peran yang Anda tetapkan, bukan peran default.

Penting: Kontrol Akses UI Airflow hanya mendukung format ID untuk satu identitas. Grup dan identitas dengan atribut tertentu tidak didukung.

Memeriksa apakah lingkungan mendukung Workforce Identity Federation

Untuk memeriksa apakah lingkungan Anda mendukung Workforce Identity Federation, jalankan perintah Google Cloud CLI berikut. Jika output menampilkan URI, berarti lingkungan Anda mendukung Workforce Identity Federation.

gcloud composer environments describe ENVIRONMENT_NAME \
  --location LOCATION \
  --format="value(config.airflowByoidUri)"

Ganti:

ENVIRONMENT_NAME dengan nama lingkungan.
LOCATION dengan region tempat lingkungan tersebut berada.

Contoh:

gcloud composer environments describe example-environment \
  --location us-central1 \
  --format="value(config.airflowByoidUri)"

Mengakses halaman Cloud Composer di konsol Google Cloud

Konsol Workforce Identity Federation Google Cloud memberikan akses ke halaman Cloud Composer.

Dari halaman Composer di konsol Google Cloud Workforce Identity Federation, Anda dapat mengakses UI untuk mengelola lingkungan, log Cloud Composer, pemantauan, dan UI DAG.

Semua link ke UI Airflow di konsol gabungan mengarah ke titik akses UI Airflow untuk identitas eksternal.

Lingkungan dalam versi sebelum 2.1.11 dan atau versi Airflow sebelum 2.4.3 mungkin memiliki link UI Airflow yang ditandai sebagai "Tidak tersedia". Hal ini menunjukkan bahwa lingkungan ini tidak mendukung pengguna Workforce Identity Federation di UI Airflow. UI Airflow untuk lingkungan ini hanya dapat diakses dengan Akun Google.

Mengakses UI Airflow

Lingkungan Cloud Composer memiliki dua URL untuk UI Airflow: satu untuk akun Google dan satu lagi untuk identitas eksternal. Identitas eksternal harus mengakses UI Airflow melalui URL untuk identitas eksternal.

URL untuk identitas eksternal adalah https://<UNIQUE_ID>.composer.byoid.googleusercontent.com.
URL untuk Akun Google adalah https://<UNIQUE_ID>.composer.googleusercontent.com.

Catatan: Akun layanan (Anda dapat mengenalinya dengan ID yang diakhiri dengan .) dianggap sebagai Akun Google. Gunakan alamat .composer.googleusercontent.com jika Anda ingin menggunakan Airflow menggunakan akun layanan Google. Lihat Mengakses Airflow API menggunakan akun layanan.

Hanya pengguna yang diautentikasi dengan identitas eksternal yang dapat mengakses URL untuk identitas eksternal. Jika pengguna mengunjungi URL untuk identitas eksternal saat tidak login, mereka akan dialihkan terlebih dahulu ke portal autentikasi tempat mereka menentukan nama penyedia kumpulan tenaga kerja, lalu mereka dialihkan ke penyedia identitas untuk login, dan akhirnya mereka dialihkan ke UI Airflow lingkungan.

Mengakses UI DAG di konsol Google Cloud

UI DAG tersedia untuk pengguna identitas eksternal sebagai bagian dari konsol gabungan. Anda dapat mengontrol akses dengan kebijakan IAM.

Akses berbasis peran Airflow di lingkungan dengan dukungan Workforce Identity Federation penuh juga diperhitungkan dan dapat digunakan untuk membatasi DAG yang terlihat oleh setiap pengguna dengan menyiapkan peran, seperti yang dijelaskan dalam Menggunakan Kontrol Akses UI Airflow.

Mengakses Google Cloud CLI

Untuk mengakses lingkungan Anda melalui Google Cloud CLI, identitas eksternal harus melakukan hal berikut:

Login dengan Google Cloud CLI menggunakan identitas eksternal.
Jalankan perintah gcloud composer environments.

Mengakses Cloud Composer API

Cloud Composer API dapat digunakan dengan identitas eksternal untuk mengelola semua lingkungan Cloud Composer dengan metode autentikasi yang didukung seperti token OAuth.

Mengakses Airflow REST API

Airflow REST API tersedia di endpoint untuk identitas eksternal dengan metode autentikasi yang didukung seperti token OAuth.

Untuk mendapatkan URL endpoint untuk identitas eksternal bagi lingkungan Anda, jalankan perintah Google Cloud CLI berikut:

gcloud composer environments describe ENVIRONMENT_NAME \
  --location LOCATION \
  --format="value(config.airflowByoidUri)"