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, 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 bagi developer untuk 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 oleh developer. Untuk mengetahui daftar lengkap library klien yang disediakan ABAP SDK untuk Google Cloud, lihat Library klien ABAP SDK untuk Google Cloud.

Sebagai developer ABAP, Anda dapat mem-build 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 untuk Google Cloud edisi SAP BTP, lakukan hal berikut:

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

  2. Anda memiliki ID S-User yang valid yang dikaitkan 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.

Mengupload sertifikat Google

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

Untuk mengupload sertifikat ke aplikasi SAP Maintain Certificate Trust List, Anda harus memiliki akses ke SAP_CORE_BC_SEC katalog bisnis. Katalog bisnis ini disertakan dalam peran bisnis bawaan 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 mengetahui informasi selengkapnya, lihat halaman SAP Mengakses Cockpit.

  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 Layanan Kepercayaan Google.

  9. Klik Upload. Sertifikat ditambahkan ke daftar tepercaya.

Menginstal ABAP SDK edisi SAP BTP 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 Landscape Portal Anda.

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

    2. Di 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 lainnya sesuai kebutuhan dan kirimkan kasus tersebut.

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

    Diperlukan waktu hingga 3 hari kerja agar ABAP SDK untuk Google Cloud terdaftar di Landscape Portal Anda. Jika SDK masih belum terdaftar setelah waktu ini, hubungi Cloud Customer Care untuk mendapatkan bantuan. Untuk mengetahui informasi tentang cara menghubungi Layanan Pelanggan, lihat Mendapatkan dukungan untuk SAP di Google Cloud.

  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 Target version, pilih 1.0.1.
    4. Di bagian Sistem yang tersedia, pilih instance ABAP tempat Anda perlu menginstal SDK.
    5. Klik Deploy. Bagian Product Version Deployment Status menampilkan status penyelesaian deployment.

Menambahkan aplikasi Fiori ke peluncur

ABAP SDK untuk Google Cloud edisi SAP BTP 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 menganalisis 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 Fiori SDK, 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 menyertakan template peran bisnis yang berisi katalog bisnis yang diperlukan untuk mengakses aplikasi Fiori.

Tabel berikut mencantumkan template peran bisnis dan aplikasi Fiori terkait yang menyediakan akses.

Template peran bisnis Nama aplikasi Deskripsi
/GOOG/BRT_SDK Google SDK: Konfigurasi Utama Gunakan aplikasi ini untuk mengonfigurasi autentikasi agar dapat terhubung dengan Google Cloud API secara aman.
Google SDK: Konfigurasi Log Aplikasi Gunakan aplikasi ini untuk mengonfigurasi logging guna merekam 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 Google SDK: Menampilkan Konfigurasi Utama Gunakan aplikasi ini untuk melihat konfigurasi SDK.
Google SDK: Konfigurasi Log Tampilan Gunakan aplikasi ini untuk melihat konfigurasi log aplikasi.
Google SDK: Tampilan Log Aplikasi Gunakan aplikasi ini untuk melihat log aplikasi SDK.

Untuk 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 ditentukan sebelumnya SAP_BR_ADMINISTRATOR.

Membuat peran bisnis

  1. Di lingkungan ABAP, buka Semua ruang > Administrasi > Identity and Access Management.
  2. Buka aplikasi Template Peran Bisnis.

  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. Pada 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 untuk peran bisnis.

  6. Klik Oke. Halaman Maintain Business Roles 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 Read, Write, Value Help, pilih No access.

  8. Atau, di tab Assigned Business Catalogs, Anda dapat melihat katalog bisnis aplikasi Fiori yang dikaitkan dengan peran bisnis.

  9. Klik Simpan.

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 Ruang Launchpad yang Ditetapkan, lalu klik Tambahkan.

  5. Pada dialog Tambahkan Ruang Launchpad 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 untuk ruang.
    • Judul ruang: masukkan judul untuk ruang.

  6. Klik Buat dan tetapkan ruang.

  7. Di tab Ruang Launchpad yang Ditetapkan, klik ID ruang Anda.

  8. Di halaman Detail Ruang yang muncul, buka tab Halaman, 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 Simpan.

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 Buat peran bisnis.
  4. Buka tab Pengguna Bisnis yang Ditetapkan, lalu klik Tambahkan.
  5. Di dialog Tambahkan Pengguna Bisnis yang muncul, telusuri dan pilih pengguna yang diperlukan yang memerlukan akses ke aplikasi Fiori SDK.
  6. Klik Oke. Pengguna dapat melihat ruang dan halaman yang ditetapkan dengan aplikasi SDK Fiori.

