Menginstal dan mengonfigurasi ABAP SDK edisi SAP BTP untuk Google Cloud

Dokumen ini menjelaskan cara menginstal dan mengonfigurasi ABAP SDK edisi SAP BTP untuk Google Cloud di lingkungan SAP BTP dan ABAP.

Dokumen ini ditujukan untuk administrator SAP, administrator Google Cloud, serta profesional keamanan SAP dan Google Cloud lainnya.

Ringkasan

ABAP SDK untuk Google Cloud menyediakan library klien dalam bentuk class ABAP agar developer dapat mengakses Google Cloud API secara terprogram. Dengan mengenkapsulasi fungsi penting seperti keamanan, autentikasi, serialisasi dan deserialisasi data, serta penanganan error sebagai komponen yang dapat digunakan kembali, library klien ini mengurangi jumlah kode yang perlu ditulis developer. Untuk mengetahui daftar lengkap library klien yang disediakan ABAP SDK untuk Google Cloud, lihat ABAP SDK untuk library klien Google Cloud.

Sebagai developer ABAP, Anda dapat membangun dan men-deploy solusi berbasis ML dan AI menggunakan berbagai layanan Google Cloud seperti Vertex AI, Document AI Warehouse, BigQuery, Dataproc, Pub/Sub, Google Workspace API, dan Google Maps Platform.

Untuk komunikasi antara SAP dan Google Cloud API, ABAP SDK untuk Google Cloud menggunakan protokol HTTPS dengan SSL.

Sebelum memulai

Sebelum menginstal ABAP SDK edisi SAP BTP untuk Google Cloud, lakukan hal berikut:

  1. Berlangganan ke Portal Lanskap SAP BTP. Untuk informasi tentang berlangganan portal Lanskap, lihat Berlangganan Portal Lanskap di kokpit SAP BTP.

  2. Anda memiliki S-User ID valid yang terkait dengan nomor pelanggan yang memiliki kontrak dukungan SAP aktif.

  3. Jika Anda baru menggunakan Google Cloud, buat akun di https://cloud.google.com.

  4. Jika Anda belum memiliki project Google Cloud, buat project:

    Buka pemilih project

  5. Pastikan penagihan diaktifkan untuk project Anda. Untuk informasi selengkapnya, lihat Memverifikasi status penagihan project.

  6. Aktifkan API yang didukung yang ingin Anda akses menggunakan SDK. Untuk mengetahui informasi tentang cara mengaktifkan Google Cloud API, lihat Mengaktifkan API.

Upload sertifikat Google

Untuk mengamankan komunikasi antara SAP BTP, lingkungan ABAP dan server Google, Anda harus mengupload sertifikat Google yang diperlukan ke dalam aplikasi Maintain Certificate Trust List di lingkungan SAP BTP, ABAP.

Untuk mengupload sertifikat ke aplikasi Daftar Kepercayaan Sertifikat SAP, Anda harus memiliki akses ke katalog bisnis SAP_CORE_BC_SEC. Katalog bisnis ini disertakan dalam peran bisnis yang telah ditetapkan SAP_BR_ADMINISTRATOR.

Untuk mengupload sertifikat Google, lakukan langkah-langkah berikut:

  1. Download sertifikat berikut dari repositori Layanan Kepercayaan Google:

    • GTS Root R1
    • GTS CA 1C3

  2. Login ke SAP BTP Cockpit. Untuk informasi selengkapnya, lihat halaman SAP Mengakses Kokpit.

  3. Pilih sub-akun tempat lingkungan ABAP Anda dihosting.

  4. Buka Instance and Subscriptions > Instances, lalu klik instance ABAP Anda.

  5. Di lingkungan ABAP yang terbuka, buka Semua ruang > Administrasi > Keamanan.

  6. Buka aplikasi Maintain Certificate Trust List.

  7. Klik Tambahkan.

  8. Pilih sertifikat yang Anda download dari repositori Google Trust Services.

  9. Klik Upload. Sertifikat akan ditambahkan ke daftar kepercayaan.

Menginstal edisi SAP BTP ABAP SDK untuk Google Cloud

Anda menginstal ABAP SDK edisi SAP BTP untuk Google Cloud menggunakan SAP BTP Landscape Portal.

