08 · 权限配置与应用发布(从"预览能跑"到"业务用户能用"的最后一公里)

📄 [教程] Day4 Exercise 4 Part 1 Step 5(IAM 应用 + 业务目录)+ Part 2(业务角色 + 分配业务用户);总纲 PPT slide 15–16「发布APP」 🔗 [官方] 为业务用户开发授权(Developer) · 把 SAP Fiori 应用分配给 IAM 应用 · 创建服务定义与服务绑定 · RAP 权限控制

本章目标:把第 07 章做出来的库龄报表真正交给业务用户——走完"服务发布 → IAM 应用 → 业务目录 → 业务角色 → 分配用户 → 业务用户验证"五个环节,掌握每一环在哪个租户、用哪个对象、做错的后果;再补上服务侧的行级权限(CDS DCL + BDEF authorization)。

本章产出:

#

对象

类型

在哪建

作用

1

ZMATERIALAGE_UI_EXT

IAM 应用(.sia6)

开发租户 ADT

声明 App 要用的 UI 应用、服务、授权对象

2

ZBC_TEST

业务目录(.sia1)

开发租户 ADT

把 IAM 应用打包成"权限套餐"

3

ZBC_TEST_0001

目录-App 分配(.sia7)

开发租户 ADT

目录条目,单独传输

4

ZBR_TEST

业务角色

Customizing 租户 Fiori

把目录给到岗位/人

5

验证记录

—

浏览器

业务用户看到磁贴并取到数

6(可选)

DCL / BDEF 授权

.dcls.asdcls / 行为池方法

开发租户 ADT

控制能读/能改哪些行

✅ 衔接:第 07 章结束时,z_material_stock_age(custom entity)、服务定义 ZSD_MATERIAL_AGING、服务绑定 ZSB_MATERIAL_AGING(OData V2 – UI)已 Publish,BAS 应用 zmaterialage 已部署回 ABAP 仓库——包下 Fiori User Interface → Launchpad App Descriptor Items 里有应用描述项 ZMATERIALAGE_UI5R,Identity and Access Management → IAM Apps 里还有服务发布时自动生成的 IAM 应用。本章从"UI 级"那个 IAM 应用开始做。 若你跳过了 07 章的 BAS 部署,先回 07 章 §5 把应用部署回来:没有 UI 应用描述项,本章第 1 环就没有东西可挂。


1. 发布链全景:五环,一环都不能少

① ABAP 对象激活 + 服务绑定 Publish          开发 · ADT(开发租户)
        │  产出:可用的 OData 服务
        ▼
② IAM 应用(Identity and Access Management) 开发 · ADT(开发租户)
        │  挂:UI 应用描述项 ID + OData 服务 +(可选)授权对象
        ▼
③ 业务目录 Business Catalog + Publish Locally 开发 · ADT(开发租户)
        │  产出:可被角色引用的"权限套餐"
        ▼
④ 业务角色 Business Role + 授权范围            配置员 · Fiori(Customizing 租户)
        │  加目录、改 Access Categories、分配业务用户
        ▼
⑤ 业务用户登录验证                            业务/测试 · 浏览器
           产出:磁贴可见、数据可读、越权被拒

环

谁做

在哪做

对象/动作

做错的后果

①

开发

开发租户 ADT

BDEF/CDS 激活,Service Binding Publish

服务 404、Preview 打不开

②

开发

开发租户 ADT

IAM 应用:挂 UI 应用描述项 + 服务

磁贴不出现;点开 403/空白

③

开发

开发租户 ADT

业务目录 + 目录-App 分配 + Publish Locally

角色里搜不到目录

④

配置员/管理员

Customizing 租户 Fiori

业务角色:加目录、授权范围、分配用户

用户登录后什么都没有;或权限过大

⑤

业务/测试

浏览器 Fiori

用业务用户(非开发者)登录验证

权限问题留到上线后才暴露

💡 三个租户别搞混:①–③ 在开发租户(ADT 连接的那台)做,随开发传输请求走;④ 在 Customizing 租户(配置/测试租户)做,随 Customizing 传输请求走,最终进生产;⑤ 在生产/测试租户用业务用户验证。如果你们的景观只有开发+生产两个系统,第 ④ 环就在开发租户做、再传生产,逻辑不变。

门① 里对应的动作叫 Custom Catalog Extensions(02 章见过),思想一样:把扩展产物挂进业务目录——两条门的最后一步长得几乎一样。

1.1 先记住一个事实:Preview ≠ 发布

