关于 sap-btp-cias
面向规划和运行 SAP 云端及本地集成的 CIAS 参考 Skill,适用于相关团队。内容涵盖场景规划、任务执行、监控、角色配置、OAuth2 访问和故障排查。
主要功能
- 01规划引导式集成场景
- 02处理 My Inbox 任务
- 03监控工作流执行
- 04配置角色集合和目标
- 05设置 OAuth2 API 访问
- 06排查任务与工作流问题
适用场景
- 01规划 SAP 系统间集成
- 02完成分配的配置任务
- 03查看工作流状态和日志
- 04启用 CIAS 程序化访问
安装
复制下面的命令,在终端中运行。
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 访问的身份提供商和信任关系
何时使用此技能
在订阅 CIAS、分配 CIAS 角色集合、规划引导式集成场景、处理 My Inbox 任务、监控场景执行、配置 OAuth2 API 访问,或排查 CIAS 工作流/任务故障时,请使用此技能。
目录
快速参考
服务计划
| 计划 | 类型 | 用途 |
|---|---|---|
| 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 分配给多个用户。
3. 规划集成场景
- 从 Instances and Subscriptions 访问 CIAS 应用程序
- 打开 Plan for Integration 磁贴
- 在 Solutions 选项卡中浏览可用解决方案
- 选择场景和场景选项
- 选择要集成的系统(按客户编号)
- 指定:
- 工作流的目标子账户
- SAP BTP Workflow Users(必须拥有子账户访问权限)
- 用于监控的事务名称
- 确认生成工作流
- 在 My Inbox 磁贴中访问任务
4. 使用任务(我的收件箱)
- 打开我的收件箱磁贴(需要管理员或专家角色)
- 点击认领,将任务锁定给你的用户
- 按照任务说明选项卡中的指示操作
- 对于自动化任务:配置参数 → 点击执行步骤
- 完成后点击任务已完成
- 点击刷新以显示下一个任务
- 重复操作,直到查看执行摘要
5. 为自动化创建目标
- 在我的收件箱中 → 确认系统组件任务
- 点击创建目标链接
- 配置:
- 名称:有效标识符
- 描述:用途说明
- URL:目标系统主机 URL
- 身份验证:方法 + 凭据
- 类型:HTTP(默认)
- 保存配置
请始终使用 HTTPS 进行安全通信。
6. 监控场景执行
- 打开场景执行监控磁贴(需要管理员或监控员角色)
- 按状态筛选工作流:运行中、已完成、已取消
- 查看选项卡:任务详情、目标、角色和用户、范围、支持信息
- 使用终止执行永久移除场景
- 访问日志选项卡,查看自动化执行详情
服务限制
- 每个子账户最多 15 个活动工作流
- 不支持自助删除数据(请向组件
BC-INS-CIT-RT提交工单) - 日志保留 90 天
- OAuth2 证书最长有效期:1 年
- 确认后无法更改执行范围
- 如果目标已用于自动化任务,则无法更改
- 支持的浏览器:Google Chrome、Microsoft Edge(Chromium)、Mozilla Firefox、Apple Safari(macOS)
安全架构
CIAS 包含六个核心组件:
- 运行时:用于呈现集成任务的骨干框架
- 规划:用于规划集成场景的 UI
- 收件箱:供最终用户访问任务的 UI
- 监控:用于监控场景实施的 UI
- 托管系统:集成期间配置的系统
- 自动化运行时:调用托管系统的配置 API
安全功能:
- 通过 SAP BTP 授权框架实现基于角色的访问
- 后端连接调用的 XSRF 保护
- 身份提供程序集成(支持 SAML 断言 Name ID 属性)
- 凭据存储在凭据存储服务中(外部方无法访问)
常见错误模式
目标下拉列表为空
症状:任务执行期间,目标下拉列表中没有选项。
原因:不存在与租户的 Host Base URL 匹配的目标。
解决方案:
- 按照创建目标步骤手动创建目标
- 确保目标 URL 与租户的 Host Base URL 完全匹配
- 创建后刷新下拉列表
工作流冲突锁定
症状:无法继续任务;执行锁已激活。
原因:存在多个系统组件相同的集成工作流。
解决方案:
- 继续:继续操作,不解决冲突(稍后手动解决)
- 终止:结束选定的冲突实例
- 终止当前实例:仅停止活动工作流
- 取消:完全停止操作
更改 IdP 后无法访问应用程序
症状:更改身份提供程序后,用户无法访问 CIAS 应用程序。
原因:新配置的身份提供程序未管理这些用户。
解决方案:
- 将用户添加到新的身份提供程序
- 在子账户的安全设置中重新分配角色集合
- 确认配置的 IdP 中存在用户 ID
任务标记为已预留
症状:无法认领任务;状态显示为“已预留”。
原因:另一位已分配的用户已经认领该任务。
解决方案:与团队协调;同一时间只能有一位用户处理已认领的任务。
支持渠道
| 问题类型 | 组件 | 操作 |
|---|---|---|
| 一般 CIAS 支持 | BC-INS-CIT-RT | 创建支持工单 |
| 手动任务说明 | 查看 Support Information 选项卡 | 向列出的组件提交事件 |
| 数据删除请求 | BC-INS-CIT-RT | 提供电子邮件 ID 和子账户名称 |
| 服务可用性 | 消费者账户 | 查看 Service Availability 功能 |
OAuth2 API 访问
如需以编程方式访问(ABAP 自动化所需):
- 导航到子账户 → Services → Service Marketplace
- 选择 Cloud Integration Automation Service → Create
- 选择 OAuth2 计划
- 选择运行时:“Other”或“Cloud Foundry”
- 提供实例名称 → 创建
创建服务密钥(用于 API 调用)
使用 mTLS(证书):
{
"xsuaa": {
"credential-type": "x509",
"x509": {
"key-length": 2048,
"validity": 365,
"validity-type": "DAYS"
}
}
}
不使用证书:仅使用名称创建。
使用生成的客户端 ID 和客户端密钥创建 OAuth JWT 令牌,以进行 API 身份验证。
数据保护
- 电子邮件 ID 和子账户名称存储在服务数据库中
- 为执行工作流而保留系统/租户选择数据
- 日志不存储与用户相关的个人数据
- 审计日志遵循 SAP BTP Audit Log 保留策略
- 敏感数据存储在 Credential Store 服务中
术语表
| 术语 | 定义 |
|---|---|
| 个人数据 | 与已识别/可识别的自然人相关的任何信息 |
| 敏感个人数据 | 种族/族裔出身、政治观点、宗教信仰、遗传/生物识别数据 |
| 保留期 | 从业务结束到用途结束期间数据仍可访问的时间 |
| 保存期限 | 从最后一次业务活动到数据删除的时间 |
| 阻止访问 | 限制对主要业务用途已结束的数据的访问 |
任务 UI 控件速查
自动化任务控件
| 控件 | 功能 |
|---|---|
| 刷新 | 更新自动化状态 |
| 全部展开 | 显示所有参数面板 |
| 全部折叠 | 隐藏所有参数面板 |
| 显示/隐藏只读参数 | 切换只读参数的可见性 |
| 保存参数 | 保留当前值 |
| 日志 | 查看执行记录 |
| 信息 | 参数说明 |
| 执行步骤 | 运行自动化(异步) |
错误恢复
自动化失败后:
- 仅失败的自动化 - 仅重试失败的步骤
- 所有自动化 - 重试整个序列
捆绑资源
参考文件
references/setup-guide.md- 完整的订阅、OAuth2 和目标配置流程references/security-guide.md- 安全架构、身份提供方配置和角色管理references/integration-scenarios.md- 支持的 100 多种集成场景完整列表及其代码(1M1、22K、4A1 等)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