Lihat konektor yang didukung untuk Integration Aplikasi.

Mengelola profil autentikasi

Tugas di Integrasi Aplikasi Anda mungkin memerlukan koneksi ke aplikasi, layanan, atau sumber data eksternal. Profil autentikasi memungkinkan Anda mengonfigurasi dan menyimpan detail autentikasi untuk koneksi di Application Integration. Anda dapat mengonfigurasi tugas untuk menggunakan profil autentikasi yang tersimpan. Membuat profil autentikasi adalah aktivitas satu kali, dan Anda dapat menggunakan kembali profil yang sama di beberapa integrasi.

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk mengelola profil autentikasi, minta administrator untuk memberi Anda peran IAM berikut pada integrasi:

• Application Integration Admin (roles/integrations.integrationAdmin)
• Membuat profil autentikasi: Editor Integrasi Aplikasi (roles/integrations.integrationEditor)
• Mengedit profil autentikasi: Editor Integrasi Aplikasi (roles/integrations.integrationEditor)
• Menghapus profil autentikasi: Admin Integrasi Aplikasi (roles/integrations.integrationAdmin)

Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Membuat client ID OAuth 2.0

Client ID digunakan untuk mengidentifikasi satu aplikasi ke server OAuth Google. Jika aplikasi Anda berjalan di beberapa platform, setiap platform akan memerlukan client ID sendiri. Untuk menggunakan OAuth 2.0 di aplikasi, Anda memerlukan client ID OAuth 2.0, yang digunakan aplikasi Anda saat meminta token akses OAuth 2.0.

Untuk membuat client ID OAuth 2.0, lakukan langkah-langkah berikut:

1. Di konsol Google Cloud, buka APIs & Services > Credentials.

   Buka Kredensial

2. Klik + Create Credentials, lalu pilih OAuth client ID dari daftar opsi yang tersedia.

   Halaman Create OAuth client ID akan muncul.

3. Jenis aplikasi: Pilih Aplikasi Web dari menu drop-down.
4. Nama: Masukkan nama untuk klien OAuth 2.0 Anda guna mengidentifikasi klien di konsol Cloud.
5. Di bagian Authorized redirect URIs, klik +Add URI dan masukkan URL berikut:

    https://console.cloud.google.com/integrations/callback/locations/AUTH_PROFILE_REGION

6. Klik Create.

   Client ID OAuth 2.0 berhasil dibuat.

Membuat profil autentikasi baru

Untuk membuat profil autentikasi baru, pilih salah satu opsi berikut:

Konsol

1. Di konsol Google Cloud, buka halaman Integrasi Aplikasi.

   Buka Application Integration

2. Di menu navigasi, klik Auth Profiles.

Halaman Authentication Profiles akan muncul.

3. Klik Create dan masukkan detail berikut:
   • Di kolom Profile name, masukkan nama profil autentikasi yang akan ditampilkan di editor integrasi.
   • Dari daftar Region, pilih region untuk profil autentikasi.
   • Di kolom Deskripsi, masukkan deskripsi untuk profil autentikasi.
   • Klik Lanjutkan.
   • Dari daftar Authentication type, pilih jenis autentikasi dan masukkan detail yang diperlukan. Berdasarkan pilihan Anda, dialog akan menampilkan kolom tambahan yang diperlukan untuk kredensial autentikasi. Anda dapat memilih salah satu jenis autentikasi berikut:
     • Token autentikasi
     • Token ID OIDC Google
     • Token Web JSON (JWT)
     • Kode otorisasi OAuth 2.0
     • Kredensial klien OAuth 2.0
     • Kredensial sandi pemilik resource OAuth 2.0
     • Khusus sertifikasi klien SSL/TLS
     • Service account
   • Secara opsional, Anda dapat menambahkan sertifikat klien SSL/TLS yang digunakan oleh server untuk memvalidasi identitas klien. Anda dapat memasukkan kolom berikut:
     1. Sertifikat SSL
     2. Kunci pribadi
     3. Frasa sandi kunci pribadi