📌 SAP 官方原话(RAP 文档「应用部署」):拥有开发人员角色 SAP_BR_DEVELOPER 的人可以直接测试和预览新服务,无需创建 IAM 应用、也无需挂业务目录和业务角色;但对业务用户来说,"访问不会自动可用,必须显式提供"。

这句话解释了两件最常见的事:

  1. 你在 ADT 里点 Preview 能建单、能看报表,不代表业务用户能用——Preview 用的是你的开发者权限(系统里预置的测试目录)。

  2. 服务一旦"拉"到非开发系统,连开发者也没有这个测试便利了,必须走完本章五环。

1.2 环① 自检:服务真的发布了吗

检查

怎么看

通过标准

服务绑定已发布

ADT 打开 ZSB_MATERIAL_AGING,看状态/按钮

显示 Published,按钮变为 Unpublish

服务能响应

打开服务绑定页面显示的 Service URL(拼上 /$metadata)

返回 XML,不是 404/403

数据能出

服务绑定编辑器里 Preview 打开列表

列表有数据(库龄报表需要填关键日期)

⚠️ 本节的 ②③④ 环都建立在"服务已发布"之上。服务没发布时,后面的 IAM 应用即使做对也打开不了。

1.3 三层权限,别混成一件事

层

用什么对象控制

管什么

配错的表现

前端可见性

IAM 应用 + 业务目录 + 业务角色

能不能在 Launchpad 搜到/打开这个 App

搜不到磁贴;点开 403

读数据(行级)

CDS DCL(@AccessControl.authorizationCheck)

同一个 App 里能读哪些行

列表空、数据比预期少

改数据(行级/按钮)

BDEF authorization(global / instance)

能改/删哪些行、按钮亮不亮

保存报"未授权"、按钮灰

本章 §2–§5 做第一层,§6 做第二、三层。第一层配好只代表"能进 App",不代表"能看全部数据"——这是新人最容易混淆的地方。


2. 动手 1:建 IAM 应用(App 的"权限种子")

2.1 先弄清:IAM 应用有两类来源

IAM 应用(.sia6)不一定都要手工建——服务发布时会自动生成服务侧的 IAM 应用,但 UI 磁贴还需要一个手工建的 External App:

来源

谁生成

包里长什么样

管的是

RAP 服务发布自动生成("RAP 原生")

框架在 Service Binding Publish 时自动建

包下 Identity and Access Management → IAM Apps 出现 <服务绑定>_IWSG_IBS 一类条目(第 07 章 §5.4 已看到 ZSB_MATERIAL_AGING_IWSG_IBS)

服务侧授权:服务本身能不能被调用(API/系统间)

BAS/External UI 应用(手工建)

开发者

你自己命名、类型 External App,挂 App Descriptor ID(本章主路径)

UI 侧授权:业务用户在 Launchpad 看到磁贴并打开 UI

一句话:服务发布自动给你"服务级"IAM 应用;要让业务用户看到磁贴,还要一个"UI 级"的 External App,把 Fiori 应用描述项挂上去——两者都进业务目录、都给业务角色。

