Workflows menggunakan akun layanan untuk memberi alur kerja akses ke resource Google Cloud . Akun layanan adalah akun khusus yang berfungsi sebagai identitas non-orang, seperti fungsi, aplikasi, atau VM. Akun ini memberi Anda cara untuk mengautentikasi non-orang ini. Anda dapat menganggap akun layanan sebagai identitas dan resource:
Saat menganggap akun layanan sebagai identitas, Anda dapat memberikan peran ke akun layanan, sehingga akun layanan tersebut dapat mengakses resource (seperti alur kerja).
Saat menganggap akun layanan sebagai resource, Anda dapat memberikan peran kepada pengguna lain untuk mengakses atau mengelola akun layanan tersebut.
Akun layanan diidentifikasi oleh alamat emailnya, yang bersifat unik untuk akun tersebut.
Untuk mengetahui informasi selengkapnya tentang cara menyiapkan autentikasi dengan aplikasi produksi, lihat Melakukan autentikasi sebagai akun layanan.
Akun layanan default
Setiap alur kerja dikaitkan dengan akun layanan Identity and Access Management (IAM) saat Anda membuat alur kerja. Jika Anda tidak menentukan akun layanan selama pembuatan alur kerja, alur kerja akan menggunakan akun layanan Compute Engine default untuk identitasnya. Untuk memverifikasi akun layanan yang terkait dengan alur kerja, dalam dokumen ini, lihat Memverifikasi akun layanan yang terkait dengan alur kerja.
Sebaiknya gunakan akun layanan default hanya untuk pengujian dan pengembangan. Untuk lingkungan produksi, sebaiknya buat akun layanan baru dan berikan satu atau beberapa peran IAM yang berisi izin minimum yang diperlukan untuk mengakses resource yang diorkestrasi oleh alur kerja Anda.
Satu-satunya peran yang diperlukan oleh akun layanan Anda adalah peran yang diperlukan untuk mengakses resource yang diorkestrasi oleh alur kerja Anda. Untuk mengetahui informasi selengkapnya, dalam dokumen ini, lihat Izin akun layanan.
Izin akun layanan
Karena akun layanan adalah identitas, Anda dapat mengizinkan akun layanan mengakses
resource dalam project Anda dengan memberinya peran, seperti yang Anda lakukan untuk
akun utama lainnya. Misalnya, jika Anda ingin mengizinkan alur kerja mengirim log ke
Cloud Logging, pastikan akun layanan yang menjalankan alur kerja
memiliki peran yang menyertakan izin logging.logEntries.create—misalnya,
peran IAM Logs Writer
(roles/logging.logWriter). Secara umum, peran yang diperlukan oleh akun layanan Anda bergantung pada resource yang Anda koordinasikan dengan alur kerja. Untuk menentukan peran yang diperlukan, tinjau
dokumentasi produk untuk resource yang Anda koordinasikan, atau
pilih peran bawaan.
Akun layanan alur kerja tidak memerlukan peran IAM Workflows Invoker (roles/workflows.invoker), kecuali jika alur kerja memanggil dirinya sendiri atau alur kerja lain (yaitu, membuat eksekusi alur kerja baru). Untuk mengetahui informasi selengkapnya, lihat Memanggil Workflows.
Melampirkan akun layanan ke resource
Untuk membuat alur kerja dan melampirkan akun layanan, Anda memerlukan izin untuk membuat alur kerja dan melampirkan akun layanan ke alur kerja.
Untuk mendapatkan izin yang
diperlukan untuk melampirkan akun layanan ke resource,
minta administrator untuk memberi Anda
peran IAM Service Account User (roles/iam.serviceAccountUser) di akun layanan atau project yang berisi akun layanan.
Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.
Peran yang telah ditetapkan ini berisi izin
iam.serviceAccounts.actAs,
yang diperlukan untuk
melampirkan akun layanan ke resource.
Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.
Saat memperbarui kode sumber atau akun layanan dari alur kerja yang ada, Anda
juga memerlukan izin iam.serviceAccounts.actAs:
- Hanya mengupdate kode sumber alur kerja (tanpa mengupdate akun layanan): Anda memerlukan izin
iam.serviceAccounts.actAspada akun layanan yang ada yang terkait dengan alur kerja. - Memperbarui akun layanan, atau kode sumber dan akun layanan: Anda memerlukan izin
iam.serviceAccounts.actAspada akun layanan baru yang Anda kaitkan dengan alur kerja.
Untuk mengetahui informasi selengkapnya tentang peran autentikasi akun layanan, lihat Peran untuk autentikasi akun layanan.
Memanggil fungsi Cloud Run
Di Cloud Run Functions, izin pemanggilan tersedia dengan mengelola layanan Cloud Run yang mendasarinya. Jika alur kerja Anda memanggil layanan Cloud Run Functions, Anda tidak perlu memberikan peran IAM Cloud Functions Invoker (roles/cloudfunctions.invoker) ke akun layanan pemanggil. Sebagai gantinya, Anda harus
memberikan
peran IAM
Cloud Run Invoker
(roles/run.invoker).
Untuk mengetahui informasi selengkapnya, lihat Membandingkan Cloud Run Functions.
Men-deploy alur kerja dengan akun layanan kustom
Anda dapat membuat akun layanan yang dikelola pengguna sendiri untuk memberi Anda fleksibilitas yang lebih besar dalam mengontrol akses ke alur kerja Anda.
Buat akun layanan Anda dan catat namanya.
Berikan akun layanan peran yang sesuai, berdasarkan resource yang harus diakses alur kerja untuk melakukan pekerjaannya.
Pastikan semua akun utama yang men-deploy atau mengupdate alur kerja memiliki izin untuk melampirkan atau bertindak sebagai akun layanan (
roles/iam.serviceAccountUser). Jika Anda yang membuat akun layanan, Anda akan otomatis diberi izin ini.Berikan peran pada project:
gcloud projects add-iam-policy-binding PROJECT_ID \ --member=PRINCIPAL \ --role='roles/iam.serviceAccountUser'
Atau, berikan peran di akun layanan:
gcloud iam service-accounts add-iam-policy-binding \ SERVICE_ACCOUNT_RESOURCE_NAME \ --member=PRINCIPAL \ --role='roles/iam.serviceAccountUser'
Ganti kode berikut:
PROJECT_ID: project ID Google Cloud yang berisi akun layanan dan alur kerja.PRINCIPAL: ID untuk deployer alur kerja dalam formatuser|group|serviceAccount:emailataudomain:domain. Contoh:user:dana@example.comgroup:admins@example.comserviceAccount:my-service-account@example.comdomain:example.com
SERVICE_ACCOUNT_RESOURCE_NAME: nama resource lengkap akun layanan, dalam format berikut:projects/PROJECT_ID/serviceAccounts/SERVICE_ACCOUNT_NAME@PROJECT_ID.Dengan
SERVICE_ACCOUNT_NAMEadalah nama akun layanan.
Deploy alur kerja Anda menggunakan akun layanan kustom.
Men-deploy alur kerja dengan akun layanan lintas project
Secara default, Anda tidak dapat membuat akun layanan dalam satu project dan melampirkannya ke resource dalam project lain. Petunjuk berikut menunjukkan cara melampirkan akun layanan dalam satu project ke alur kerja di project lain. Kemudian, Anda dapat menggunakan akun layanan di berbagai project untuk men-deploy alur kerja.
Jika akun layanan dan resource alur kerja berada dalam project yang berbeda, lakukan hal berikut:
Di konsol Google Cloud , buka halaman Organization policies untuk project tempat akun layanan berada:
Periksa kebijakan organisasi untuk project dan pastikan batasan boolean
iam.disableCrossProjectServiceAccountUsagetidak diterapkan untuk project. Untuk mengetahui informasi selengkapnya, lihat Mengaktifkan akun layanan untuk dilampirkan di seluruh project.Di project tempat akun layanan berada, buat akun layanan Anda dan catat namanya.
Berikan akun layanan peran yang sesuai, berdasarkan resource yang harus diakses alur kerja untuk melakukan pekerjaannya.
Berikan peran Service Account Token Creator (
roles/iam.serviceAccountTokenCreator) kepada agen layanan Workflows dalam project alur kerja. Hal ini memungkinkan agen layanan mengelola akses lintas project untuk akun layanan. Agen layanan adalah identitas layanan Google Cloud tertentu untuk project tertentu. Untuk mengetahui informasi selengkapnya, lihat Agen layanan.Konsol
Di konsol Google Cloud , buka halaman Workflows:
Untuk membuat alur kerja, klik Create, atau untuk memperbarui alur kerja yang ada, klik nama alur kerja.
Dalam daftar Service account, klik Switch project.
Pilih akun layanan dari project lain.
Jika diminta, berikan peran
roles/iam.serviceAccountTokenCreatorkepada agen layanan Workflows.
gcloud
Berikan peran
roles/iam.serviceAccountTokenCreatorke agen layanan Workflows:gcloud iam service-accounts add-iam-policy-binding \ SERVICE_ACCOUNT_RESOURCE_NAME \ --member='serviceAccount:service-WORKFLOWS_PROJECT_NUMBER@gcp-sa-workflows.' \ --role='roles/iam.serviceAccountTokenCreator'
Ganti kode berikut:
SERVICE_ACCOUNT_RESOURCE_NAME: nama resource lengkap akun layanan, dalam format berikut:projects/SERVICE_ACCOUNT_PROJECT_ID/serviceAccounts/SERVICE_ACCOUNT_NAME@SERVICE_ACCOUNT_PROJECT_ID.Dengan:
SERVICE_ACCOUNT_PROJECT_IDadalah project IDGoogle Cloud yang berisi akun layanan.SERVICE_ACCOUNT_NAMEadalah nama akun layanan.
WORKFLOWS_PROJECT_NUMBER: Google Cloud nomor project yang berisi resource alur kerja.
Pastikan semua akun utama yang men-deploy atau mengupdate alur kerja memiliki izin untuk melampirkan atau bertindak sebagai akun layanan (
roles/iam.serviceAccountUser). Jika Anda yang membuat akun layanan, Anda akan otomatis diberi izin ini.Konsol
Di konsol Google Cloud , buka halaman Workflows:
Untuk membuat alur kerja, klik Create, atau untuk memperbarui alur kerja yang ada, klik nama alur kerja.
Dalam daftar Service account, klik Switch project.
Pilih akun layanan dari project lain.
Jika diminta, berikan peran
roles/iam.serviceAccountUserpada project akun layanan.
gcloud
Berikan peran pada project yang berisi akun layanan:
gcloud projects add-iam-policy-binding \ SERVICE_ACCOUNT_PROJECT_ID \ --member=PRINCIPAL \ --role='roles/iam.serviceAccountUser'
Atau, berikan peran di akun layanan:
gcloud iam service-accounts add-iam-policy-binding \ SERVICE_ACCOUNT_RESOURCE_NAME \ --member=PRINCIPAL \ --role='roles/iam.serviceAccountUser'
Ganti kode berikut:
SERVICE_ACCOUNT_PROJECT_ID:Google Cloud project ID yang berisi akun layanan.PRINCIPAL: ID untuk deployer alur kerja dalam formatuser|group|serviceAccount:emailataudomain:domain. Sebagai contoh:user:dana@example.comgroup:admins@example.comserviceAccount:my-service-account@example.comdomain:example.com
SERVICE_ACCOUNT_RESOURCE_NAME: nama resource lengkap akun layanan, dalam format berikut:projects/SERVICE_ACCOUNT_PROJECT_ID/serviceAccounts/SERVICE_ACCOUNT_NAME@SERVICE_ACCOUNT_PROJECT_ID.Dengan
SERVICE_ACCOUNT_NAMEadalah nama akun layanan.
Deploy alur kerja Anda menggunakan akun layanan lintas project.
Memverifikasi akun layanan yang terkait dengan alur kerja
Anda dapat memverifikasi akun layanan mana yang terkait dengan alur kerja tertentu.
Konsol
Di konsol Google Cloud , buka halaman Workflows:
Di halaman Workflows, klik nama alur kerja.
Di halaman Workflow details, klik tab Details.
Tab Details menampilkan akun layanan yang terkait dengan alur kerja.
gcloud
Ambil deskripsi alur kerja dengan menjalankan perintah
gcloud workflows describe:
gcloud workflows describe WORKFLOW_NAME \ --location=LOCATION
Ganti kode berikut:
WORKFLOW_NAME: nama alur kerja Anda.LOCATION: region tempat alur kerja Anda di-deploy (misalnya,us-central1).
Outputnya mirip dengan berikut ini dan menyertakan akun layanan terkait:
createTime: '2020-06-05T23:45:34.154213774Z' name: projects/my-project/locations/us-central1/workflows/my-workflow serviceAccount: projects/my-project/serviceAccounts/012345678901-compute@ sourceContents: [...]