Untuk menginstal ABAP SDK edisi SAP BTP untuk Google Cloud, lakukan langkah-langkah berikut:

  1. Dapatkan produk ABAP SDK untuk Google Cloud yang tersedia di Portal Lanskap Anda.

    1. Pada komponen BC-CP-ABA, buka kasus prioritas sedang dengan SAP menggunakan salah satu opsi berikut:

    2. Dalam deskripsi kasus, masukkan detail berikut:

      We would like the following product registered to our Landscape Portal:
* Product: /GOOG/ABAP_SDK
* Publisher: Google

    3. Berikan detail lain yang sesuai dan kirimkan kasusnya.

    Setelah SAP mengonfirmasi bahwa produk didaftarkan ke Portal Lanskap Anda, lanjutkan ke langkah berikutnya.

  2. Deploy produk ABAP SDK untuk Google Cloud:

    1. Di Landscape Portal, buka aplikasi Deploy.
    2. Di kolom Product, pilih /GOOG/ABAP_SDK.
    3. Di kolom Versi target, pilih 1.0.1.
    4. Di bagian Sistem yang tersedia, pilih instance ABAP tempat Anda perlu menginstal SDK.
    5. Klik Deploy. Bagian Status Deployment Versi Produk menampilkan status penyelesaian deployment.

Menambahkan aplikasi Fiori ke launchpad

ABAP SDK edisi SAP BTP untuk Google Cloud menyediakan aplikasi Fiori SAP untuk konfigurasi SDK dan logging aplikasi. Sebagai administrator atau developer, Anda menggunakan aplikasi Fiori ini untuk mengonfigurasi SDK dan mengonfigurasi logging aplikasi. SDK ini juga menyediakan aplikasi Fiori khusus hanya untuk melihat konfigurasi autentikasi, konfigurasi logging, dan analisis log SDK.

Administrator atau developer yang mengonfigurasi SDK dan logging, atau pengguna yang hanya perlu melihat konfigurasi dan log SDK, harus memiliki akses ke aplikasi Fiori yang relevan. Untuk memberikan akses ke aplikasi SDK Fiori, Anda perlu menambahkan katalog bisnis ABAP SDK untuk Google Cloud ke peran bisnis pengguna yang melakukan konfigurasi SDK atau perlu melihat konfigurasi dan logging. ABAP SDK untuk Google Cloud edisi SAP BTP mencakup template peran bisnis yang berisi katalog bisnis yang diperlukan untuk mengakses aplikasi Fiori.

Tabel berikut mencantumkan template peran bisnis dan aplikasi Fiori terkait yang aksesnya diberikan.

Template peran bisnis Nama aplikasi Deskripsi
/GOOG/BRT_SDK Google SDK: Konfigurasi Utama Gunakan aplikasi ini untuk mengonfigurasi autentikasi agar terhubung dengan Google Cloud API secara aman.
Google SDK: Konfigurasi Log Aplikasi Gunakan aplikasi ini untuk mengonfigurasi logging guna mencatat error, peringatan, dan pesan info ke dalam log aplikasi SAP.
Google SDK: Tampilan Log Aplikasi Gunakan aplikasi ini untuk melihat log aplikasi SDK.
/GOOG/BRT_SDK_DISPLAY SDK Google: Konfigurasi Utama Tampilan Gunakan aplikasi ini untuk melihat konfigurasi SDK.
SDK Google: Konfigurasi Log Tampilan Gunakan aplikasi ini untuk melihat konfigurasi log aplikasi.
Google SDK: Tampilan Log Aplikasi Gunakan aplikasi ini untuk melihat log aplikasi SDK.

Agar dapat menambahkan katalog bisnis ABAP SDK untuk Google Cloud ke peran bisnis pengguna menggunakan template peran bisnis yang disediakan, Anda harus memiliki akses ke katalog bisnis SAP_CORE_BC_SEC. Katalog bisnis ini disertakan dalam peran bisnis yang telah ditetapkan SAP_BR_ADMINISTRATOR.