📦 [代码] 我司导出包里 97 个 IAM 应用(.sia6)的命名全是业务 App 风格(ZIAM_* / ZZC_* / ZUI_* / ZZSD###_EXT),看不到 _IWSG_IBS 这类服务自动生成条目:EXT 型 70 个、MBC 型 27 个(后者集中在配置维护类应用、见 04 章 smbc)。

2.2 建 External App 型 IAM 应用

步骤

操作

填什么

1

右键包 Z_Onlineshop → New → ABAP Repository Object

—

2

展开 Identity and Access Management → 选 IAM App → Next

—

3

Name / Description

ZMATERIALAGE_UI / Material Age

4

Application Type

External App(只能是它,别的类型挂不了 UI 应用)

5

Application ID Suffix

自动带 _EXT,不要自己再敲一遍

6

选第 07 章同一个 TR → Finish

名字最终是 ZMATERIALAGE_UI_EXT

新建 IAM 应用 (📄 Day4 脚本 Part 1 Step 5:New IAM App → Name ZMATERIALAGE_UI、Application Type External App、后缀 _EXT)

2.3 在 IAM 应用里挂三样东西

#

挂什么

在哪填

本练习的取值

不填的后果

1

UI 应用

General 区的 Fiori Launchpad App Descr Item ID

ZMATERIALAGE_UI5R

磁贴不出现

2

OData 服务

编辑器里 Services 区

服务绑定 ZSB_MATERIAL_AGING、版本 0001、类型 OData V2

磁贴点开 404/无数据

3

授权对象

编辑器里 Authorizations 页签 → Add

报表类通常不需要额外对象(服务自带 S_START 启动检查);维护类才加业务对象,如 V_VBAK_VKO

业务权限检查落空(读得到就全读得到)

填 App Descriptor ID 的操作:

步骤

操作

说明

1

回包,展开 Fiori User Interface → Launchpad App Descriptor Items

第 07 章部署出来的就是这里

2

找到 UI5 应用 zmaterialage 对应条目,双击看其 ID

规则通常是 <appId>_UI5R,本例 ZMATERIALAGE_UI5R;直接复制,别手敲

3

把 ID 粘贴进 IAM 应用的 Fiori Launchpad App Descr Item ID 字段

—

4

保存并激活(Ctrl+F3 / Ctrl+S),看 General 区 Status

变成 Published 才算过;若还是 Unpublished,点编辑器里的 Publish(按钮位置随 ADT 版本不同,以本机为准)

填 App Descriptor ID (📄 Day4 脚本 Part 1 Step 5:IAM App ZMATERIALAGE_UI_EXT 里填 App Descr Item ID,Status = Published;下方 "What's next?" 出现建目录的两个入口。截图里键入的是小写 zmaterialage_ui5r,ABAP 对象名大小写不敏感,与部署日志里的 ZMATERIALAGE_UI5R 是同一个对象)

验证:

  • App Type = External App;

  • Fiori Launchpad App Descr Item ID = ZMATERIALAGE_UI5R(与包里 UIAD 的 ID 完全一致);

  • Status = Published,Services 里能看到 ZSB_MATERIAL_AGING 0001。

❌ 反例:App Descriptor ID 填错(大小写倒无所谓,字母错一个就找不到)→ 建目录时这条 App 挂不上,或发布后磁贴点开 404。出错先回来核对这一格。


3. 动手 2:建业务目录并 Publish Locally

业务目录 = 权限套餐:把若干个 IAM 应用打包,方便角色整包引用。它由两个对象组成:目录本体(.sia1)和"目录-App 分配"(.sia7)。

3.1 建目录本体 ZBC_TEST

步骤

操作

填什么

1

在 IAM 应用页面底部 What's next? 点 Create a new Business Catalog and assign the App to it;或右键包 → New → ABAP Repository Object → 搜 Business Catalog

前者会顺手把 App 带进来,推荐

2

Project / Package

项目默认;Package 选 Z_Onlineshop

3

Name / Description

ZBC_TEST / TESTING

4

Next → Finish,选 TR

目录建好

新建业务目录 (📄 Day4 脚本 Part 1 Step 5:New Business Catalog → Name ZBC_TEST、Description TESTING)

3.2 建"目录-App 分配" ZBC_TEST_0001

目录和 App 之间是独立传输对象,所以有目录不等于 App 已挂进去:

步骤

操作

填什么

1

向导会接着弹 New Business Catalog IAM App Assignment;若没弹,右键包 → New → Other ABAP Repository Object → 搜 Business Catalog IAM App Assignment

—

2

Business Catalog / IAM App

ZBC_TEST / ZMATERIALAGE_UI_EXT(Browse 选择)

3

Name / Description

自动给 ZBC_TEST_0001 / Business Catalog to IAM App assignment(保持默认即可)

4

Next → Finish,选同一个 TR

—

建目录-App 分配 (📄 Day4 脚本 Part 1 Step 5:Business Catalog ZBC_TEST + IAM App ZMATERIALAGE_UI_EXT + 分配名 ZBC_TEST_0001)

3.3 本地发布并验证

步骤

操作

1

打开业务目录 ZBC_TEST,确认 Apps 列表里能看到 ZMATERIALAGE_UI_EXT

2

点编辑器工具栏的 Publish Locally(个别版本在右键菜单,以本机为准)

3

等状态变 Published,保存

验证:

  • 目录 Status = Published;

  • 目录下 Apps 里 ZMATERIALAGE_UI_EXT 也在,且 IAM 应用状态是 Published;

  • 反例:只建了目录没建"分配",目录里 Apps 是空的 → 角色里加了目录也没有磁贴。

💡 Publish Locally 的含义:只对当前租户生效,让 Customizing 租户/本租户的角色能搜到这个目录。跨租户/进生产靠传输请求;导入目标系统后同样确认目录状态是 Published。

3.4 命名(照我司规则起名)

环

我司命名

真实例子

IAM 应用

ZIAM_* / ZZC_* / ZUI_* / ZZSD###_EXT

zzc_query_mm018_ext.sia6.xml(ZZC_QUERY_MM018_EXT)

业务目录

ZBC_* / ZZ_BC_<模块>_<编号> / ZZ_BC_JOB_*

zz_bc_mm_018.sia1.xml(ZZ_BC_MM_018)

目录-App 分配

<目录名>_0001

zz_bc_mm_018_0001.sia7.xml


4. 动手 3:建业务角色、分配用户(Customizing 租户)

4.1 进 Customizing 租户,打开 Maintain Business Roles

步骤

操作

1

浏览器打开 Customizing 租户的 Fiori Launchpad(Day4 脚本 Part 2 就是切到这台做角色),用有管理权限的账号登录

2

搜索并打开应用 Maintain Business Roles

3

看到角色列表(截图里 139 个:系统交付的 SAP_BR_* 模板派生角色在界面上显示为 BR_*,加少量自建角色)

Maintain Business Roles (📄 Day4 脚本 Part 2:打开 Maintain Business Roles,列表页)

前置:当前用户要有维护业务角色的权限(SAP_BR_ADMINISTRATOR / SAP_BR_BPC_EXPERT 一类模板派生角色)。没有就找系统管理员开。

4.2 新建角色 ZBR_TEST

步骤

操作

填什么

1

点 New

弹 New Business Role 对话框

2

Business Role ID / Description

ZBR_TEST / Testing role for session

3

Create

进入角色详情页

新建业务角色 (📄 Day4 脚本 Part 2:Role ID ZBR_TEST、Description Testing role for session)

角色详情页有五个页签:General Role Details / Business Catalogs / IAM Apps / Launchpad Spaces / Business Users。

4.3 把业务目录加进角色

步骤

操作

1

页签 Business Catalogs (0) → 点 Add

2

搜 ZBC_TEST → 勾选 → OK

3

页签变成 Business Catalogs (1),列表显示 TESTING / ZBC_TEST

角色加目录 (📄 Day4 脚本 Part 2:Business Catalogs 页签加入 ZBC_TEST,计数变 1)

搜不到 ZBC_TEST → 回到 §3.3:目录没 Publish Locally,或传输请求没导入当前租户。

4.4 分配业务用户

步骤

操作

1

页签 Business Users (0) → 点 Add

2

按姓名 / User ID 搜索要分配的业务用户 → 勾选 → OK

3

页签变成 Business Users (1),能看到 User Name / First Name / Last Name / Business Partner / User ID

分配业务用户 (📄 Day4 脚本 Part 2:Business Users 页签加入业务用户 HONGBO.WANG,业务伙伴 9980000020)

💡 业务用户 ≠ 通信用户:业务用户是有业务伙伴(Business Partner Person)的自然人账号,用来登 Fiori;通信用户是给接口/系统用的技术账号(05 章讲)。这里加错成技术用户,登录是看不到磁贴的。

4.5 授权范围:先 Unrestricted 验证,生产必须收紧

步骤

操作

1

页签 General Role Details → 找到 Access Categories

2

三个下拉全部改成 Unrestricted:Write, Read, Value Help / Read, Value Help / Value Help

3

顶部摘要应显示:Write Access: Unrestricted、Read Access: Unrestricted、Value Help Access: Unrestricted

授权范围改 Unrestricted (📄 Day4 脚本 Part 2:General Role Details → Access Categories 全部改 Unrestricted,然后保存)

⚠️ 风险:Unrestricted 表示不做字段值限制(全公司数据可读可写)。它只适合开发/联调期"先把链路跑通";生产角色必须用角色详情页右上角的 Maintain Restrictions 按岗位限定值范围(公司代码/工厂/销售组织等),否则违反最小权限,审计过不了。

这一层放的是"值范围",IAM 应用里放的是"检查哪些授权对象",两层配合才构成完整授权——只改一边等于没配。

4.6 保存并确认授权已生成

步骤

操作

1

点 Save(角色从 Draft 落盘)

2

若提示选传输请求:用 04 章的 Export Customizing Transports 建/选一个 Customizing TR——角色要能传到生产

3

验证:右上角出现 Authorization is up-to-date;页签计数 Business Catalogs (1)、Business Users (1)

如果显示 Authorization is not up-to-date:先保存一次,等系统生成授权数据;仍不行就退出重进角色。授权数据没生成时,用户登录后是看不到任何东西的。


5. 动手 4:用业务用户验证(发布闭环)

5.1 登录并找到应用

步骤

操作

验证点

1

换一个独立浏览器窗口/无痕窗口,用刚分配的业务用户登录 Fiori Launchpad

避免沿用开发者会话的缓存

2

搜索框输入 material age 或 Material Age Report(取决于 FLP 里配的 Title)

出现搜索结果/磁贴

3

点开应用

报表页面正常渲染,不是 403/空白

4

Key Date 选 Last Day in This Year,Company Code 选 TW Company Code (6310),Plant 选 HK Plant (6210) / TW Plant (6310) → Go

列表出数:Plant / Material / Current Stock Quantity / Current Stock Value / 0-30、30-60、>60 天数量与金额

业务用户打开报表 (📄 Day4 脚本 Part 2:刷新浏览器搜索 material age 打开报表,2025-12-31 关键日期下库存账龄数据正常显示)

5.2 三条验证判据(缺一不可)

  1. 磁贴/搜索结果出现 = 第 ②③④ 环链路通(IAM 应用 → 目录 → 角色 → 用户);

  2. 点开能出数 = 服务本身可用(第 ① 环);

  3. 反测:换一个没分配这个角色的用户登录,应该搜不到磁贴、直接拼 URL 访问应被拒(403/无数据)。只做前两条、不做反测,等于没验证权限是否真的生效。

5.3 "看不到 / 打不开 / 没数据"排错表

现象

最可能的原因

怎么修

搜不到磁贴

角色没保存 / 目录没 Publish Locally / 用户没分配

回 §4 逐项核对;重新登录(不是刷新)

磁贴有,点开 403 或空白

App Descriptor ID 填错;服务没发布

回 §2.3 核对 ID;回 §1.2 检查服务状态

磁贴有,点开正常但列表空

行级权限过滤(DCL);筛选条件太窄

先确认筛选;再查 §6 的 DCL/授权值

用户能看到但列/字段缺

角色授权不完整(某些 Access Category 还是 No Access)

回 §4.5 检查三个 Access Categories

换用户后看到的数据一样(本该不同)

DCL 没写/没激活,或写法不对

见 §6.1;用两个不同权限用户对比行数

磁贴没在预期页面/分组

Launchpad Space/Page 未分配(新版 Launchpad 用 Space/Page 组织内容)

角色里加对应 Space/Page


6. 服务侧权限:DCL + BDEF authorization(单独一节)

6.1 读权限:CDS DCL(行级)

在 CDS 视图上声明 @AccessControl.authorizationCheck,再建一个 DCL(define role 定义角色、grant select on 关联视图、where 写行条件)限制能读哪些行。

注解取值

含义

什么时候用

#NOT_REQUIRED

不做 DCL 检查(能访问服务就能读全部)

纯配置、无敏感数据、练习阶段

#CHECK

有 DCL 就按 DCL 检查,没有就放行

大部分业务视图

#MANDATORY

必须有 DCL,没有则激活报错

有明确行级权限要求的视图

📦 [代码] 我司导出的 CDS 里三种写法都在用:#MANDATORY 40 处、#NOT_REQUIRED 39 处、#CHECK 29 处。新视图有行级要求就用 #CHECK/#MANDATORY。

建 DCL 的步骤:

步骤

操作

1

打开要管控的 CDS 视图,把 @AccessControl.authorizationCheck 改成 #CHECK(或 #MANDATORY)

2

右键该视图 → New → Access Control,名称与视图同名(官方建议同名,如 ZC_MATERIAL_AGING)

3

粘贴下面模板 → Ctrl+F3 激活

4

用有权限/无权限两个用户分别查(Data Preview 或报表),行数应不同

示例 A:不限行(公司里有 14 个 DCL 这么写,zr_mm018.dcls.asdcls 实物):

@EndUserText.label: 'ZR_MM018'
@MappingRole: true
define role ZR_MM018 {
  grant select on ZR_MM018
  where TRUE;
}

示例 B:按授权对象限行(公司里最常见的写法——58 个 DCL 有 29 个用 pfcg_auth;zi_config_ztfi027.dcls.asdcls 实物,把"表访问权限"塞进 DCL):

@MappingRole: true
define role ZI_config_Ztfi027 {
  grant select on ZI_config_Ztfi027
  where ( ) = ASPECT pfcg_auth ( 'S_TABU_NAM', ACTVT = '03', TABLE = 'ZI_CONFIG_ZTFI027' );
}

示例 C:投影视图继承下层条件(zc_mm018.dcls.asdcls 实物,@MappingRole: true 是能被继承的前提):

@EndUserText.label: 'ZC_MM018'
@MappingRole: true
define role ZC_MM018 {
  grant select on ZC_MM018
  where INHERITING CONDITIONS FROM ENTITY ZR_MM018;
}

示例 D:按业务字段限行(位置一一对应:左边第 N 个视图元素 ↔ 右边第 N 个授权字段,ACTVT = '03' 这类过滤条件不占位置;把 ZC_MATERIAL_AGING / CompanyCode / F_BKPF_BUK 换成你实际的对象与字段):

@EndUserText.label: '库龄报表-权限'
@MappingRole: true
define role ZC_MATERIAL_AGING
{
  grant select on ZC_MATERIAL_AGING
    where ( CompanyCode )
        = aspect pfcg_auth ( F_BKPF_BUK,
                             BUKRS,
                             ACTVT = '03' );
}

我司销售报表用的就是这套多字段写法(ZC_QUERY_SD018,销售范围三字段):where ( SalesOrganization, DistributionChannel, OrganizationDivision ) = aspect pfcg_auth ( V_VBAK_VKO, VKORG, VTWEG, SPART, ACTVT = '03' );

⚠️ 两个坑:①左边元素个数/顺序必须与右边授权字段严格对应,写错不报错,只会静默按错的维度过滤——必须用正反两个用户实测;②DCL 写在最终被服务访问的那层视图上,别指望底层视图的 DCL 自动传到上层(我司报表教程里实测踩过)。

💡 第 07 章的 z_material_stock_age 是 custom entity:取数全在 ZCL_MATERIAL_STOCK_AGE 的 if_rap_query_provider~select 里,DCL 管不到你的自定义 SELECT。这类报表的行级过滤要在 provider 里自己做(见 §6.3),或者把 DCL 建在它取数的底层标准视图上。

6.2 改权限:BDEF authorization master

04 章的 BDEF 已经写了 authorization master ( instance )。它声明"改操作要检查权限",但方法要你实现:

声明

检查时机

典型场景

authorization master ( global )

请求进后端前,只看"人"

只有某组人允许新建

authorization master ( instance )

具体实例改之前,能看实例前映像

只能改自己有权限的公司/工厂的数据

authorization dependent by _Assoc

跟随主实体的权限

行项目跟随抬头

先改 BDEF 抬头(global 与 instance 可以只声明一个,也可以两个都声明;本练习两个都要):

managed implementation in class zbp_i_online_shop unique;
strict ( 2 );

define behavior for ZI_ONLINE_SHOP alias Online_Shop
persistent table zonlineshop
lock master
authorization master ( global, instance )
{
  field ( numbering : managed, readonly ) Order_Uuid;
  field ( readonly ) Orderid, Creationdate;

  determination calculate_order_id on modify { create; }

  create;
  update;
  delete;

  mapping for zonlineshop
  {
    Order_Uuid   = order_uuid;
    Orderid      = order_id;
    Material     = material;
    Quantity     = quantity;
    Creationdate = creationdate;
    Deliverydate = deliverydate;
  }
}

把光标放到 authorization master 那行按 Ctrl+1,选生成权限方法,然后在行为池 lhc_Online_Shop 里补全(下面是可直接编译的骨架):

CLASS lhc_Online_Shop DEFINITION INHERITING FROM cl_abap_behavior_handler.
  PRIVATE SECTION.
    METHODS get_global_authorizations FOR GLOBAL AUTHORIZATION
      IMPORTING REQUEST requested_authorizations FOR Online_Shop RESULT result.

    METHODS get_instance_authorizations FOR INSTANCE AUTHORIZATION
      IMPORTING keys REQUEST requested_authorizations FOR Online_Shop RESULT result.
ENDCLASS.

CLASS lhc_Online_Shop IMPLEMENTATION.
  METHOD get_global_authorizations.
    " 全局权限:只看用户,不看数据(示例用表维护权限 S_TABU_NAM,字段 ACTVT/TABLE 固定存在)
    AUTHORITY-CHECK OBJECT 'S_TABU_NAM'
      ID 'ACTVT' FIELD '02'
      ID 'TABLE' FIELD 'ZONLINESHOP'.

    DATA(lv_granted) = COND #( WHEN sy-subrc = 0
                               THEN if_abap_behv=>auth-allowed
                               ELSE if_abap_behv=>auth-not-allowed ).

    result-%create = lv_granted.
    result-%update = lv_granted.
    result-%delete = lv_granted.
  ENDMETHOD.

  METHOD get_instance_authorizations.
    " 实例权限:先读实例前映像,再用实例字段做检查。
    " 在线商店模型没有公司代码/工厂字段,这里先用表级对象把骨架跑通;
    " 真实项目把 TABLE 换成实例里的权限字段(公司代码/工厂/销售组织)
    READ ENTITIES OF zi_online_shop IN LOCAL MODE
      ENTITY Online_Shop ALL FIELDS WITH CORRESPONDING #( keys )
      RESULT DATA(lt_orders).

    LOOP AT lt_orders INTO DATA(ls_order).
      AUTHORITY-CHECK OBJECT 'S_TABU_NAM'
        ID 'ACTVT' FIELD '02'
        ID 'TABLE' FIELD 'ZONLINESHOP'.

      APPEND VALUE #( %tky    = ls_order-%tky
                      %update = COND #( WHEN sy-subrc = 0
                                        THEN if_abap_behv=>auth-allowed
                                        ELSE if_abap_behv=>auth-not-allowed )
                      %delete = COND #( WHEN sy-subrc = 0
                                        THEN if_abap_behv=>auth-allowed
                                        ELSE if_abap_behv=>auth-not-allowed )
                    ) TO result.
    ENDLOOP.
  ENDMETHOD.