Mengonfigurasi autentikasi

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

Mengonfigurasi logging

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

Objek log /GOOG/LOG_OBJECT dan subobjek /GOOG/LOG_SUBOBJECT dikirim bersama 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: Application Logs Display. Untuk informasi selengkapnya, lihat Melihat log.

Untuk membuat konfigurasi log, lakukan langkah-langkah berikut:

  1. Akses peluncur 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:

    • Log config type: pilih OBJ_SUBOBJ.
    • Objek: pilih /GOOG/LOG_OBJECT.
    • Sub-objek: pilih /GOOG/LOG_SUBOBJECT.

  6. Klik Lanjutkan.

  7. Berikan detail berikut:

    • Hari retensi: menentukan jumlah hari log akan dipertahankan.

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

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

    • Akhir pada: tentukan tanggal akhir untuk masa aktif konfigurasi log ini. Tanggal akhir default-nya adalah 9999/12/31.

    • Adalah default: Untuk menjadikannya konfigurasi log default, centang kotak.

  8. Klik Create.

Mengelola 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 Editing status, pilih status yang sesuai, lalu klik Go.
  3. Klik entri konfigurasi log yang perlu Anda nonaktifkan.
  4. Klik Edit.
  5. Tetapkan End At ke tanggal sebelumnya.
  6. Klik Simpan.

Menentukan endpoint Google Cloud API

ABAP SDK untuk Google Cloud edisi SAP BTP 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 endpoint global sebagai nilai konstan. Library klien menggunakan endpoint ini saat metode dipanggil untuk menjalankan operasi pada resource API. Untuk menggunakan endpoint default, tidak diperlukan konfigurasi tambahan.

Endpoint kustom

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

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

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

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

  1. Akses peluncur SAP Fiori dari sistem ABAP BTP tempat ABAP SDK untuk Google Cloud diinstal.
  2. Buka Semua ruang > Administrasi > Pengelolaan Komunikasi.
  3. Buat sistem komunikasi:
    1. Buka aplikasi Sistem Komunikasi.
    2. Klik New.
    3. Pada dialog New Communication System yang muncul, masukkan nilai untuk kolom berikut:
      • ID Sistem: masukkan ID sistem.
      • Nama sistem: 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 Pengguna untuk Komunikasi Keluar, klik Tambahkan.
    8. Di kolom Authentication method, pilih None.
    9. Klik Create.
    10. Untuk menyimpan sistem komunikasi, klik Save.

  4. Buat pengaturan komunikasi:

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

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

      • Skenario: pilih Komunikasi Keluar untuk API apa pun (/GOOG/COM_SDK_SRV).
      • Nama pengaturan: masukkan nama untuk pengaturan komunikasi.

    4. Klik Create.

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

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

    7. Klik Simpan.

  5. Buat peta komunikasi untuk layanan API:

    1. Buka ruang yang berisi aplikasi Fiori untuk konfigurasi SDK.
    2. Buka aplikasi Google SDK: Main Configuration.
    3. Pilih kunci klien yang akan digunakan untuk membuat endpoint kustom. Asumsinya adalah Anda telah membuat kunci klien dan peta komunikasi untuk autentikasi. Jika belum, buat kunci klien dan peta komunikasi untuk autentikasi. Untuk 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 Communication arrangement, pilih pengaturan komunikasi yang Anda buat di langkah sebelumnya. Artefak komunikasi lainnya diisi secara otomatis.
    8. Klik Terapkan.
    9. Klik Simpan.
    10. Untuk memvalidasi konfigurasi endpoint kustom, klik Check connection. 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 mengumpulkan metrik penggunaan berikut:

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

Pemberian Lisensi

ABAP SDK untuk Google Cloud edisi SAP BTP tersedia sebagai "Software" berdasarkan perjanjian yang mengatur penggunaan Google Cloud Platform oleh Anda, termasuk Persyaratan Khusus Layanan yang tersedia di https://cloud.google.com/terms/service-terms. Tanpa membatasi umumnya persyaratan sebelumnya, Anda tidak boleh memodifikasi atau mendistribusikan ABAP SDK untuk Google Cloud tanpa izin tertulis yang jelas 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 perlu membeli lisensi yang sesuai secara terpisah untuk software SAP.

Siklus proses dukungan

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

Mendapatkan dukungan

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