Membuat peran bisnis

  1. Di lingkungan ABAP, buka Semua ruang > Administrasi > Identity and Access Management.
  2. Buka aplikasi Business Role Templates.

  3. Telusuri dan pilih template peran bisnis yang sesuai:

    • /GOOG/BRT_SDK: memberikan akses ke aplikasi Fiori untuk mengonfigurasi SDK.
    • /GOOG/BRT_SDK_DISPLAY: memberikan akses ke aplikasi Fiori untuk melihat konfigurasi dan log SDK.

  4. Klik Buat Peran Bisnis.

  5. Dalam dialog Create Business Role from Template yang muncul, masukkan nilai untuk kolom berikut:

    • ID peran bisnis baru: masukkan ID peran bisnis.
    • Deskripsi peran bisnis baru: masukkan deskripsi peran bisnis.

  6. Klik OK. Halaman Menjaga Peran Bisnis akan muncul dengan peran bisnis yang baru dibuat.

  7. Di bagian Kategori akses, tentukan akses untuk peran bisnis berdasarkan template peran bisnis yang dipilih:

    • /GOOG/BRT_SDK: Di kolom Read, Write, Value Help, pilih Unrestricted.
    • /GOOG/BRT_SDK_DISPLAY: Di kolom Baca, Tulis, Nilai Bantuan, pilih Tidak ada akses.

  8. Secara opsional, pada tab Assigned Business Catalogs, Anda dapat melihat katalog bisnis aplikasi Fiori yang terkait dengan peran bisnis.

  9. Klik Save.

Menetapkan ruang ke peran bisnis

  1. Di lingkungan ABAP, buka Semua ruang > Administrasi > Identity and Access Management.
  2. Buka aplikasi Maintain Business Roles.
  3. Telusuri dan pilih peran bisnis yang Anda buat di bagian Buat peran bisnis.
  4. Buka tab Assigned Launchpad Spaces, lalu klik Add.

  5. Dalam dialog Add Launchpad Space yang muncul, masukkan nilai untuk kolom berikut:

    • Menetapkan ruang ke peran bisnis: pilih Buat Ruang Baru.
    • ID ruang: masukkan ID ruang.
    • Deskripsi ruang: masukkan deskripsi ruang.
    • Judul ruang: masukkan judul untuk ruang.

  6. Klik Buat dan tetapkan ruang.

  7. Pada tab Assigned Launchpad Spaces, klik ID ruang Anda.

  8. Pada halaman Space Details yang muncul, buka tab Pages, lalu klik ID halaman.

  9. Di halaman Managed Launchpad Pages yang muncul, buka tab Page Content, lalu klik Edit.

  10. Di kolom Section Title, masukkan judul bagian.

  11. Di bagian Derived from Role, pilih aplikasi Fiori, lalu klik Add. Aplikasi Fiori ini ditampilkan dari katalog bisnis ABAP SDK untuk Google Cloud.

  12. Klik Save.

Menetapkan peran kepada pengguna bisnis

Untuk memberikan akses ke aplikasi Fiori SDK, Anda menetapkan peran yang baru dibuat kepada pengguna bisnis yang mengelola atau melihat konfigurasi dan log SDK.

  1. Di lingkungan ABAP, buka Semua ruang > Administrasi > Identity and Access Management.
  2. Buka aplikasi Maintain Business Roles.
  3. Telusuri dan pilih peran bisnis yang Anda buat di bagian Membuat peran bisnis.
  4. Buka tab Pengguna Bisnis yang Ditetapkan, dan klik Tambahkan.
  5. Dalam dialog Add Business Users yang muncul, telusuri dan pilih pengguna yang diperlukan yang memerlukan akses aplikasi SDK Fiori.
  6. Klik OK. Pengguna dapat melihat ruang dan halaman yang ditetapkan dengan aplikasi SDK Fiori.

Mengonfigurasi autentikasi

Untuk menggunakan Google Cloud API, Anda harus mengonfirmasi identitas melalui autentikasi. Untuk mengetahui informasi tentang opsi autentikasi ke Google Cloud dan langkah-langkah penyiapannya, baca artikel Autentikasi.

Mengonfigurasi logging

ABAP SDK edisi SAP BTP untuk Google Cloud menggunakan log aplikasi SAP untuk menyimpan semua pesan yang muncul selama eksekusi class library klien. Setelah Anda menentukan konfigurasi log default, SDK mulai mencatat pesan ke dalam log.

Objek log /GOOG/LOG_OBJECT dan subobjek /GOOG/LOG_SUBOBJECT dikirimkan dengan SDK yang dapat Anda gunakan untuk membuat konfigurasi log default.

Anda menggunakan aplikasi Google SDK: Konfigurasi Log Aplikasi untuk membuat konfigurasi log.

Anda dapat melihat log aplikasi menggunakan aplikasi Google SDK: Tampilan Log Aplikasi. Untuk informasi selengkapnya, baca Lihat log.