ENDCLASS.

要点:

  • 实例权限方法里必须用实例字段(公司代码 BUKRS / 工厂 WERKS / 销售组织 VKORG);本练习模型没有这些字段,所以示例用表级对象把骨架跑通,真实项目把 ID 'TABLE' 那一行换成实例字段(如 ID 'VKORG' FIELD ls_order-CompanyCode 这种形式);

  • 返回值只有三种:if_abap_behv=>auth-allowed / auth-not-allowed / auth-undefined;

  • 不要拒绝的就别声明——投影层可用 authorization: none 排除某些操作,预检查(precheck)可在数据进事务缓冲前用传入值拒绝;

  • 激活草稿时不会调用权限方法,要拦激活必须写在 validation 里。

6.3 报表里的手工行级权限(我司模式 B 的真实做法)

无代理报表(unmanaged query,第 07 章)没有 DCL 保护,我司在 provider 里手工过滤。实物 docs/顾问开发的代码--现有线上代码/sap-zzsd-master/src/zzcl_query_sd010.clas.abap(L162 附近):

LOOP AT lt_result ASSIGNING FIELD-SYMBOL(<fs_result>).
  AUTHORITY-CHECK OBJECT 'V_VBAK_VKO'
    ID 'VKORG' FIELD <fs_result>-salesorganization
    ID 'VTWEG' FIELD <fs_result>-distributionchannel
    ID 'SPART' FIELD <fs_result>-organizationdivision
    ID 'ACTVT' FIELD '03'.
  IF sy-subrc NE 0.
    DELETE lt_result.
  ENDIF.
