ABAP SDK for Google Cloud の SAP BTP エディションをインストールして構成する

SAP BTP edition v1.0

• SAP BTP edition v1.0
• On-premises or any cloud edition v1.6

このドキュメントでは、SAP BTP、ABAP 環境に ABAP SDK for Google Cloud の SAP BTP エディションをインストールして構成する方法について説明します。

このドキュメントは、SAP 管理者、Google Cloud 管理者、その他の SAP および Google Cloud のセキュリティ プロフェッショナルを対象としています。

概要

ABAP SDK for Google Cloud には、デベロッパーが Google Cloud APIs にプログラムでアクセスするための ABAP クラス形式のクライアント ライブラリが用意されています。これらのクライアント ライブラリは、セキュリティ、認証、データのシリアル化とシリアル化解除、エラー処理などの重要な機能を再利用可能なコンポーネントとしてカプセル化することで、デベロッパーが記述する必要があるコードの量を削減します。ABAP SDK for Google Cloud が提供するクライアント ライブラリの完全なリストについては、ABAP SDK for Google Cloud クライアント ライブラリをご覧ください。

ABAP デベロッパーは、Vertex AI、Document AI Warehouse、BigQuery、Dataproc、Pub/Sub、Google Workspace API、Google Maps Platform など、さまざまな Google Cloud サービスを使用して ML や AI を活用したソリューションを構築し、デプロイできます。

SAP と Google Cloud APIs 間の通信に、ABAP SDK for Google Cloud は HTTPS プロトコルと SSL を使用します。

始める前に

ABAP SDK for Google Cloud の SAP BTP エディションをインストールする前に、次の操作を行います。

1. SAP BTP Landscape Portal に参加します。Landscape Portal への登録については、Subscribing to the Landscape Portal in the SAP BTP cockpit をご覧ください。

2. 有効な S-User ID が、有効な SAP サポート契約のお客様番号に関連付けられている必要があります。

3. Google Cloud を初めて利用する場合は、https://cloud.google.com でアカウントを作成します。

4. 既存の Google Cloud プロジェクトが存在しない場合は、プロジェクトを作成します。

   プロジェクト セレクタに移動

5. プロジェクトで課金が有効になっていることを確認します。詳しくは、プロジェクトの課金ステータスを確認するをご覧ください。

6. SDK を使用してアクセスするサポート対象の API を有効にします。Google Cloud APIs を有効にする方法については、API を有効にするをご覧ください。

Google 証明書をアップロードする

SAP BTP、ABAP 環境と Google サーバー間の通信を保護するには、必要な Google 証明書を SAP BTP、ABAP 環境の Maintain Certificate Trust List アプリにアップロードする必要があります。

SAP Maintain Certificate Trust List アプリに証明書をアップロードするには、ビジネス カタログ SAP_CORE_BC_SEC にアクセスできる必要があります。このビジネス カタログは、事前定義のビジネスロール SAP_BR_ADMINISTRATOR に含まれています。

Google 証明書をアップロードする手順は次のとおりです。

1. Google Trust Services リポジトリから、次の証明書をダウンロードします。

   • GTS Root R1
   • GTS CA 1C3

2. SAP BTP Cockpit にログインします。詳細については、SAP のページ Access the Cockpit をご覧ください。

3. ABAP 環境がホストされているサブアカウントを選択します。

4. [Instances and Subscriptions] > [Instances] に移動し、ABAP インスタンスをクリックします。

5. 開いた ABAP 環境で、[All space] > [Administration] > [Security] に移動します。

6. Maintain Certificate Trust List アプリを開きます。

7. [Add] をクリックします。

8. Google Trust Services リポジトリからダウンロードした証明書を選択します。

9. [Upload] をクリックします。証明書が信頼リストに追加されます。

ABAP SDK for Google Cloud の SAP BTP エディションをインストールする

SAP BTP Landscape Portal を使用して、ABAP SDK for Google Cloud の SAP BTP エディションをインストールします。

ABAP SDK for Google Cloud の SAP BTP エディションをインストールするには、次の操作を行います。

1. Landscape Portal で利用可能な ABAP SDK for Google Cloud プロダクトを入手します。

   1. BC-CP-ABA コンポーネントで、次のいずれかのオプションを使用し、SAP の優先度中のケースを登録します。

      • SAP for Me アプリケーションでケースを登録します。ケースを登録するためのガイドラインについては、SAP のページ Submitting a Case をご覧ください。

        

      • Landscape Portal でケースを登録します。ケースを登録するためのガイドラインについては、SAP のページ Create Support Tickets をご覧ください。

        

   2. ケースの説明に次の詳細情報を入力します。

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

   3. 必要に応じて他の詳細情報を入力して、ケースを送信します。

   プロダクトが Landscape Portal に登録されていることを SAP が確認したら、次のステップに進みます。

   注: ABAP SDK for Google Cloud を入手するために SAP にケースを送信する必要があるのは、永続的な配信メカニズムが確立されるまでの一時的な対応です。

2. ABAP SDK for Google Cloud プロダクトをデプロイします。

   1. Landscape Portal で、Deploy アプリを開きます。
   2. [Product] フィールドで、[/GOOG/ABAP_SDK] を選択します。
   3. [Target version] フィールドで、[1.0.1] を選択します。
   4. [Available systems] で、SDK をインストールする ABAP インスタンスを選択します。
   5. [Deploy] をクリックします。[Product Version Deployment Status] セクションに、デプロイの完了ステータスが表示されます。

Fiori アプリをランチャーに追加する

ABAP SDK for Google Cloud の SAP BTP エディションでは、SDK 構成とアプリケーション ロギング用の SAP Fiori アプリが提供されます。管理者またはデベロッパーは、この Fiori アプリを使用して SDK を構成し、アプリケーション ロギングを構成します。また、SDK には、認証構成の表示、構成のロギング、SDK ログの分析専用の Fiori アプリも用意されています。

SDK とロギングを構成する管理者またはデベロッパー、または SDK の構成とログの表示のみを必要とするユーザーには、関連する Fiori アプリに対するアクセス権が必要です。SDK Fiori アプリへのアクセス権を付与するには、SDK の構成を行うユーザー、または構成とロギングを表示する必要があるユーザーのビジネスロールに、ABAP SDK for Google Cloud のビジネス カタログを追加する必要があります。ABAP SDK for Google Cloud の SAP BTP エディションには、Fiori アプリへのアクセスに必要なビジネス カタログを含むビジネスロール テンプレートが含まれています。

次の表に、ビジネスロール テンプレートと、アクセスが許可される Fiori アプリを示します。

ビジネスロール テンプレート	アプリ名	説明
/GOOG/BRT_SDK	Google SDK: Main Configuration	このアプリを使用して、Google Cloud APIs に安全に接続するための認証を構成します。
	Google SDK: Application Log Configurations	このアプリを使用して、エラー、警告、情報メッセージを SAP アプリケーション ログにキャプチャするようにロギングを構成します。
	Google SDK: Application Logs Display	このアプリを使用して、SDK アプリケーション ログを表示します。
/GOOG/BRT_SDK_DISPLAY	Google SDK: Display Main Configuration	このアプリを使用して、SDK の構成を表示します。
	Google SDK: Display Log Configuration	このアプリを使用して、アプリケーション ログの構成を表示します。
	Google SDK: Application Logs Display	このアプリを使用して、SDK アプリケーション ログを表示します。

提供されているビジネスロール テンプレートを使用して、ABAP SDK for Google Cloud のビジネス カタログをユーザーのビジネスロールに追加するには、ビジネス カタログ SAP_CORE_BC_SEC に対するアクセス権が必要です。このビジネス カタログは、事前定義のビジネスロール SAP_BR_ADMINISTRATOR に含まれています。

ビジネスロールを作成する

1. ABAP 環境で、[All spaces] > [Administration] > [Identity and Access Management] に移動します。
2. Business Role Templates アプリを開きます。

3. 必要に応じて、ビジネスロールのテンプレートを検索して選択します。

   • /GOOG/BRT_SDK: SDK の構成に必要な Fiori アプリへのアクセスが許可されます。
   • /GOOG/BRT_SDK_DISPLAY: SDK の構成とログの表示に必要な Fiori アプリへのアクセスが許可されます。

