mcpField
S
sap-btp-cias

sap-btp-cias

github.com/secondsky云与 DevOps480657 次安装3 周前更新
代码仓库

关于 sap-btp-cias

面向规划和运行 SAP 云端及本地集成的 CIAS 参考 Skill,适用于相关团队。内容涵盖场景规划、任务执行、监控、角色配置、OAuth2 访问和故障排查。

主要功能

  1. 01规划引导式集成场景
  2. 02处理 My Inbox 任务
  3. 03监控工作流执行
  4. 04配置角色集合和目标
  5. 05设置 OAuth2 API 访问
  6. 06排查任务与工作流问题

适用场景

  1. 01规划 SAP 系统间集成
  2. 02完成分配的配置任务
  3. 03查看工作流状态和日志
  4. 04启用 CIAS 程序化访问

安装

复制下面的命令,在终端中运行。

$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 访问的身份提供商和信任关系

何时使用此技能

在订阅 CIAS、分配 CIAS 角色集合、规划引导式集成场景、处理 My Inbox 任务、监控场景执行、配置 OAuth2 API 访问,或排查 CIAS 工作流/任务故障时,请使用此技能。

目录

快速参考

服务计划
计划类型用途
Standard应用程序用于场景规划、任务监控和集成管理的 UI 访问
OAuth2服务用于程序化操作的 API 访问(ABAP 自动化所必需)
角色集合
角色集合功能
Integration AdministratorCIASIntegrationAdministrator完全访问权限:Plan for Integration、My Inbox、Monitoring;终止场景
Integration ExpertCIASIntegrationExpert访问 My Inbox;处理分配的任务
Integration MonitorCIASIntegrationMonitor只读访问 Scenario 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 分配给多个用户。

3. 规划集成场景
  1. 从 Instances and Subscriptions 访问 CIAS 应用程序
  2. 打开 Plan for Integration 磁贴
  3. 在 Solutions 选项卡中浏览可用解决方案
  4. 选择场景和场景选项
  5. 选择要集成的系统(按客户编号)
  6. 指定:
    • 工作流的目标子账户
    • SAP BTP Workflow Users(必须拥有子账户访问权限)
    • 用于监控的事务名称
  7. 确认生成工作流
  8. 在 My Inbox 磁贴中访问任务
4. 使用任务(我的收件箱)
  1. 打开我的收件箱磁贴(需要管理员或专家角色)
  2. 点击认领,将任务锁定给你的用户
  3. 按照任务说明选项卡中的指示操作
  4. 对于自动化任务:配置参数 → 点击执行步骤
  5. 完成后点击任务已完成
  6. 点击刷新以显示下一个任务
  7. 重复操作,直到查看执行摘要
5. 为自动化创建目标
  1. 在我的收件箱中 → 确认系统组件任务
  2. 点击创建目标链接
  3. 配置:
    • 名称:有效标识符
    • 描述:用途说明
    • URL:目标系统主机 URL
    • 身份验证:方法 + 凭据
    • 类型:HTTP(默认)
  4. 保存配置

请始终使用 HTTPS 进行安全通信。

6. 监控场景执行
  1. 打开场景执行监控磁贴(需要管理员或监控员角色)
  2. 按状态筛选工作流:运行中、已完成、已取消
  3. 查看选项卡:任务详情、目标、角色和用户、范围、支持信息
  4. 使用终止执行永久移除场景
  5. 访问日志选项卡,查看自动化执行详情

服务限制

  • 每个子账户最多 15 个活动工作流
  • 不支持自助删除数据(请向组件 BC-INS-CIT-RT 提交工单)
  • 日志保留 90 天
  • OAuth2 证书最长有效期:1 年
  • 确认后无法更改执行范围
  • 如果目标已用于自动化任务,则无法更改
  • 支持的浏览器:Google Chrome、Microsoft Edge(Chromium)、Mozilla Firefox、Apple Safari(macOS)

安全架构

CIAS 包含六个核心组件:

  1. 运行时:用于呈现集成任务的骨干框架
  2. 规划:用于规划集成场景的 UI
  3. 收件箱:供最终用户访问任务的 UI
  4. 监控:用于监控场景实施的 UI
  5. 托管系统:集成期间配置的系统
  6. 自动化运行时:调用托管系统的配置 API

安全功能:

  • 通过 SAP BTP 授权框架实现基于角色的访问
  • 后端连接调用的 XSRF 保护
  • 身份提供程序集成(支持 SAML 断言 Name ID 属性)
  • 凭据存储在凭据存储服务中(外部方无法访问)

常见错误模式

目标下拉列表为空

症状:任务执行期间,目标下拉列表中没有选项。

原因:不存在与租户的 Host Base URL 匹配的目标。

解决方案:

  1. 按照创建目标步骤手动创建目标
  2. 确保目标 URL 与租户的 Host Base URL 完全匹配
  3. 创建后刷新下拉列表
工作流冲突锁定

症状:无法继续任务;执行锁已激活。

原因:存在多个系统组件相同的集成工作流。

解决方案:

  • 继续:继续操作,不解决冲突(稍后手动解决)
  • 终止:结束选定的冲突实例
  • 终止当前实例:仅停止活动工作流
  • 取消:完全停止操作
更改 IdP 后无法访问应用程序

症状:更改身份提供程序后,用户无法访问 CIAS 应用程序。

原因:新配置的身份提供程序未管理这些用户。

解决方案:

  1. 将用户添加到新的身份提供程序
  2. 在子账户的安全设置中重新分配角色集合
  3. 确认配置的 IdP 中存在用户 ID
任务标记为已预留

症状:无法认领任务;状态显示为“已预留”。

原因:另一位已分配的用户已经认领该任务。

解决方案:与团队协调;同一时间只能有一位用户处理已认领的任务。

支持渠道

问题类型组件操作
一般 CIAS 支持BC-INS-CIT-RT创建支持工单
手动任务说明查看 Support Information 选项卡向列出的组件提交事件
数据删除请求BC-INS-CIT-RT提供电子邮件 ID 和子账户名称
服务可用性消费者账户查看 Service Availability 功能

OAuth2 API 访问

如需以编程方式访问(ABAP 自动化所需):

  1. 导航到子账户 → Services → Service Marketplace
  2. 选择 Cloud Integration Automation Service → Create
  3. 选择 OAuth2 计划
  4. 选择运行时:“Other”或“Cloud Foundry”
  5. 提供实例名称 → 创建
创建服务密钥(用于 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 控件速查

自动化任务控件
控件功能
刷新更新自动化状态
全部展开显示所有参数面板
全部折叠隐藏所有参数面板
显示/隐藏只读参数切换只读参数的可见性
保存参数保留当前值
日志查看执行记录
信息参数说明
执行步骤运行自动化(异步)
错误恢复

自动化失败后:

  • 仅失败的自动化 - 仅重试失败的步骤
  • 所有自动化 - 重试整个序列

捆绑资源

参考文件
  1. references/setup-guide.md - 完整的订阅、OAuth2 和目标配置流程
  2. references/security-guide.md - 安全架构、身份提供方配置和角色管理
  3. references/integration-scenarios.md - 支持的 100 多种集成场景完整列表及其代码(1M1、22K、4A1 等)
  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:

评论

支持 Markdown