ENDLOOP.

配套写法是取数时用 WITH PRIVILEGED ACCESS 绕过底层视图的 DCL,取回全量后在循环里按授权过滤。

⚠️ 代价:容易漏字段、性能差(全量取回再删)、每张报表都要重写一遍。新报表优先用 DCL(§6.1),只有 DCL 表达不了或必须复用老逻辑时才用这种手工模式,并且要写进代码评审检查项。


7. 我司命名与对象对照(📦 公司实践实证,照此建/照此查)

下表路径均相对 docs/顾问开发的代码--现有线上代码/。

环

对象类型

ADT/abapGit 文件

我司命名

真实例子

IAM 应用

SIA6

*.sia6.xml

ZIAM_* / ZZC_* / ZUI_* / ZZSD###_EXT

sap-zzmm-master/src/zzc_query_mm018_ext.sia6.xml

业务目录

SIA1

*.sia1.xml

ZZ_BC_* / ZBC_* / ZZ_BC_JOB_*

sap-zzmm-master/src/zz_bc_mm_018.sia1.xml

目录-App 分配

SIA7

*.sia7.xml

<目录>_0001

sap-zzmm-master/src/zz_bc_mm_018_0001.sia7.xml

Fiori 应用描述项

UIAD

*.uiad.json

<应用名>_ui5r

