sap-btp-cias について
SAP のクラウドおよびオンプレミス連携を計画・運用するチーム向けの、CIAS リファレンススキルです。シナリオ計画、タスク実行、監視、ロール設定、OAuth2 アクセス、トラブルシューティングを解説します。
主な機能
- 01ガイド付き連携シナリオの計画
- 02My Inbox タスクの処理
- 03ワークフロー実行の監視
- 04ロールコレクションと宛先の設定
- 05OAuth2 API アクセスの設定
- 06タスクとワークフローの問題調査
活用シーン
- 01SAP システム間連携の計画
- 02割り当てられた設定タスクの完了
- 03ワークフロー状態とログの確認
- 04CIAS のプログラムアクセス有効化
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ secondsky/ sap-skills --skill sap-btp-ciasインストール後、Claude Code で/sap-btp-ciasを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
README.mdagents/openai.yamlreferences/integration-scenarios.mdmaintenance-planner.mdsecurity-guide.mdsetup-guide.mdtask-ui-guide.mdtroubleshooting.mdwhats-new.mdtemplates/destination-config.mdrole-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 ワークフロー/タスクの失敗のトラブルシューティングを行う場合に、このスキルを使用します。
目次
- クイックリファレンス
- 主要なワークフロー
- サービスの制限事項
- セキュリティアーキテクチャ
- 一般的なエラーパターン
- サポート窓口
- OAuth2 API アクセス
- データ保護
- 用語集
- タスク UI コントロールのクイックリファレンス
- 同梱リソース
- ドキュメントの参照元
クイックリファレンス
サービスプラン
| プラン | 種類 | 目的 |
|---|---|---|
| Standard | アプリケーション | シナリオ計画、タスクの監視、統合管理のための UI アクセス |
| OAuth2 | サービス | プログラムによる操作のための API アクセス(ABAP の自動化に必要) |
ロールコレクション
| ロール | コレクション | 機能 |
|---|---|---|
| Integration Administrator | CIASIntegrationAdministrator | フルアクセス:Plan for Integration、My Inbox、Monitoring。シナリオの終了 |
| Integration Expert | CIASIntegrationExpert | My Inbox へのアクセス。割り当てられたタスクの作業 |
| Integration Monitor | CIASIntegrationMonitor | Scenario Execution Monitoring への読み取り専用アクセス |
対応リージョン
AWS:EU10(フランクフルト)、EU11(フランクフルト EU Access)、US10(バージニア)、AP10(シドニー)、JP10(東京)、CA10(モントリオール)
Azure:EU20(オランダ)、CN20(中国北部 3)
Alibaba:CN40(上海)
主要なワークフロー
1. CIAS にサブスクライブする(Standard プラン)
- SAP BTP Cockpit → Global Account → Subaccount に移動します
- Services → Service Marketplace を開きます
- 「Cloud Integration Automation Service」で絞り込みます
- タイルをクリックし、Create → Standard プランを選択します
- 作成を確定します
- Instances and Subscriptions → 「Go to Application」アイコンからアクセスします
2. ユーザーにロールを割り当てる
- サブアカウントで Security → Role Collections に移動します
- ロールコレクション(例:
CIASIntegrationAdministrator)を選択します - Edit → Users タブをクリックします
- メール ID またはログインユーザー ID でユーザーを追加します
- 変更を保存します
カンマ区切りのユーザー ID を指定して、1 つのロールに複数のユーザーを割り当てることができます。
3. 統合シナリオを計画する
- Instances and Subscriptions から CIAS アプリケーションにアクセスします
- Plan for Integration タイルを開きます
- Solutions タブで利用可能なソリューションを参照します
- シナリオとシナリオオプションを選択します
- 統合するシステムを選択します(顧客番号で指定)
- 以下を指定します:
- ワークフローのターゲットサブアカウント
- SAP BTP Workflow Users(サブアカウントへのアクセス権が必要です)
- 監視用のトランザクション名
- ワークフローの生成を確定します
- My Inbox タイルでタスクにアクセスします
4. タスクに取り組む(My Inbox)
- My Inbox タイルを開きます(Administrator または Expert ロールが必要です)
- Claim をクリックして、タスクを自分のユーザー用にロックします
- Task Instructions タブの指示に従います
- 自動化タスクの場合:パラメーターを設定 → Execute Step をクリックします
- 完了したら Task Completed をクリックします
- Refresh をクリックして次のタスクを表示します
- Execution Summary が表示されるまで繰り返します
5. 自動化用の宛先を作成する
- My Inbox → Confirm System Components タスクを開きます
- Create Destination リンクをクリックします
- 次の項目を設定します:
- Name:有効な識別子
- Description:目的の説明
- URL:対象システムのホスト URL
- Authentication:方式と認証情報
- Type:HTTP(デフォルト)
- 設定を保存します
セキュアな通信のため、常に HTTPS を使用してください。
6. シナリオの実行を監視する
- Scenario Execution Monitoring タイルを開きます(Administrator または Monitor ロールが必要です)
- ステータス(Running、Completed、Canceled)でワークフローを絞り込みます
- タブを表示します:Task Details、Targets、Roles and Users、Scope、Support Information
- Terminate Execution を使用して、シナリオを完全に削除します
- Logs タブで自動化の実行詳細を確認します
サービスの制限事項
- サブアカウントごとのアクティブなワークフローは最大 15 個
- セルフサービスによるデータ削除はできません(コンポーネント
BC-INS-CIT-RTにチケットを提出してください) - ログの保持期間は 90 日間
- OAuth2 証明書の有効期間は最大 1 年
- 確定後は実行スコープを変更できません
- 自動化タスクですでに使用されている宛先は変更できません
- 対応ブラウザー:Google Chrome、Microsoft Edge(Chromium)、Mozilla Firefox、Apple Safari(macOS)
セキュリティアーキテクチャ
CIAS は、次の 6 つのコアコンポーネントで構成されています。
- Runtime:統合タスクを描画する基盤フレームワーク
- Planning:統合シナリオを計画するための UI
- Inbox:エンドユーザーがタスクにアクセスするための UI
- Monitoring:シナリオの実装を監視するための UI
- Managed System:統合時に設定されるシステム
- Automation Runtime:管理対象システムの設定 API を呼び出します
セキュリティ機能:
- SAP BTP 認可フレームワークによるロールベースのアクセス制御
- バックエンド接続呼び出しの XSRF 保護
- ID プロバイダーとの統合(SAML アサーションの Name ID 属性に対応)
- 認証情報は Credential Store サービスに保存されます(外部関係者はアクセスできません)
よくあるエラーパターン
宛先のドロップダウンが空
症状:タスクの実行中に宛先のドロップダウンに選択肢が表示されません。
原因:テナントの Host Base URL に一致する宛先がありません。
解決方法:
- 宛先の作成手順に従って、宛先を手動で作成します
- 宛先 URL がテナントの Host Base URL と完全に一致していることを確認します
- 作成後、ドロップダウンを更新します
ワークフローの競合によるロック
症状:タスクを続行できず、実行がロックされています。
原因:同一のシステムコンポーネントを持つ統合ワークフローが複数存在します。
解決方法:
- Proceed:解決せずに続行します(後で手動で解決します)
- Terminate:選択した競合インスタンスを終了します
- Terminate Current Instance:アクティブなワークフローのみ停止します
- Cancel:操作全体を中止します
IdP の変更後にアプリケーションへのアクセスが拒否される
症状:ID プロバイダーの変更後、ユーザーが CIAS アプリケーションにアクセスできません。
原因:新しく設定された ID プロバイダーでユーザーが管理されていません。
解決方法:
- 新しい ID プロバイダーにユーザーを追加します
- サブアカウントの Security 設定でロールコレクションを再割り当てします
- 設定済みの IdP にユーザー ID が存在することを確認します
タスクが予約済みと表示される
症状:タスクを要求できず、ステータスが「Reserved」と表示されます。
原因:割り当てられた別のユーザーが、すでにタスクを要求しています。
解決方法:チーム内で調整してください。要求済みのタスクに同時に取り組めるのは 1 人だけです。
サポート窓口
| 問題の種類 | コンポーネント | 対応 |
|---|---|---|
| CIAS に関する一般的なサポート | BC-INS-CIT-RT | サポートチケットを作成 |
| 手動タスクの手順 | サポート情報タブを確認 | 記載されているコンポーネントにインシデントを報告 |
| データ削除リクエスト | BC-INS-CIT-RT | メール ID とサブアカウント名を記載 |
| サービスの可用性 | コンシューマーアカウント | サービス可用性機能を確認 |
OAuth2 API アクセス
プログラムによるアクセス(ABAP の自動化に必要)の場合:
- サブアカウント → サービス → サービスマーケットプレイスに移動
- Cloud Integration Automation Service を選択 → 作成
- OAuth2 プランを選択
- ランタイムを選択:「Other」または「Cloud Foundry」
- インスタンス名を入力 → 作成
サービスキーの作成(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 コントロールの早見表
自動化タスクのコントロール
| コントロール | 機能 |
|---|---|
| 更新 | 自動化のステータスを更新 |
| すべて展開 | すべてのパラメーターパネルを表示 |
| すべて折りたたむ | すべてのパラメーターパネルを非表示 |
| 読み取り専用パラメーターの表示/非表示 | 読み取り専用項目の表示を切り替え |
| パラメーターを保存 | 現在の値を保持 |
| ログ | 実行記録を表示 |
| 情報 | パラメーターの説明 |
| ステップを実行 | 自動化を実行(非同期) |
エラーからの復旧
自動化が失敗した後:
- 失敗した自動化のみ - 失敗したステップのみ再試行します
- すべての自動化 - 一連の処理全体を再試行します
同梱リソース
参照ファイル
references/setup-guide.md- サブスクリプション、OAuth2、宛先の設定手順の全容references/security-guide.md- セキュリティアーキテクチャ、ID プロバイダーの設定、ロール管理references/integration-scenarios.md- コード(1M1、22K、4A1 など)を含む、対応する 100 件以上の統合シナリオの全一覧references/troubleshooting.md- 詳細なエラー解決手順と一般的な問題references/maintenance-planner.md- Maintenance Planner の統合ガイドとワークフローの呼び出しreferences/task-ui-guide.md- タスク UI のコントロール、タブ、動作、自動化ステップの全容references/whats-new.md- 2021~2025 年の機能更新を含むリリースノートの全容
テンプレートファイル
templates/destination-config.md- ターゲットシステムの種類別の宛先設定テンプレートtemplates/role-assignment.md- さまざまなシナリオに対応したロール割り当て手順とチェックリスト
Documentation Sources
Primary:
- GitHub: https://github.com/SAP-docs/btp-cloud-integration-automation-service/tree/main/docs
- SAP Help Portal: https://help.sap.com/docs/cloud-integration-automation-service
Related:
- Maintenance Planner: https://maintenanceplanner.cfapps.eu10.hana.ondemand.com
- Credential Store: https://help.sap.com/viewer/601525c6e5604e4192451d5e7328fa3c/Cloud/en-US/02e8f7d1016740b8adf68690f36df142.html
- SAP BTP Destinations: https://help.sap.com/docs/btp/sap-business-technology-platform/destination