4. Klik Create.

Terraform

Gunakan resource google_integrations_client. Anda dapat menggunakan terraform untuk membuat profil autentikasi berikut:

• Token autentikasi
• Khusus sertifikasi klien SSL/TLS
• Token Web JSON (JWT)
• Kode otorisasi OAuth 2.0
• Kredensial klien OAuth 2.0
• Token ID OIDC
• Service account

Token autentikasi

Contoh berikut membuat Jenis autentikasi token Auth di region us-central1:

resource "google_integrations_client" "client" {
  location = "us-central1"
}

resource "google_integrations_auth_config" "auth_config_auth_token" {
  location     = "us-central1"
  display_name = "tf-auth-token"
  description  = "Test auth config created via terraform"
  decrypted_credential {
    credential_type = "AUTH_TOKEN"
    auth_token {
      type  = "Basic"
      token = "some-random-token"
    }
  }
  depends_on = [google_integrations_client.client]
}

Sertifikasi klien SSL/TLS

Contoh berikut membuat jenis autentikasi sertifikasi klien SSL/TLS di region us-central1:

resource "google_integrations_auth_config" "auth_config_certificate" {
  location     = "us-central1"
  display_name = "tf-certificate"
  description  = "Test auth config created via terraform"
  decrypted_credential {
    credential_type = "CLIENT_CERTIFICATE_ONLY"
  }
  client_certificate {
    ssl_certificate       = <<EOT
-----BEGIN CERTIFICATE-----
MIICTTCCAbagAwIBAgIJAPT0tSKNxan/MA0GCSqGSIb3DQEBCwUAMCoxFzAVBgNV
BAoTDkdvb2dsZSBURVNUSU5HMQ8wDQYDVQQDEwZ0ZXN0Q0EwHhcNMTUwMTAxMDAw
MDAwWhcNMjUwMTAxMDAwMDAwWjAuMRcwFQYDVQQKEw5Hb29nbGUgVEVTVElORzET
MBEGA1UEAwwKam9lQGJhbmFuYTCBnzANBgkqhkiG9w0BAQEFAAOBjQAwgYkCgYEA
vDYFgMgxi5W488d9J7UpCInl0NXmZQpJDEHE4hvkaRlH7pnC71H0DLt0/3zATRP1
JzY2+eqBmbGl4/sgZKYv8UrLnNyQNUTsNx1iZAfPUflf5FwgVsai8BM0pUciq1NB
xD429VFcrGZNucvFLh72RuRFIKH8WUpiK/iZNFkWhZ0CAwEAAaN3MHUwDgYDVR0P
AQH/BAQDAgWgMB0GA1UdJQQWMBQGCCsGAQUFBwMBBggrBgEFBQcDAjAMBgNVHRMB
Af8EAjAAMBkGA1UdDgQSBBCVgnFBCWgL/iwCqnGrhTPQMBsGA1UdIwQUMBKAEKey
Um2o4k2WiEVA0ldQvNYwDQYJKoZIhvcNAQELBQADgYEAYK986R4E3L1v+Q6esBtW
JrUwA9UmJRSQr0N5w3o9XzarU37/bkjOP0Fw0k/A6Vv1n3vlciYfBFaBIam1qRHr
5dMsYf4CZS6w50r7hyzqyrwDoyNxkLnd2PdcHT/sym1QmflsjEs7pejtnohO6N2H
wQW6M0H7Zt8claGRla4fKkg=
-----END CERTIFICATE-----
EOT
    encrypted_private_key = <<EOT
-----BEGIN PRIVATE KEY-----
MIIEvQIBADANBgkqhkiG9w0BAQEFAASCBKcwggSjAgEAAoIBAQCA/Oj2HXqs5fTk
j/8DrlOQtLG3K9RMsYHvnwICLxkGqVcTfut58hDFLbQM8C3C0ENAKitNJplCJmYG
8VpgZzgq8VxaGnlP/sXUFLMGksd5sATn0sY3SkPndTKk/dqqA4MIh/dYfh19ynEN
hB9Ll/h54Yic2je2Qaxe/uMMu8RODTz3oCn7FcoYpPvfygfU0ntn4IcqH/hts5DG
s+3otJk4entRZglQDxR+sWOsbLtJIQZDP8rH3jDVdl5l3wspgtMTY8b5T5+pLm0p
/OzCmxT0dq/O6BhpxI1xf/zcdRZeWk5DTJxTi5AgPquTlAG/B6A3HkqBJ14hT/Rk
iv7Ma3DLAgMBAAECggEABATkf9VfpiAT9zYdouk50bBpckvymQTyQLD8SlBaX+KY
kgv/pHSXK4Pm4iensrQerFLgfqPA3U+FiqjW5Mv7c1VRK6HJbuVkpdzoXLI9IQsL
vsBY7//9Ajk5P7NokjdB6JPdU/2dHROuQVa59cxPtzpHo0htnPlDOKXfFZZuoZ17
Nr8WQHrHy8P8ABM1tLOzvU9Nlh7TcjQvev+HxkLek4qzYyJ/Ac7XOjg/XKUm1tZk
O3BHr8YLabwyjO7l1t+2b14rUTL/8pfUZnAkEi3FAlPxm3ilftmX65zliC9G4ghk
dr5PByT3DqnuIIglua9bISv1H34ogecd+9a6EU7RxQKBgQC2RPKLounXZo8vYiU4
sFTEvjbs+u9Ypk4OrNLnb8KdacLBUaJGnf++xbBoKpwFCBJfy//fvuQfusYF9Gyn
GxL43tw94C/H5upQYnDsmnQak6TbOu3mA24OGK7Rcq6NEHgeCY4HomutnSiPTZJq
8jlpqgqh1itETe5avgkMNq3zBwKBgQC1KlztGzvbB+rUDc6Kfvk5pUbCSFKMMMa2
NWNXeD6i2iA56zEYSbTjKQ3u9pjUV8LNqAdUFxmbdPxZjheNK2dEm68SVRXPKOeB
EmQT+t/EyW9LqBEA2oZt3h2hXtK8ppJjQm4XUCDs1NphP87eNzx5FLzJWjG8VqDq
jOvApNqPHQKBgDQqlZSbgvvwUYjJOUf5R7mri0LWKwyfRHX0xsQQe43cCC6WM7Cs
Zdbu86dMkqzp+4BJfalHFDl0llp782D8Ybiy6CwZbvNyxptNIW7GYfZ9TVCllBMh
5izIqbgub4DWNtq591l+Bf2BnmstU3uiagYw8awSBP4eo9p6y1IgkDafAoGBAJbi
lIiqEP0IqA06/pWc0Qew3rD7OT0ndqjU6Es2i7xovURf3QDkinJThBZNbdYUzdsp
IgloP9yY33/a90SNLLIYlARJtyNVZxK59X4qiOpF9prlfFvgpOumfbkj15JljTB8
aGKkSvfVA5jRYwLysDwMCHwO0bOR1u3itos5AgsFAoGAKEGms1kuQ5/HyFgSmg9G
wBUzu+5Y08/A37rvyXsR6GjmlZJvULEopJNUNCOOpITNQikXK63sIFry7/59eGv5
UwKadZbfwbVF5ipu59UxfVE3lipf/mYePDqMkHVWv/8p+OnnJt9uKnyW8VSOu5uk
82QF30zbIWDTUjrcugVAs+E=
-----END PRIVATE KEY-----
EOT
  }
  depends_on = [google_integrations_client.client]
}

Token Web JSON (JWT)

Contoh berikut membuat jenis autentikasi Token Web JSON (JWT) di region us-central1:

resource "google_integrations_auth_config" "auth_config_jwt" {
  location     = "us-central1"
  display_name = "tf-jwt"
  description  = "Test auth config created via terraform"
  decrypted_credential {
    credential_type = "JWT"
    jwt {
      jwt_header  = "{\"alg\": \"HS256\", \"typ\": \"JWT\"}"
      jwt_payload = "{\"sub\": \"1234567890\", \"name\": \"John Doe\", \"iat\": 1516239022}"
      secret      = "secret"
    }
  }
  depends_on = [google_integrations_client.client]
}

Kode otorisasi OAuth 2.0

Contoh berikut membuat jenis autentikasi sertifikasi klien SSL/TLS di region us-central1:

resource "google_integrations_auth_config" "auth_config_oauth2_authorization_code" {
  location     = "us-central1"
  display_name = "tf-oauth2-authorization-code"
  description  = "Test auth config created via terraform"
  decrypted_credential {
    credential_type = "OAUTH2_AUTHORIZATION_CODE"
    oauth2_authorization_code {
      client_id      = "Kf7utRvgr95oGO5YMmhFOLo8"
      client_secret  = "D-XXFDDMLrg2deDgczzHTBwC3p16wRK1rdKuuoFdWqO0wliJ"
      scope          = "photo offline_access"
      auth_endpoint  = "https://authorization-server.com/authorize"
      token_endpoint = "https://authorization-server.com/token"
    }
  }
  depends_on = [google_integrations_client.client]
}

Kredensial klien OAuth 2.0

Contoh berikut membuat jenis autentikasi kredensial klien OAuth 2.0 di region us-central1:

resource "google_integrations_auth_config" "auth_config_oauth2_client_credentials" {
  location     = "us-central1"
  display_name = "tf-oauth2-client-credentials"
  description  = "Test auth config created via terraform"
  decrypted_credential {
    credential_type = "OAUTH2_CLIENT_CREDENTIALS"
    oauth2_client_credentials {
      client_id      = "demo-backend-client"
      client_secret  = "MJlO3binatD9jk1"
      scope          = "read"
      token_endpoint = "https://login-demo.curity.io/oauth/v2/oauth-token"
      request_type   = "ENCODED_HEADER"
      token_params {
        entries {
          key {
            literal_value {
              string_value = "string-key"
            }
          }
          value {
            literal_value {
              string_value = "string-value"
            }
          }
        }
      }
    }
  }
  depends_on = [google_integrations_client.client]
}

Token ID OIDC Google

Contoh berikut membuat jenis autentikasi token ID OIDC Google di region us-central1:

resource "random_id" "default" {
  byte_length = 8
}

resource "google_service_account" "service_account" {
  account_id   = "sa-${random_id.default.hex}"
  display_name = "Service Account"
}

resource "google_integrations_auth_config" "auth_config_oidc_token" {
  location     = "us-central1"
  display_name = "tf-oidc-token"
  description  = "Test auth config created via terraform"
  decrypted_credential {
    credential_type = "OIDC_TOKEN"
    oidc_token {
      service_account_email = google_service_account.service_account.email
      audience = "https://us-central1-project.cloudfunctions.net/functionA 1234987819200.apps.googleusercontent.com"
    }
  }
depends_on = [google_service_account.service_account, google_integrations_client.client]
}

Service account

Contoh berikut membuat jenis autentikasi akun layanan di region us-central1:

resource "random_id" "default" {
  byte_length = 8
}
  
resource "google_service_account" "service_account" {
  account_id   = "sa-${random_id.default.hex}"
  display_name = "Service Account"
}
resource "google_integrations_auth_config" "auth_config_service_account" {
  location     = "us-central1"
  display_name = "tf-service-account"
  description  = "Test auth config created via terraform"
  decrypted_credential {
    credential_type = "SERVICE_ACCOUNT"
    service_account_credentials {
    service_account = google_service_account.service_account.email
    scope = "https://www.googleapis.com/auth/cloud-platform https://www.googleapis.com/auth/adexchange.buyer https://www.googleapis.com/auth/admob.readonly"
    }
  }
depends_on = [google_service_account.service_account, google_integrations_client.client]
}