sap-zzmm-master/src/zzmm018_ui5r.uiad.json

服务绑定

SRVB

*.srvb.xml

ZUI_*_O4 / ZUI_*_O2

sap-zzmm-master/src/zui_mm018_o4.srvb.xml(PUBLISHED=true、契约 C1)

服务授权清单

SUSH

*.sush.xml

系统生成(hash 名)

sap-zzmm-master/src/45cbed60ad8cf7f88f84ce93792d28ht.sush.xml(DISPLAY_NAME = R3TR G4BA ZUI_MM018_O4)

DCL

DCLS

*.dcls.asdcls

ZR_* / ZC_* 同名

sap-zzmm-master/src/zr_mm018.dcls.asdcls(where TRUE)

业务角色

—

不在 abapGit 导出里

ZBR_*

在 Customizing 租户维护、随 Customizing TR 传生产

一个完整发布链的实物(采购申请批导 ZZC_QUERY_MM018_EXT):

环节

文件

关键内容

服务绑定

zui_mm018_o4.srvb.xml

BIND_TYPE=ODATA、V4、CONTRACT=C1、PUBLISHED=true

授权清单

45cbed60ad8cf7f88f84ce93792d28ht.sush.xml

指向服务绑定 ZUI_MM018_O4,记录 S_START 等授权对象(系统生成,别手改)

