sap-btp-connectivity

SAP BTP Connectivity スキル

関連スキル

• sap-btp-cloud-platform：プラットフォームの基礎、BTP アカウントのセットアップ、統合パターンに使用します
• sap-btp-best-practices：実装ガイダンス、セキュリティのベストプラクティス、本番環境へのデプロイに使用します
• sap-cap-capire：CAP サービスの接続、宛先の利用、安全な API アクセスに使用します
• sap-fiori-tools：Fiori アプリの宛先設定とフロントエンド接続に使用します
• sap-abap：RFC 経由で ABAP システムに接続するとき、またはプリンシパル伝播を実装するときに使用します

このスキルを使用する場合

BTP の宛先、Cloud Connector、OAuth フロー、プリンシパル伝播、RFC/LDAP/MAIL/TCP 接続、Kubernetes/Kyma 接続プロキシ、マルチテナントの宛先アクセスを設定するとき、または 405、407、503、プロキシ障害などの接続エラーをトラブルシューティングするときに、このスキルを使用します。

目次

1. 概要
2. クイックスタート
3. 接続シナリオ
4. 宛先タイプ
5. 認証設定
6. Cloud Connector のセットアップ
7. Kubernetes/Kyma 接続
8. 一般的な問題とトラブルシューティング
9. セキュリティのベストプラクティス
10. 重要なルール
11. 同梱リソース

---

概要

SAP BTP Connectivity を使用すると、SAP BTP アプリケーションからクラウド、オンプレミス、VPC 環境にあるリモートサービスへ安全にアクセスできます。

主なコンポーネント

コンポーネント	目的
Destination Service	接続メタデータ、認証、ルーティングを管理します
Connectivity Service	Cloud Connector 経由で Kubernetes ワークロードを有効にします
Cloud Connector	オンプレミスへの安全なトンネリングを実現するリバースプロキシです
Connectivity Proxy	オンプレミスアクセス用の Kubernetes コンポーネントです
Transparent Proxy	統合された宛先アクセス用の Kubernetes コンポーネントです

対応環境：Cloud Foundry、ABAP Environment、Kyma
対応プロトコル：HTTP/HTTPS、RFC、TCP（SOCKS5）、LDAP/LDAPS、Mail

---

クイックスタート

HTTP 宛先を作成する（Cloud Foundry）

1. BTP Cockpit で Connectivity > Destinations に移動します
2. Create > From Scratch を選択します
3. 次のように設定します：

   Name: my-destination
   Type: HTTP
   URL: https://api.example.com
   ProxyType: Internet
   Authentication: OAuth2ClientCredentials
   clientId: <your-client-id>
   clientSecret: <your-client-secret>
   tokenServiceURL: https://auth.example.com/oauth/token
   

Cloud Connector をセットアップする

1. SAP Tools からダウンロードします
2. https://localhost:8443 にアクセスします
3. Administrator / manage でログインします（すぐに変更してください）
4. サブアカウント接続を追加します

アプリケーションから宛先にアクセスする（Node.js）

const { getDestination } = require('@sap-cloud-sdk/connectivity');
const destination = await getDestination({ destinationName: 'my-destination' });

---

接続シナリオ

クラウド間

ProxyType: Internet
Authentication: OAuth2ClientCredentials | OAuth2SAMLBearerAssertion

クラウドからオンプレミス

ProxyType: OnPremise
Authentication: BasicAuthentication | PrincipalPropagation

オンプレミスネットワークへの Cloud Connector のインストールが必要です。

オンプレミスからクラウド（サービスチャネル）

Cloud Connector 経由で SAP BTP サービスにアクセスするオンプレミスシステム向けです。

---

宛先タイプ

タイプ	用途	ProxyType	一般的な認証方式
HTTP	REST/OData API	Internet/OnPremise	OAuth2、Basic、証明書
RFC	SAP システム	OnPremise	Basic、PrincipalPropagation
LDAP	ディレクトリサービス	Internet	Basic、NoAuth
MAIL	メールプロトコル	Internet	Basic、NoAuth
TCP	汎用 TCP	OnPremise	Basic

詳細設定：references/http-destinations.md、references/rfc-destinations.md、references/mail-tcp-ldap-destinations.md を参照してください。

---

認証設定

OAuth2ClientCredentials（サービス間）

Authentication: OAuth2ClientCredentials
clientId: <client-id>
clientSecret: <client-secret>
tokenServiceURL: https://auth.example.com/oauth/token

OAuth2SAMLBearerAssertion（ユーザー伝播）

Authentication: OAuth2SAMLBearerAssertion
audience: <target-audience>
clientKey: <client-key>
tokenServiceURL: https://auth.example.com/oauth2/token
KeyStoreLocation: <certificate-location>

PrincipalPropagation（オンプレミス SSO）

Authentication: PrincipalPropagation
ProxyType: OnPremise

Cloud Connector による X.509 証明書の生成が必要です。

完全なリファレンス：references/authentication-types.md（17 種類以上すべて）

---

Cloud Connector のセットアップ

インストール

• 本番環境：Windows MSI/Linux RPM パッケージ（サービス登録）
• 開発環境：ポータブルアーカイブ（手動実行）

初期設定

1. UI にアクセスします：https://<hostname>:8443
2. ログインします：Administrator / manage
3. 直ちにパスワードを変更してください
4. モードを選択します：Master または Shadow
5. サブアカウント接続を追加します