Setelah Anda menyimpan, profil autentikasi baru akan tersedia sebagai opsi di drop-down Authorization profile to use dari tugas apa pun yang memerlukan autentikasi.

Opsional. Jika belum membuat profil autentikasi sebelum mengonfigurasi tugas integrasi, Anda dapat mengakses dialog pembuatan profil dengan memilih + Tambahkan profil autentikasi baru dari drop-down Profil otorisasi yang akan digunakan di panel konfigurasi tugas. Ikuti langkah-langkah sebelumnya untuk membuat profil autentikasi baru.

Mengedit profil autentikasi

Untuk mengedit profil autentikasi, ikuti langkah-langkah berikut:

1. Di konsol Google Cloud, buka halaman Integrasi Aplikasi.

   Buka Application Integration

2. Di menu navigasi, klik Auth Profiles.

Halaman Authentication Profiles akan muncul.

3. Pilih Region untuk profil autentikasi menggunakan menu drop-down di halaman Authentication Profiles.
4. Klik (menu Tindakan), lalu klik Edit.

   Dialog Authentication Profiles akan muncul.

5. Edit detailnya, lalu klik Simpan.

Menghapus profil autentikasi

Untuk menghapus profil autentikasi, ikuti langkah-langkah berikut:

1. Di konsol Google Cloud, buka halaman Integrasi Aplikasi.

   Buka Application Integration

2. Di menu navigasi, klik Auth Profiles.

Halaman Authentication Profiles akan muncul.

3. Pilih Region untuk profil autentikasi menggunakan menu drop-down di halaman Authentication Profiles.
4. Klik Hapus.

Jenis autentikasi

Jenis autentikasi yang diperlukan untuk menyelesaikan tugas integrasi bergantung pada autentikasi yang dikonfigurasi di server otorisasi. Server otorisasi dapat berupa server mandiri atau API yang menerbitkan kredensial ke klien pemanggil. Integrasi Aplikasi mendukung jenis autentikasi berikut:

• Token autentikasi
• Token ID OIDC Google
• Token Web JSON (JWT)
• Kode otorisasi OAuth 2.0
• Kredensial klien OAuth 2.0
• Kredensial sandi pemilik resource OAuth 2.0
• Khusus sertifikasi klien SSL/TLS
• Service account

Bagian berikut menjelaskan properti konfigurasi jenis autentikasi.

Token Autentikasi

Jenis autentikasi Token autentikasi menggunakan token (kredensial) untuk autentikasi. Kredensial dikirim ke server dalam header permintaan Authorization HTTP dalam format Authorization: TYPE CREDENTIALS. Untuk mengonfigurasi jenis autentikasi ini, tetapkan properti berikut:

• Jenis: Jenis autentikasi seperti Basic, Bearer, atau MAC.
• Token: Kredensial untuk jenis autentikasi.

Jika server autentikasi memerlukan sertifikat SSL/TLS, upload sertifikat dan kunci pribadi.

Untuk mengetahui tugas mana yang mendukung jenis autentikasi ini, lihat Kompatibilitas jenis autentikasi dengan tugas.

Token ID OIDC Google

Jenis autentikasi Token ID OIDC Google menggunakan Token Web JSON (JWT) untuk autentikasi. Penyedia OpenID Connect (OIDC) Google, accounts.google.com, menandatangani dan menerbitkan JWT ini untuk autentikasi menggunakan akun layanan. Untuk mengonfigurasi jenis autentikasi ini, tetapkan properti berikut:

• Akun layanan: Akun layanan (akun utama) di project Google Cloud Anda dengan izin untuk mengakses API.
  Catatan: Tetapkan peran IAM Service Account Token Creator ke akun layanan service-PROJECT_NUMBER@gcp-sa-integrations.. Untuk mengetahui informasi selengkapnya tentang cara menetapkan peran IAM, lihat Peran dan izin IAM.