IAM 应用

zzc_query_mm018_ext.sia6.xml

APP_TYPE=EXT、UI_APP_ID=ZZMM018_UI5R、服务 ZUI_MM018_O4、PUBLISH_STATUS=p

应用描述项

zzmm018_ui5r.uiad.json

语义对象 zzmm018、动作 display、磁贴标题「采购申请批导」

业务目录

zz_bc_mm_018.sia1.xml

BU_CATALOG_ID=ZZ_BC_MM_018,内容 ZZC_QUERY_MM018_EXT

目录-App 分配

zz_bc_mm_018_0001.sia7.xml

把上面两者连起来

DCL

zr_mm018.dcls.asdcls / zc_mm018.dcls.asdcls

根视图 where TRUE;投影视图 INHERITING CONDITIONS

📦 [代码] 四个包的权限对象数量(abapGit 导出统计):FI 41 个 sia6 / 33 个 sia1 / 51 个 sia7 / 51 个 sush;MM 20 / 28 / 31 / 33;PP 9 / 10 / 12 / 13;SD 27 / 28 / 39 / 41。另有 76 个 .uiad.json(BAS 部署的 UI 应用)和 58 个 .dcls.asdcls。一个中等应用全套权限对象 3~5 个,新 App 照抄同模块最新一个的全套最稳。