4. [Create Business Role] をクリックします。

5. 表示された [Create Business Role from Template] ダイアログで、次のフィールドに値を入力します。

   • New business role ID: ビジネスロール ID を入力します。
   • New business role description: ビジネスロールの説明を入力します。

6. [OK] をクリックします。[Maintain Business Roles] ページに、新しく作成したビジネスロールが表示されます。

7. [Access categories] で、選択したビジネスロールのテンプレートに基づいてビジネスロールのアクセスを指定します。

   • /GOOG/BRT_SDK: [Read, Write, Value Help] フィールドで、[Unrestricted] を選択します。
   • /GOOG/BRT_SDK_DISPLAY: [Read, Write, Value Help] フィールドで、[No access] を選択します。

8. 必要に応じて、[Assigned Business Catalogs] タブで、ビジネスロールに関連付けられている Fiori アプリのビジネス カタログを表示できます。

9. [Save] をクリックします。

ビジネスロールにスペースを割り当てる

1. ABAP 環境で、[All spaces] > [Administration] > [Identity and Access Management] に移動します。
2. Maintain Business Roles アプリを開きます。
3. ビジネスロールを作成するで作成したビジネスロールを検索して選択します。
4. [Assigned Launchpad Spaces] タブに移動し、[Add] をクリックします。

5. 表示された [Add Launchpad Space] ダイアログで、次のフィールドに値を入力します。

   • Assign space to business role: [Create New Space] を選択します。
   • Space ID: スペース ID を入力します。
   • Space description: スペースの説明を入力します。
   • Space title: スペースのタイトルを入力します。

6. [Create and assign space] をクリックします。

7. [Assigned Launchpad Spaces] タブで、スペースのスペース ID をクリックします。

8. 表示された [Space Details] ページで、[Pages] タブに移動し、ページ ID をクリックします。

9. 表示された [Managed Launchpad Pages] ページで、[Page Content] タブに移動し、[Edit] をクリックします。

10. [Section Title] フィールドにセクションのタイトルを入力します。

11. [Derived from Role] セクションで Fiori アプリを選択し、[Add] をクリックします。これらの Fiori アプリは、ABAP SDK for Google Cloud のビジネス カタログから表示されます。

12. [Save] をクリックします。

ビジネス ユーザーにロールを割り当てる

SDK Fiori アプリへのアクセス権を付与するには、SDK の構成とログを管理または表示するビジネス ユーザーに、新しく作成したロールを割り当てます。

1. ABAP 環境で、[All spaces] > [Administration] > [Identity and Access Management] に移動します。
2. Maintain Business Roles アプリを開きます。
3. ビジネスロールを作成するで作成したビジネスロールを検索して選択します。
4. [Assigned Business Users] タブに移動し、[Add] をクリックします。
5. 表示された [Add Business Users] ダイアログで、SDK Fiori アプリにアクセスする必要があるユーザーを検索して選択します。
6. [OK] をクリックします。ユーザーは、SDK Fiori アプリで割り当てられたスペースとページを確認できます。

認証を構成する

Google Cloud APIs を使用するには、認証によって本人確認を行う必要があります。Google Cloud に対する認証オプションと設定手順については、認証をご覧ください。

ロギングを構成する

ABAP SDK for Google Cloud の SAP BTP エディションでは、SAP アプリケーション ログを使用して、クライアント ライブラリ クラスの実行中に発生したすべてのメッセージを保存します。デフォルトのログ構成を定義すると、SDK はメッセージのロギングを開始します。

ログ オブジェクト /GOOG/LOG_OBJECT とサブオブジェクト /GOOG/LOG_SUBOBJECT は、デフォルトのログ構成の作成に使用できる SDK に付属しています。

Google SDK: Application Log configurations アプリを使用して、ログ構成を作成します。

アプリケーション ログは、Google SDK: Application Logs Display アプリを使用して表示できます。詳しくは、ログを表示するをご覧ください。

ログ構成を作成にするには、次の操作を行います。

1. SAP Fiori ランチャーにアクセスします。
2. SDK 構成用の Fiori アプリを含むスペースに移動します。
3. Google SDK: Application Log Configuration アプリを開きます。
4. [Create] をクリックします。

5. 表示された [Create] ダイアログで、次のフィールドに値を入力します。

   • Log config type: OBJ_SUBOBJ を選択します。
   • Object: /GOOG/LOG_OBJECT を選択します。
   • Subobject: /GOOG/LOG_SUBOBJECT を選択します。

6. [Continue] をクリックします。

7. 以下の詳細を入力します。

   • Retention days: ログを保持する日数を指定します。

   • Log level: 最小ログレベルを指定します。サポートされている値は次のとおりです。

     • I: 情報、警告、エラー
     • W: 警告とエラー
     • E: エラーのみ。ほとんどのログメッセージがログに記録されるように、ログレベルを I に設定することをおすすめします。

   • End at: このログ構成を有効な状態にしておく期間の終了日を指定します。デフォルトの終了日は 9999/12/31 です。

   • Is default: これをデフォルトのログ構成にするには、チェックボックスをオンにします。

8. [Create] をクリックします。

ログ構成を管理する

ログ構成が不要になった場合は無効にできます。

ログ構成を無効にするには、次の操作を行います。

1. Google SDK: Application Log Configuration アプリを開きます。
2. [Editing status] フィールドで適切なステータスを選択し、[Go] をクリックします。
3. 無効にするログ構成エントリをクリックします。
4. [Edit] をクリックします。
5. [End At] フィールドに過去の日付を設定します。
6. [Save] をクリックします。

Google Cloud API エンドポイントを指定する

ABAP SDK for Google Cloud の SAP BTP エディションには、API クライアント ライブラリ クラスを使用して Google Cloud API を呼び出すときに API エンドポイントを指定する次のオプションが用意されています。

• デフォルトのエンドポイント
• カスタム エンドポイント

デフォルトのエンドポイント

デフォルトでは、各 API クラスはグローバル エンドポイントを定数値としてハードコードします。クライアント ライブラリは、メソッドが呼び出されて API リソースに関するオペレーションを実行する際に、これらのエンドポイントを使用します。デフォルトのエンドポイントを使用する場合、追加の構成は必要ありません。

カスタム エンドポイント

独自のエンドポイントを柔軟に定義する必要があるシナリオでは、カスタム エンドポイントを作成できます。たとえば、次のような場合に、Google Cloud への接続を確立するためにカスタム エンドポイントを作成します。

• 規制対象のアプリケーションやレイテンシの影響を受けやすいアプリケーションで、API のリージョン固有のエンドポイントにアクセスする。
• リージョン エンドポイントのみを提供する Vertex AI などの特定の API を使用する。

カスタム エンドポイントを作成するには、ABAP SDK for Google Cloud に付属の通信シナリオ /GOOG/COM_SDK_SRV を使用します。

以下では、Pub/Sub API のリージョン エンドポイントを作成する方法について説明します。サポートされている他の Google Cloud サービスについても、同じ手順でカスタム エンドポイントを作成できます。

1. ABAP SDK for Google Cloud がインストールされている BTP ABAP システムの SAP Fiori ランチャーにアクセスします。
2. [All spaces] > [Administration] > [Communication Management] に移動します。
3. 通信システムを作成します。
   1. Communication Systems アプリを開きます。
   2. [New] をクリックします。
   3. 表示された [New Communication System] ダイアログで、次のフィールドに値を入力します。
      • System ID: システム ID を入力します。
      • System name: システム名を入力します。
   4. [Create] をクリックします。
   5. [Host name] フィールドに、カスタム エンドポイントを入力します。たとえば、Pub/Sub サービスのリージョン エンドポイント（https://asia-east1-pubsub.googleapis.com）を入力します。
   6. [Port] フィールドに、「443」と入力します。
   7. [Users for Outbound Communication] タブで [Add] をクリックします。
   8. [Authentication method] フィールドで [None] を選択します。
   9. [Create] をクリックします。
   10. 通信システムを保存するには、[Save] をクリックします。

4. 通信設定を作成します。

   1. Communication Arrangement アプリを開きます。
   2. [New] をクリックします。

   3. 表示された [New Communication Arrangement] ダイアログで、次の情報を入力します。

      • Scenario: [Outbound Communication for any API]（/GOOG/COM_SDK_SRV）を選択します。
      • Arrangement name: 通信設定の名前を入力します。

   4. [Create] をクリックします。

   5. 表示された通信設定の [Communication System] フィールドで、前の手順で作成した通信システムを選択します。

   6. [Outbound communication] の [User name] フィールドで、[None] を選択します。

   7. [Save] をクリックします。

5. API サービスの通信マップを作成します。

   1. SDK 構成用の Fiori アプリを含むスペースに移動します。
   2. Google SDK: Main Configuration アプリを開きます。
   3. カスタム エンドポイントを作成するクライアント鍵を選択します。ここでは、認証用のクライアント鍵と通信マップをすでに作成していることを前提としています。そうでない場合は、認証用のクライアント鍵と通信マップを作成します。詳細については、認証をご覧ください。
   4. [Create] をクリックします。
   5. 表示された [Create] ダイアログで、サービス名を選択します。たとえば、pubsub:v1 を選択します。
   6. [Continue] をクリックします。
   7. 表示された通信マップの [Communication arrangement] フィールドで、前の手順で作成した通信設定を選択します。その他の通信アーティファクトは自動的に入力されます。
   8. [Apply] をクリックします。
   9. [Save] をクリックします。
   10. カスタム エンドポイントの構成を検証するには、[Check connection] をクリックします。エントリの緑色のチェックは、構成が成功したことを示します。エラーが発生した場合は、トラブルシューティング ページで一般的なエラーの解決方法を確認してください。

使用状況の指標

ABAP SDK for Google Cloud の SAP BTP エディションは、Google Cloud のプライバシーに関する通知（収集するサービスデータ）に準拠して、使用状況の指標を収集し、サポート目的で Google に送信します。これらの使用状況の指標は、ABAP SDK for Google Cloud から Google Cloud API が呼び出されるたびに収集されます。

この SDK は、次の使用状況の指標を収集します。

• 認証方法: Google Cloud サービスの呼び出しに使用される認証方法に関する情報。
• ABAP SDK バージョン: ABAP SDK for Google Cloud の SAP BTP エディションのバージョン番号。
• SAP_ABA リリース: SAP_ABA ソフトウェア コンポーネントのバージョン。

ライセンス

ABAP SDK for Google Cloud の SAP BTP エディションは、Google Cloud Platform の使用を規定する契約に基づき、「ソフトウェア」として提供されます。これには、https://cloud.google.com/terms/service-terms で入手できるサービス固有の規約が含まれます。前述の利用規約の一般性を制限することなく、Google からの明示的な書面による許可なく、ABAP SDK for Google Cloud を変更または配布することはできません。

ABAP SDK for Google Cloud ソフトウェアは無料でご利用いただけます。明確さを期するため記載しますが、Cloud Translation API や Pub/Sub API など、Google Cloud Platform の使用を規定する契約に基づいて他の「ソフトウェア」および「サービス」を使用すると、費用が発生する可能性があります。

ABAP SDK for Google Cloud には SAP ソフトウェアのライセンスは含まれていません。SAP ソフトウェアの適切なライセンスを別途入手する必要があります。

サポート ライフサイクル

Google Cloud では、ABAP SDK for Google Cloud SAP BTP エディションの現在のメジャー バージョンを「Google Cloud での SAP のリリースノート ページ」において、前のメジャー バージョンの非推奨化のお知らせが公開されてから少なくとも 12 か月間、サポートし維持します。

サポートを利用する

ABAP SDK for Google Cloud の問題を解決するには、次の操作を行います。

• ABAP SDK for Google Cloud トラブルシューティング ガイドをご覧ください。

• Cloud フォーラムのコミュニティで ABAP SDK for Google Cloud について質問したり、ディスカッションに参加します。

• 入手可能なすべての診断情報を収集し、Cloud カスタマーケアにお問い合わせください。カスタマーケアへのお問い合わせについては、Google Cloud での SAP に関するサポートを受けるをご覧ください。