• Audiens: Audiens untuk token OIDC (ini mengidentifikasi penerima yang dituju JWT). Misalnya, Trigger URL adalah audiens untuk tugas Cloud Function.

Untuk mengetahui tugas mana yang mendukung jenis autentikasi ini, lihat Kompatibilitas jenis autentikasi dengan tugas.

Token Web JSON (JWT)

Jenis autentikasi JWT menggunakan Token Web JSON (JWT) untuk autentikasi. Untuk mengetahui informasi selengkapnya tentang JWT, lihat RFC7519. Untuk mengonfigurasi jenis autentikasi ini, tetapkan properti berikut:

• Header JWT: Algoritma yang digunakan untuk membuat tanda tangan.

  Catatan: Anda hanya dapat menentukan algoritma HS256.

• Payload JWT: Kumpulan klaim. Anda dapat menggunakan klaim terdaftar, publik, atau kustom.
• Rahasia: Kunci bersama antara klien dan server autentikasi.

Jika server autentikasi memerlukan sertifikat SSL, upload sertifikat dan kunci pribadi menggunakan pemilih file. Masukkan frasa sandi kunci pribadi .

Untuk mengetahui tugas mana yang mendukung jenis autentikasi ini, lihat Kompatibilitas jenis autentikasi dengan tugas.

Kode otorisasi OAuth 2.0

Jenis autentikasi kode otorisasi OAuth 2.0 menggunakan token otorisasi OAuth 2.0 untuk autentikasi. Untuk mengonfigurasi jenis autentikasi ini, tetapkan properti berikut:

• Endpoint autentikasi: Endpoint ke endpoint autentikasi aplikasi. Anda akan dialihkan ke URL ini untuk meninjau izin akses aplikasi. Token hanya akan dibuat setelah akses diberikan.
• Endpoint token: Endpoint yang memberikan atau memperbarui token akses.
• Client ID: String unik yang diberikan oleh server autentikasi kepada klien terdaftar. Client ID bukan rahasia, dan ditampilkan kepada pemilik resource. Gunakan kolom ini bersama dengan secret klien.
• Rahasia: Kunci rahasia bersama antara klien (integrasi) dan server autentikasi.
• Cakupan: Cakupan token akses. Cakupan memungkinkan Anda menentukan izin akses untuk pengguna. Anda dapat menentukan beberapa cakupan yang dipisahkan oleh satu spasi (" "). Untuk informasi selengkapnya, lihat Cakupan OAuth 2.0 untuk Google API.

Jika server autentikasi memerlukan sertifikat SSL, upload sertifikat dan kunci pribadi menggunakan pemilih file. Masukkan frasa sandi kunci pribadi di kolom yang tersedia, jika diperlukan.

Untuk mengetahui tugas mana yang mendukung jenis autentikasi ini, lihat Kompatibilitas jenis autentikasi dengan tugas.

Kredensial klien OAuth 2.0

Jenis autentikasi kredensial klien OAuth 2.0 menggunakan token otorisasi OAuth 2.0 untuk autentikasi. Autentikasi ini pertama-tama meminta token akses menggunakan kredensial klien, lalu menggunakan token untuk mengakses resource yang dilindungi. Untuk mengonfigurasi jenis autentikasi ini, tetapkan properti berikut:

• Endpoint token: Endpoint yang memberikan atau memperbarui token akses.
• Client ID: String unik yang diberikan oleh server autentikasi kepada klien terdaftar. Client ID bukan rahasia, dan ditampilkan kepada pemilik resource. Gunakan kolom ini bersama dengan secret klien.
• Rahasia: Kunci rahasia bersama antara klien (integrasi) dan server autentikasi.
• Cakupan: Cakupan token akses. Cakupan memungkinkan Anda menentukan izin akses untuk pengguna. Anda dapat menentukan beberapa cakupan yang dipisahkan oleh satu spasi (" "). Untuk informasi selengkapnya, lihat Cakupan OAuth 2.0 untuk Google API.
• Jenis permintaan: Mekanisme untuk mengirim parameter permintaan ke server autentikasi untuk mengambil token akses. Anda dapat menentukan salah satu jenis permintaan berikut:
  • Header encoder: Mengenkode CLIENT ID dan CLIENT SECRET dalam format Base64 dan mengirim string yang dienkode dalam header otorisasi HTTP. Parameter permintaan yang tersisa dikirim dalam isi permintaan HTTP.
  • Parameter kueri: Mengirim parameter permintaan dalam string kueri.
  • Isi permintaan: Mengirim parameter permintaan menggunakan jenis konten application/x-www-form-urlencoded dan karakter UTF-8 di entity-body permintaan HTTP.
  • Tidak ditentukan
• Parameter token: Parameter permintaan yang diperlukan untuk mendapatkan token. Tentukan nilai dalam format nilai kunci dengan Key adalah nama parameter dan Value adalah nilai parameter yang sesuai.

Jika server autentikasi memerlukan sertifikat SSL, upload sertifikat dan kunci pribadi menggunakan pemilih file. Masukkan frasa sandi kunci pribadi di kolom yang tersedia, jika diperlukan.

Untuk mengetahui tugas mana yang mendukung jenis autentikasi ini, lihat Kompatibilitas jenis autentikasi dengan tugas.

Kredensial sandi pemilik resource OAuth 2.0

Jenis autentikasi kredensial sandi pemilik resource OAuth 2.0 menggunakan token otorisasi OAuth 2.0 untuk autentikasi. Autentikasi ini pertama-tama meminta token akses menggunakan kredensial pemilik resource (Nama Pengguna dan Sandi), lalu menggunakan token untuk mengakses resource yang dilindungi. Untuk mengonfigurasi jenis autentikasi ini, tetapkan properti berikut berdasarkan jenis instance yang Anda hubungkan:

• Endpoint token: Endpoint yang memberikan atau memperbarui token akses.
• Client ID: String unik yang diberikan oleh server autentikasi kepada klien terdaftar. Client ID bukan rahasia, dan ditampilkan kepada pemilik resource. Gunakan kolom ini bersama dengan secret klien.
• Rahasia: Kunci rahasia bersama antara klien (integrasi) dan server autentikasi.
• Cakupan: Cakupan token akses. Cakupan memungkinkan Anda menentukan izin akses untuk pengguna. Anda dapat menentukan beberapa cakupan yang dipisahkan oleh satu spasi (" "). Untuk informasi selengkapnya, lihat Cakupan OAuth 2.0 untuk Google API.
• Nama pengguna: Nama pengguna pemilik resource.
• Sandi: Sandi pengguna.
• Jenis permintaan: Mekanisme untuk mengirim parameter permintaan ke server autentikasi untuk mengambil token akses. Anda dapat menentukan salah satu jenis permintaan berikut:
  • Header encoder: Mengenkode CLIENT ID dan CLIENT SECRET dalam format Base64 dan mengirim string yang dienkode dalam header otorisasi HTTP. Mengirimkan parameter permintaan yang tersisa dalam isi permintaan HTTP.
  • Parameter kueri: Mengirim parameter permintaan dalam string kueri.
  • Isi permintaan: Mengirim parameter permintaan menggunakan jenis konten application/x-www-form-urlencoded dan karakter UTF-8 di entity-body permintaan HTTP.
• Parameter token: Parameter permintaan yang diperlukan untuk mendapatkan token. Tentukan nilai dalam format nilai kunci dengan Key adalah nama parameter dan Value adalah nilai parameter yang sesuai.

Jika server autentikasi memerlukan sertifikat SSL, upload sertifikat dan kunci pribadi menggunakan pemilih file. Masukkan frasa sandi kunci pribadi di kolom yang tersedia, jika diperlukan.