アクセス制御

オンプレミスリソースへのアクセスを設定します：

• バックエンドの種類：ABAP System、SAP Gateway、Non-SAP System、SAP HANA
• HTTP アクセス制御：システムマッピング + リソースパス + ポリシー

高可用性

• Master-Shadow：設定を同期するプライマリ + バックアップ
• 要件：安定したネットワーク、別々のマシン、同一のバージョン

完全なガイド：references/cloud-connector.md

---

Kubernetes/Kyma 接続

Connectivity Proxy

Kubernetes ワークロードからオンプレミスシステムへのアクセスを可能にします。

インストール：

helm install connectivity-proxy \
  oci://registry-1.docker.io/sapse/connectivity-proxy \
  --version <version> --namespace <namespace> -f values.yaml

Transparent Proxy

BTP の宛先を Kubernetes サービスとして公開します。

インストール：

helm install transparent-proxy \
  oci://registry-1.docker.io/sapse/transparent-proxy \
  --version <version> --namespace <namespace> -f values.yaml

使用方法：Destination Custom Resource を作成し、Kubernetes サービスとしてアクセスします。

完全な設定：references/kubernetes-connectivity.md

---

よくある問題とトラブルシューティング

HTTP エラーコード

コード	原因	解決策
400	不正なリクエスト	リクエストの構文を確認します
401	認証の失敗	認証情報／トークンを確認します
405	HTTP ではなく HTTPS を使用	ポート 20003 で http:// を使用します
407	認証情報がありません	Proxy-Authorization: Bearer <token> を追加します
503	Cloud Connector がオフライン	CC 接続と Location ID を確認します

Cloud Connector の問題

サブアカウントに接続できない場合：

• リージョンのホスト URL を確認します
• ファイアウォールで送信 HTTPS が許可されていることを確認します
• サブアカウントの認証情報を確認します

リソースへのアクセスが拒否される場合：

• アクセス制御の設定を確認します
• 仮想ホストのマッピングを確認します
• リソースパスのポリシーを確認します

トラブルシューティングの詳細：references/troubleshooting.md

---

セキュリティのベストプラクティス

Cloud Connector

• IT 管理下の DMZ にデプロイします
• デフォルトのパスワードを直ちに変更します
• ユーザー管理用に LDAP を設定します
• 監査ログを有効にします（本番環境では All レベル）
• 高可用性（master + shadow）を構成します

宛先

• Basic 認証より OAuth を使用します
• 認証情報はコードではなく Destination Service に保存します
• すべての接続で TLS を有効にします
• セキュリティ強化のために mTLS を使用します

---

重要なルール

必ず実施すること

• Cloud Connector のデフォルトのパスワードを直ちに変更します
• すべての外部接続で HTTPS を使用します
• リソースを公開する前にアクセス制御を設定します
• 本番環境で監査ログを有効にします
• トークンと宛先を適切にキャッシュします

絶対に行わないこと

• Cloud Connector の UI をインターネットに公開する
• 認証情報をアプリケーションコードに保存する
• アクセス制御の設定を省略する
• Cloud Connector の Tomcat 設定ファイルを変更する
• 複数の master インスタンスを実行する（スプリットブレイン）

---

同梱リソース

設定リファレンス

• references/http-destinations.md - HTTP 宛先プロパティの詳細
• references/rfc-destinations.md - RFC 宛先プロパティとプーリング
• references/mail-tcp-ldap-destinations.md - Mail、TCP、LDAP の設定
• references/authentication-types.md - 17 種類以上の認証設定すべて

セットアップと設定

• references/cloud-connector.md - Cloud Connector のセットアップと設定
• references/kubernetes-connectivity.md - Connectivity Proxy と Transparent Proxy
• references/destination-service-api.md - REST API リファレンス

高度なトピック

• references/advanced-configuration.md - MTA、config.json、チェーン接続、ZTIS
• references/identity-propagation-scenarios.md - ABAP、NetWeaver Java、カスタム IDP
• references/operational-guides.md - ネットワークゾーン、ソリューション管理
• references/connectivity-alternatives-and-config.md - リバースプロキシ、ユーザーロール、RFC 設定

開発と SDK

• references/java-sdk-development.md - Java API、JCo、SAP Cloud SDK
• references/mail-protocols.md - SMTP、IMAP、POP3 の設定

テンプレート

• templates/destination-http-oauth.json - OAuth を使用する HTTP デスティネーションのテンプレート
• templates/destination-onpremise.json - オンプレミスデスティネーションのテンプレート
• templates/connectivity-proxy-values.yaml - Connectivity Proxy 用の Helm 値
• templates/transparent-proxy-values.yaml - Transparent Proxy 用の Helm 値

---

ドキュメントのリンク

• SAP 公式ドキュメント: https://help.sap.com/docs/connectivity
• GitHub リポジトリ: https://github.com/SAP-docs/btp-connectivity
• Destination API: https://api.sap.com/api/SAP_CP_CF_Connectivity_Destination
• リリースノート: https://help.sap.com/whats-new/cf0cb2cb149647329b5d02aa96303f56

---

最終更新日: 2025-11-27
次回レビュー: 2026-02-27
ソース: https://github.com/SAP-docs/btp-connectivity（383 ファイル、352 件以上を分析）