Untuk membuat konfigurasi log, lakukan langkah-langkah berikut:

  1. Akses landasan peluncuran SAP Fiori.
  2. Buka ruang yang berisi aplikasi Fiori untuk konfigurasi SDK.
  3. Buka aplikasi Google SDK: Application Log Configuration.
  4. Klik Create.

  5. Pada dialog Create yang muncul, masukkan nilai untuk kolom berikut:

    • Jenis konfigurasi log: pilih OBJ_SUBOBJ.
    • Object: pilih /GOOG/LOG_OBJECT.
    • Subobject: pilih /GOOG/LOG_SUBOBJECT.

  6. Klik Lanjutkan.

  7. Berikan detail berikut:

    • Hari retensi: tentukan jumlah hari log akan disimpan.

    • Log level: menentukan level log minimum. Nilai yang didukung adalah:

      • I: Informasi, Peringatan, dan Error
      • W: Peringatan dan Error
      • E: Khusus Error Sebaiknya tetapkan level log ke I, sehingga sebagian besar pesan log dicatat.

    • End at: menentukan tanggal akhir hingga konfigurasi log ini aktif. Tanggal akhir default adalah 9999/12/31.

    • Is default: Untuk menjadikan ini sebagai konfigurasi log default Anda, pilih kotak centang.

  8. Klik Create.

Kelola konfigurasi log

Jika konfigurasi log tidak lagi diperlukan, Anda dapat menonaktifkannya.

Untuk menonaktifkan konfigurasi log, lakukan langkah-langkah berikut:

  1. Buka aplikasi Google SDK: Application Log Configuration.
  2. Di kolom Status pengeditan, pilih status yang sesuai, lalu klik Buka.
  3. Klik entri konfigurasi log yang perlu dinonaktifkan.
  4. Klik Edit.
  5. Tetapkan End At ke tanggal yang sudah berlalu.
  6. Klik Save.

Menentukan endpoint Google Cloud API

ABAP SDK edisi SAP BTP untuk Google Cloud menyediakan opsi berikut untuk menentukan endpoint API saat memanggil Google Cloud API menggunakan class library klien API:

  • Endpoint default
  • Endpoint kustom

Endpoint default

Secara default, setiap class API melakukan hardcode pada endpoint global sebagai nilai konstanta. Library klien menggunakan endpoint ini ketika sebuah metode dipanggil untuk menjalankan operasi pada resource API. Untuk menggunakan endpoint default, konfigurasi tambahan tidak diperlukan.

Endpoint kustom

Dalam skenario yang memerlukan fleksibilitas untuk menentukan endpoint Anda sendiri, Anda dapat membuat endpoint kustom. Misalnya, Anda membuat endpoint kustom untuk membuat koneksi ke Google Cloud saat Anda perlu melakukan hal berikut:

  • Mengakses endpoint API spesifik per region untuk aplikasi yang sensitif terhadap peraturan atau latensi.
  • Gunakan API tertentu seperti Vertex AI, yang hanya menawarkan endpoint regional.

Untuk membuat endpoint kustom, gunakan skenario komunikasi /GOOG/COM_SDK_SRV yang dikirimkan dengan ABAP SDK untuk Google Cloud.