8. 常见坑(都是真实踩过的)

#

坑

正确做法

1

把 Preview 当成"已发布",直接丢给业务用户

Preview 走开发者权限;业务用户必须走五环(§1.1)

2

IAM 应用类型选错(不是 External App)

只有 External App 才有 Fiori Launchpad App Descr Item ID 字段可挂 UI 应用;建错删掉重建

3

App Descriptor ID 手敲错

从包里 UIAD 复制,逐字符核对

4

只建目录没建"目录-App 分配"

.sia1 和 .sia7 是两个对象(§3.2)

5

目录没 Publish Locally 就去配角色

角色里搜不到目录(§3.3)

6

角色改完没 Save / 授权没生成

顶部要显示 Authorization is up-to-date

7

测试用户用的是开发者账号

必须用业务用户(非 SAP_BR_DEVELOPER)验证

8

授权范围生产还留 Unrestricted

用 Maintain Restrictions 按岗位收紧(§4.5)

9

DCL 写了但没激活/写错层

正反两个用户对比行数验证(§6.1)

10

传输请求漏了 sia1/sia6/sia7/uiad/srvb/dcls

释放前在 TR 里逐个核对对象清单


9. 新 App 上线检查清单

  • ABAP 对象全部激活,ATC 无阻塞级错误

  • 服务定义/服务绑定已 Publish,$metadata 可访问、Preview 能出数

  • BAS UI 已部署回 ABAP 仓库,包下出现 Launchpad App Descriptor Item(.uiad)

  • IAM 应用建好:类型 External App、App Descriptor ID 正确、Status = Published、服务已挂

  • 业务目录建好 + 目录-App 分配建好 + Publish Locally,目录 Status = Published

  • 业务角色建好、目录已加、授权范围已按岗位收紧(不是 Unrestricted)、业务用户已分配

  • 用业务用户(非开发者)验证:磁贴可见 + 打开出数 + 越权反测被拒

  • 行级要求:DCL(@AccessControl.authorizationCheck + define role)已激活;BDEF authorization master 方法已实现

  • 传输请求包含全部对象(sia1/sia6/sia7/uiad/srvb/dcls);开发 → Customizing → 生产的传递路径已确认

  • 生产环境用真实业务数据跑一次正反用例(有权限 / 无权限)


➡️ 下一步