Untuk mengetahui tugas mana yang mendukung jenis autentikasi ini, lihat Kompatibilitas jenis autentikasi dengan tugas.

Khusus sertifikat klien SSL/TLS

Jenis autentikasi khusus sertifikat klien SSL/TLS hanya menggunakan sertifikat SSL/TLS untuk autentikasi. Upload sertifikat dan kunci pribadi yang diperlukan. Untuk mengonfigurasi jenis autentikasi ini, upload file berikut:

• Sertifikat SSL: Sertifikat yang dienkode dalam format PEM.
• Kunci pribadi: File kunci pribadi sertifikat yang dienkode dalam format PEM.

  Jika kunci pribadi memerlukan passphrase, masukkan Frasa sandi kunci pribadi.

Untuk mengetahui tugas mana yang mendukung jenis autentikasi ini, lihat Kompatibilitas jenis autentikasi dengan tugas.

Akun layanan

Jenis autentikasi Akun layanan menggunakan kredensial akun layanan project Google Cloud untuk autentikasi. Untuk mengonfigurasi jenis autentikasi ini, tetapkan properti berikut:

• Akun layanan: Akun layanan (akun utama) di project Google Cloud Anda dengan izin untuk mengakses API Anda.
  Catatan: Tetapkan peran IAM Service Account Token Creator ke akun layanan service-PROJECT_NUMBER@gcp-sa-integrations.. Untuk mengetahui informasi selengkapnya tentang cara menetapkan peran IAM, lihat Peran dan izin IAM.
• Cakupan: Cakupan izin akses yang diberikan kepada pengguna. Anda dapat menentukan beberapa cakupan yang dipisahkan oleh satu spasi (" "). Untuk informasi selengkapnya, lihat Cakupan OAuth 2.0 untuk Google API.

Untuk mempelajari praktik terbaik dalam membuat dan mengelola akun layanan, baca Praktik terbaik untuk menggunakan dokumentasi akun layanan.

Jika server autentikasi memerlukan sertifikat SSL, upload sertifikat dan kunci pribadi menggunakan pemilih file. Masukkan frasa sandi kunci pribadi di kolom yang tersedia, jika diperlukan.

Untuk mengetahui tugas mana yang mendukung jenis autentikasi ini, lihat Kompatibilitas jenis autentikasi dengan tugas.

Kompatibilitas jenis autentikasi dengan tugas

Tabel berikut mencantumkan jenis autentikasi dan tugas yang kompatibel. Anda dapat menggunakan informasi ini untuk memutuskan jenis autentikasi yang akan digunakan untuk suatu tugas.

Authentication type	Tugas dan pemicu yang kompatibel
Token autentikasi	Call REST Endpoint
Token ID OIDC Google	Call REST Endpoint Cloud Function
Token Web JSON (JWT)	Call REST Endpoint
Kode otorisasi OAuth 2.0	Call REST Endpoint Menjalankan Apps Script Tugas Cloud Run Functions
Kredensial klien OAuth 2.0	Call REST Endpoint
Kredensial sandi pemilik resource OAuth 2.0	Call REST Endpoint Pemicu Salesforce
Khusus sertifikat klien SSL/TLS	Call REST Endpoint
Service account	Call REST Endpoint Tugas konektor Tugas Integrasi Panggilan Tugas Cloud Run Functions

Aturan autentikasi

Jika integrasi Anda memiliki profil OAuth 2.0 dan akun layanan yang dikelola pengguna yang dikonfigurasi, profil OAuth 2.0 akan digunakan untuk autentikasi secara default. Jika profil OAuth 2.0 atau akun layanan yang dikelola pengguna tidak dikonfigurasi, akun layanan default (service-PROJECT_NUMBER@gcp-sa-integrations.) akan digunakan. Jika tugas tidak menggunakan akun layanan default, eksekusi akan gagal.