Prosedur berikut menggambarkan cara membuat endpoint regional untuk Pub/Sub API. Anda dapat mengikuti prosedur yang sama guna membuat endpoint kustom untuk layanan Google Cloud lain yang didukung.

  1. Mengakses launchpad SAP Fiori dari sistem BTP ABAP tempat ABAP SDK untuk Google Cloud diinstal.
  2. Buka Semua ruang > Administrasi > Pengelolaan Komunikasi.
  3. Membuat sistem komunikasi:
    1. Buka aplikasi Sistem Komunikasi.
    2. Klik New.
    3. Pada dialog New Communication System yang muncul, masukkan nilai untuk kolom berikut:
      • System ID: masukkan ID sistem.
      • System name: masukkan nama sistem.
    4. Klik Create.
    5. Di kolom Nama host, masukkan endpoint kustom Anda. Misalnya, masukkan endpoint regional untuk layanan Pub/Sub: https://asia-east1-pubsub.googleapis.com.
    6. Di kolom Port, masukkan 443.
    7. Pada tab Users for Outbound Communication, klik Tambahkan.
    8. Di kolom Authentication method, pilih None.
    9. Klik Create.
    10. Untuk menyimpan sistem komunikasi, klik Simpan.

  4. Membuat pengaturan komunikasi:

    1. Buka aplikasi Pengaturan Komunikasi.
    2. Klik New.

    3. Dalam dialog New Communication Arrangement yang muncul, masukkan detail berikut:

      • Skenario: pilih Outbound Communication for any API (/GOOG/COM_SDK_SRV).
      • Nama pengaturan: masukkan nama untuk pengaturan komunikasi.

    4. Klik Create.

    5. Untuk pengaturan komunikasi yang muncul, di kolom Sistem Komunikasi, pilih sistem komunikasi yang Anda buat di langkah sebelumnya.

    6. Di bagian Komunikasi keluar, di kolom Nama pengguna, pilih Tidak ada.

    7. Klik Save.

  5. Buat peta komunikasi untuk layanan API:

    1. Buka ruang yang berisi aplikasi Fiori untuk konfigurasi SDK.
    2. Buka aplikasi Google SDK: Konfigurasi Utama.
    3. Pilih kunci klien tempat Anda perlu membuat endpoint kustom. Anda dianggap telah membuat kunci klien dan peta komunikasi untuk autentikasi. Jika tidak, buat kunci klien dan peta komunikasi untuk autentikasi. Untuk mengetahui informasi selengkapnya, lihat Autentikasi.
    4. Klik Create.
    5. Pada dialog Create yang muncul, pilih nama layanan. Misalnya, pilih pubsub:v1.
    6. Klik Lanjutkan.
    7. Untuk peta komunikasi yang muncul, di kolom Pengaturan komunikasi, pilih pengaturan komunikasi yang Anda buat di langkah sebelumnya. Artefak komunikasi lainnya terisi secara otomatis.
    8. Klik Terapkan.
    9. Klik Save.
    10. Untuk memvalidasi konfigurasi endpoint kustom, klik Periksa koneksi. Centang hijau untuk entri menunjukkan konfigurasi yang berhasil. Jika terjadi error, buka halaman pemecahan masalah untuk mendapatkan panduan guna mengatasi error umum.

Metrik penggunaan

ABAP SDK edisi SAP BTP untuk Google Cloud mengumpulkan metrik penggunaan dan mengirimkannya ke Google untuk tujuan dukungan, sesuai dengan Pemberitahuan Privasi Google Cloud (Data Layanan yang Kami Kumpulkan). Metrik penggunaan ini dikumpulkan setiap kali Google Cloud API dipanggil dari ABAP SDK untuk Google Cloud.

SDK ini mengumpulkan metrik penggunaan berikut:

  • Metode autentikasi: informasi tentang metode autentikasi yang digunakan untuk memanggil layanan Google Cloud.
  • Versi ABAP SDK: nomor versi SAP BTP edisi ABAP SDK untuk Google Cloud.
  • Rilis SAP_ABA: versi komponen perangkat lunak SAP_ABA.

Pemberian Lisensi

ABAP SDK edisi SAP BTP untuk Google Cloud tersedia sebagai "Software" berdasarkan perjanjian yang mengatur penggunaan Anda atas Google Cloud Platform, termasuk Persyaratan Spesifik Per Layanan yang tersedia di https://cloud.google.com/terms/service-terms. Tanpa membatasi keumuman persyaratan sebelumnya, Anda tidak boleh mengubah atau mendistribusikan ABAP SDK untuk Google Cloud tanpa izin tertulis yang tegas dari Google.

Software ABAP SDK untuk Google Cloud ditawarkan tanpa biaya. Agar lebih jelas, penggunaan "Software" dan "Layanan" lainnya oleh Anda berdasarkan perjanjian yang mengatur penggunaan Google Cloud Platform, seperti Cloud Translation API dan Pub/Sub API dapat dikenai biaya.

ABAP SDK untuk Google Cloud tidak menyertakan lisensi apa pun untuk software SAP. Anda harus mendapatkan lisensi yang sesuai secara terpisah untuk software SAP.

Siklus proses dukungan

Google Cloud mendukung dan mempertahankan versi utama ABAP SDK edisi SAP BTP untuk Google Cloud saat ini selama minimal 12 bulan setelah publikasi pemberitahuan penghentian penggunaan versi utama sebelumnya di halaman Catatan Rilis untuk SAP di Google Cloud.

Dapatkan dukungan

Jika Anda memerlukan bantuan untuk menyelesaikan masalah terkait ABAP SDK untuk Google Cloud, lakukan hal berikut: