mcpField
S
sap-btp-cias

sap-btp-cias

github.com/secondskyクラウド・DevOps480657 回インストール3 週間前に更新
リポジトリ

sap-btp-cias について

SAP のクラウドおよびオンプレミス連携を計画・運用するチーム向けの、CIAS リファレンススキルです。シナリオ計画、タスク実行、監視、ロール設定、OAuth2 アクセス、トラブルシューティングを解説します。

主な機能

  1. 01ガイド付き連携シナリオの計画
  2. 02My Inbox タスクの処理
  3. 03ワークフロー実行の監視
  4. 04ロールコレクションと宛先の設定
  5. 05OAuth2 API アクセスの設定
  6. 06タスクとワークフローの問題調査

活用シーン

  1. 01SAP システム間連携の計画
  2. 02割り当てられた設定タスクの完了
  3. 03ワークフロー状態とログの確認
  4. 04CIAS のプログラムアクセス有効化

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/secondsky/sap-skills --skill sap-btp-cias

インストール後、Claude Code で/sap-btp-ciasを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

README.md
agents/
openai.yaml
references/
integration-scenarios.md
maintenance-planner.md
security-guide.md
setup-guide.md
task-ui-guide.md
troubleshooting.md
whats-new.md
templates/
destination-config.md
role-assignment.md

詳細

SAP BTP Cloud Integration Automation Service (CIAS)

Cloud Integration Automation Service では、SAP のクラウドソリューションをオンプレミスのソリューションや他の SAP クラウドソリューションと統合するためのガイド付きワークフローを利用できます。手動タスクの手順と、自動構成機能の両方を提供します。

関連するスキル

  • sap-btp-cloud-platform:サブアカウント、サブスクリプション、エンタイトルメント、ロールコレクションの設定に使用します
  • sap-btp-connectivity:接続先、OAuth2 サービスインスタンス、Cloud Connector の依存関係に使用します
  • sap-btp-integration-suite:CIAS のシナリオで Integration Suite のアーティファクトが作成される場合、またはそれらに依存する場合に使用します
  • sap-btp-cloud-identity-services:CIAS へのアクセスに影響する ID プロバイダーと信頼の構成に使用します

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

CIAS のサブスクリプション、CIAS ロールコレクションの割り当て、ガイド付き統合シナリオの計画、My Inbox タスクの操作、シナリオ実行の監視、OAuth2 API アクセスの設定、または CIAS ワークフロー/タスクの失敗のトラブルシューティングを行う場合に、このスキルを使用します。

目次

クイックリファレンス

サービスプラン
プラン種類目的
Standardアプリケーションシナリオ計画、タスクの監視、統合管理のための UI アクセス
OAuth2サービスプログラムによる操作のための API アクセス(ABAP の自動化に必要)
ロールコレクション
ロールコレクション機能
Integration AdministratorCIASIntegrationAdministratorフルアクセス:Plan for Integration、My Inbox、Monitoring。シナリオの終了
Integration ExpertCIASIntegrationExpertMy Inbox へのアクセス。割り当てられたタスクの作業
Integration MonitorCIASIntegrationMonitorScenario Execution Monitoring への読み取り専用アクセス
対応リージョン

AWS:EU10(フランクフルト)、EU11(フランクフルト EU Access)、US10(バージニア)、AP10(シドニー)、JP10(東京)、CA10(モントリオール)
Azure:EU20(オランダ)、CN20(中国北部 3)
Alibaba:CN40(上海)

主要なワークフロー

1. CIAS にサブスクライブする(Standard プラン)
  1. SAP BTP Cockpit → Global Account → Subaccount に移動します
  2. Services → Service Marketplace を開きます
  3. 「Cloud Integration Automation Service」で絞り込みます
  4. タイルをクリックし、Create → Standard プランを選択します
  5. 作成を確定します
  6. Instances and Subscriptions → 「Go to Application」アイコンからアクセスします
2. ユーザーにロールを割り当てる
  1. サブアカウントで Security → Role Collections に移動します
  2. ロールコレクション(例:CIASIntegrationAdministrator)を選択します
  3. Edit → Users タブをクリックします
  4. メール ID またはログインユーザー ID でユーザーを追加します
  5. 変更を保存します

カンマ区切りのユーザー ID を指定して、1 つのロールに複数のユーザーを割り当てることができます。

3. 統合シナリオを計画する
  1. Instances and Subscriptions から CIAS アプリケーションにアクセスします
  2. Plan for Integration タイルを開きます
  3. Solutions タブで利用可能なソリューションを参照します
  4. シナリオとシナリオオプションを選択します
  5. 統合するシステムを選択します(顧客番号で指定)
  6. 以下を指定します:
    • ワークフローのターゲットサブアカウント
    • SAP BTP Workflow Users(サブアカウントへのアクセス権が必要です)
    • 監視用のトランザクション名
  7. ワークフローの生成を確定します
  8. My Inbox タイルでタスクにアクセスします
4. タスクに取り組む(My Inbox)
  1. My Inbox タイルを開きます(Administrator または Expert ロールが必要です)
  2. Claim をクリックして、タスクを自分のユーザー用にロックします
  3. Task Instructions タブの指示に従います
  4. 自動化タスクの場合:パラメーターを設定 → Execute Step をクリックします
  5. 完了したら Task Completed をクリックします
  6. Refresh をクリックして次のタスクを表示します
  7. Execution Summary が表示されるまで繰り返します
5. 自動化用の宛先を作成する
  1. My Inbox → Confirm System Components タスクを開きます
  2. Create Destination リンクをクリックします
  3. 次の項目を設定します:
    • Name:有効な識別子
    • Description:目的の説明
    • URL:対象システムのホスト URL
    • Authentication:方式と認証情報
    • Type:HTTP(デフォルト)
  4. 設定を保存します

セキュアな通信のため、常に HTTPS を使用してください。

6. シナリオの実行を監視する
  1. Scenario Execution Monitoring タイルを開きます(Administrator または Monitor ロールが必要です)
  2. ステータス(Running、Completed、Canceled)でワークフローを絞り込みます
  3. タブを表示します:Task Details、Targets、Roles and Users、Scope、Support Information
  4. Terminate Execution を使用して、シナリオを完全に削除します
  5. Logs タブで自動化の実行詳細を確認します

サービスの制限事項

  • サブアカウントごとのアクティブなワークフローは最大 15 個
  • セルフサービスによるデータ削除はできません(コンポーネント BC-INS-CIT-RT にチケットを提出してください)
  • ログの保持期間は 90 日間
  • OAuth2 証明書の有効期間は最大 1 年
  • 確定後は実行スコープを変更できません
  • 自動化タスクですでに使用されている宛先は変更できません
  • 対応ブラウザー:Google Chrome、Microsoft Edge(Chromium)、Mozilla Firefox、Apple Safari(macOS)

セキュリティアーキテクチャ

CIAS は、次の 6 つのコアコンポーネントで構成されています。

  1. Runtime:統合タスクを描画する基盤フレームワーク
  2. Planning:統合シナリオを計画するための UI
  3. Inbox:エンドユーザーがタスクにアクセスするための UI
  4. Monitoring:シナリオの実装を監視するための UI
  5. Managed System:統合時に設定されるシステム
  6. Automation Runtime:管理対象システムの設定 API を呼び出します

セキュリティ機能:

  • SAP BTP 認可フレームワークによるロールベースのアクセス制御
  • バックエンド接続呼び出しの XSRF 保護
  • ID プロバイダーとの統合(SAML アサーションの Name ID 属性に対応)
  • 認証情報は Credential Store サービスに保存されます(外部関係者はアクセスできません)

よくあるエラーパターン

宛先のドロップダウンが空

症状:タスクの実行中に宛先のドロップダウンに選択肢が表示されません。

原因:テナントの Host Base URL に一致する宛先がありません。

解決方法:

  1. 宛先の作成手順に従って、宛先を手動で作成します
  2. 宛先 URL がテナントの Host Base URL と完全に一致していることを確認します
  3. 作成後、ドロップダウンを更新します
ワークフローの競合によるロック

症状:タスクを続行できず、実行がロックされています。

原因:同一のシステムコンポーネントを持つ統合ワークフローが複数存在します。

解決方法:

  • Proceed:解決せずに続行します(後で手動で解決します)
  • Terminate:選択した競合インスタンスを終了します
  • Terminate Current Instance:アクティブなワークフローのみ停止します
  • Cancel:操作全体を中止します
IdP の変更後にアプリケーションへのアクセスが拒否される

症状:ID プロバイダーの変更後、ユーザーが CIAS アプリケーションにアクセスできません。

原因:新しく設定された ID プロバイダーでユーザーが管理されていません。

解決方法:

  1. 新しい ID プロバイダーにユーザーを追加します
  2. サブアカウントの Security 設定でロールコレクションを再割り当てします
  3. 設定済みの IdP にユーザー ID が存在することを確認します
タスクが予約済みと表示される

症状:タスクを要求できず、ステータスが「Reserved」と表示されます。

原因:割り当てられた別のユーザーが、すでにタスクを要求しています。

解決方法:チーム内で調整してください。要求済みのタスクに同時に取り組めるのは 1 人だけです。

サポート窓口

問題の種類コンポーネント対応
CIAS に関する一般的なサポートBC-INS-CIT-RTサポートチケットを作成
手動タスクの手順サポート情報タブを確認記載されているコンポーネントにインシデントを報告
データ削除リクエストBC-INS-CIT-RTメール ID とサブアカウント名を記載
サービスの可用性コンシューマーアカウントサービス可用性機能を確認

OAuth2 API アクセス

プログラムによるアクセス(ABAP の自動化に必要)の場合:

  1. サブアカウント → サービス → サービスマーケットプレイスに移動
  2. Cloud Integration Automation Service を選択 → 作成
  3. OAuth2 プランを選択
  4. ランタイムを選択:「Other」または「Cloud Foundry」
  5. インスタンス名を入力 → 作成
サービスキーの作成(API 呼び出し用)

mTLS(証明書)を使用する場合:

{
  "xsuaa": {
    "credential-type": "x509",
    "x509": {
      "key-length": 2048,
      "validity": 365,
      "validity-type": "DAYS"
    }
  }
}

証明書を使用しない場合:名前のみを指定して作成します。

生成されたクライアント ID とクライアントシークレットを使用して、API 認証用の OAuth JWT トークンを作成します。

データ保護

  • メール ID とサブアカウント名はサービスデータベースに保存されます
  • システム/テナントの選択データはワークフローの実行のために保持されます
  • ログにはユーザーに関連する個人データは保存されません
  • 監査ログは SAP BTP の監査ログ保持ポリシーに従います
  • 機密データは Credential Store サービスに保存されます

用語集

用語定義
個人データ特定または特定可能な自然人に関するあらゆる情報
機微な個人データ人種/民族的出自、政治的見解、宗教的信念、遺伝/生体データ
保管期間業務の終了から、データが引き続きアクセス可能な目的終了までの期間
保持期間最後の業務活動からデータ削除までの期間
アクセス制限主たる業務目的が終了したデータへのアクセスを制限すること

タスク UI コントロールの早見表

自動化タスクのコントロール
コントロール機能
更新自動化のステータスを更新
すべて展開すべてのパラメーターパネルを表示
すべて折りたたむすべてのパラメーターパネルを非表示
読み取り専用パラメーターの表示/非表示読み取り専用項目の表示を切り替え
パラメーターを保存現在の値を保持
ログ実行記録を表示
情報パラメーターの説明
ステップを実行自動化を実行(非同期)
エラーからの復旧

自動化が失敗した後:

  • 失敗した自動化のみ - 失敗したステップのみ再試行します
  • すべての自動化 - 一連の処理全体を再試行します

同梱リソース

参照ファイル
  1. references/setup-guide.md - サブスクリプション、OAuth2、宛先の設定手順の全容
  2. references/security-guide.md - セキュリティアーキテクチャ、ID プロバイダーの設定、ロール管理
  3. references/integration-scenarios.md - コード(1M1、22K、4A1 など)を含む、対応する 100 件以上の統合シナリオの全一覧
  4. references/troubleshooting.md - 詳細なエラー解決手順と一般的な問題
  5. references/maintenance-planner.md - Maintenance Planner の統合ガイドとワークフローの呼び出し
  6. references/task-ui-guide.md - タスク UI のコントロール、タブ、動作、自動化ステップの全容
  7. references/whats-new.md - 2021~2025 年の機能更新を含むリリースノートの全容
テンプレートファイル
  1. templates/destination-config.md - ターゲットシステムの種類別の宛先設定テンプレート
  2. templates/role-assignment.md - さまざまなシナリオに対応したロール割り当て手順とチェックリスト

Documentation Sources

Primary:

Related:

コメント