• 产品与解决方案
  • 行业解决方案
  • 服务
  • 支持
  • 合作伙伴
  • 关于我们

07-零信任命令参考

目录

02-SDP零信任命令

本章节下载 02-SDP零信任命令  (280.88 KB)

02-SDP零信任命令


1 SDP零信任

本功能的支持情况与设备型号有关,请以设备实际情况为准。

系列

型号

说明

F5000系列

F5000-AI-160-G、F5000-AI-130-G、F5000-AI-120-G、F5000-AI-110-G、F5000-AI-55-G、F5000-AI-15-G、F5000-A-G、F5000-CN160-G、F5000-E-G、F5000-E-G2、F5000-M-G2、F5000-S-G

支持

F5000-AI160、F5000-CN160、F5000-CN-G55、F5080、F5030

支持

F1000系列

F1000-AK9130

不支持

F1000-AI-90、F1000-AI-25、F1000-AI-90-G、F1000-AI-80-G、F1000-AI-75-G、F1000-AI-65-G、F1000-AI-55-G、F1000-AI-03-E

支持

插卡

LSEM1FWESD0

支持

 

说明

vSystem支持本特性的所有功能。有关vSystem的详细介绍请参见“虚拟化技术配置指导”中的“vSystem”。

 

1.1  SDP零信任配置命令

1.1.1  display trusted-access controller sdp assigned-resource

display trusted-access controller sdp assigned-resource命令用来显示SDP控制器下发给用户的内网资源。

【命令】

display trusted-access controller sdp assigned-resource { api | app } [ context context-name ]

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

context-admin

context-operator

vsys-admin

vsys-operator

【参数】

api:显示SDP控制器下发给用户的API资源。

app:显示SDP控制器下发给用户的APP资源。

context context-name:显示指定SDP访问实例对应的APP或API资源。context-name表示SDP访问实例名称,为1~31个字符的字符串,只能包含字母、数字、下划线,不区分大小写。如果不指定本参数,则显示所有SDP访问实例对应的APP或API资源。

【举例】

# 显示SDP控制器下发给用户的APP资源。

<Sysname> display trusted-access controller sdp assigned-resource app

Total Apps             : 2

 

Context                : default

Apps                   : 2

App ID                 : 1

App Name               : udp

AccessType             : ip-tunnel

Address                : Protocol    : ALL

                         IPv4Address : 15.0.0.2

                         Port        : 1-65535

 

App ID                 : 13

App Name               : udpv6

AccessType             : ip-tunnel

Address                : Protocol    : ALL

                         IPv6Address : 88::93

                         Port        : 9090

Address                : Protocol    : ICMP

IPv4Address : 4.1.1.1-4.1.1.10

Address                : Protocol    : ICMP

IPv6Address : 66::77-66::88

表1-1 display trusted-access controller sdp assigned-resource app命令显示信息描述表

字段

描述

Total Apps

SDP控制器下发给SDP网关的APP总数

Context

SDP用户所属的SDP访问实例,SDP访问实例的名称必须配置为default

Apps

SDP访问实例下的APP总数

App ID

SDP控制器下发给用户的APP ID

App Name

SDP控制器下发给用户的APP名称

AccessType

APP支持的访问方式,取值包括:

·     ip-tunnel:IP接入方式

·     web-access:Web接入方式

·     tcp-access:TCP接入方式

HostName

APP的主机名

Gateway Port

应用服务器对应的SDP网关端口号,仅在TCP代理类型应用中显示本字段

Identity Location

用户Token在TCP应用客户端向SDP网关发送的请求报文中的位置,取值范围为1~65535,取值表示从第几个位开始表示用户信息,仅在TCP代理类型应用中显示本字段

Address

APP的地址,可以显示一个或多个

Protocol

APP所属的协议,取值包括:

·     TCP:TCP协议

·     UDP:UDP协议

·     HTTP:HTTP协议

·     HTTPS:HTTPS协议

·     ALL:TCP协议、UDP协议和ICMP协议

·     ICMP:ICMP协议

IPv4Address

APP的IPv4地址

IPv6Address

APP的IPv6地址

Port

APP的端口号,如果是ICMP协议,则不显示端口

 

# 显示SDP控制器下发给用户的API资源。

<Sysname> display trusted-access controller sdp assigned-resource api

Total APIs             : 2

 

Context                : default

APIs                   : 2

API ID                 : 4

API Name               : ui1

URL                    : /ui1

App ID                 : 7

 

API ID                 : 5

API Name               : ui2

URL                    : /ui2

App ID                 : 7

表1-2 display trusted-access controller sdp assigned-resource api命令显示信息描述表

字段

描述

Total APIs

SDP控制器下发给SDP网关的API总数

Context

SDP用户所属的SDP访问实例,SDP访问实例的名称必须配置为default

APIs

SDP访问实例下的API总数

API ID

SDP控制器下发给用户的API ID

API Name

SDP控制器下发给用户的API名称

URL

URL后缀

App ID

API所属的App ID

 

1.1.2  display trusted-access controller sdp default-policy

display trusted-access controller sdp default-policy用来显示SDP控制器下发给网关的默认策略。

【命令】

display trusted-access controller sdp default-policy

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

context-admin

context-operator

vsys-admin

vsys-operator

【举例】

# 显示SDP控制器下发给网关的默认策略。

<Sysname> display trusted-access controller sdp default-policy

App default policy: Deny

API default policy: Permit

表1-3 display trusted-access controller sdp default-policy命令显示信息描述表

字段

描述

App default policy

SDP控制器下发给网关的APP的默认策略,取值包括:

·     Permit:通过

·     Deny:拒绝

API default policy

SDP控制器下发给网关的API的默认策略,取值包括:

·     Permit:通过

·     Deny:拒绝

 

1.1.3  display trusted-access controller sdp ip-tunnel route

display trusted-access controller sdp ip-tunnel route命令用来显示SDP控制器下发给网关的内网隧道路由。

【命令】

display trusted-access controller sdp ip-tunnel route

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

context-admin

context-operator

vsys-admin

vsys-operator

【举例】

# 显示SDP控制器下发给网关的内网隧道路由。

<Sysname> display trusted-access controller sdp ip-tunnel route

State:Enabled

IPv4 route:

IPv4 address               Mask length

12.1.0.0                   16

13.1.1.0                   24

IPv6 route:

IPv6 address               Prefix length

2002::0                    16

表1-4 display trusted-access controller sdp ip-tunnel route命令显示信息描述表

字段

描述

State

SDP控制器下发给网关的指定路由状态,取值包括:

·     Enabled:开启指定路由

·     Disabled:关闭指定路由

IPv4 route

SDP控制器下发给网关的IPv4路由表项

IPv4 address

指定的IPv4路由地址

Mask length

指定IPv4路由地址的掩码长度

IPv6 route

SDP控制器下发给网关的IPv6路由表项

IPv6 address

指定的IPv6路由地址

Prefix length

指定IPv6路由地址的前缀长度

 

1.1.4  display trusted-access controller sdp mode transparent

display trusted-access controller sdp mode transparent命令用来显示SDP控制器下发的透明模式信息。

【命令】

display trusted-access controller sdp mode transparent

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

context-admin

context-operator

vsys-admin

vsys-operator

【举例】

# 显示SDP控制器下发的透明模式信息。

<Sysname> display trusted-access controller sdp mode transparent

Transparent mode    : Enabled

Heartbeat port      : 2002

Heartbeat interval  : 10 min

表1-5 display trusted-access controller sdp mode命令显示信息描述表

字段

描述

Mode

SDP控制器下发的透明模式开启状态,取值包括:

·     Disabled:透明模式已关闭

·     Enabled:透明模式已开启

透明模式仅适用于内网零信任场景

Heartbeat port

心跳报文的端口号,仅在透明模式下才会显示该字段

Heartbeat interval

心跳报文的发送时间间隔,单位为分钟,仅在透明模式下才会显示该字段

 

1.1.5  display trusted-access controller sdp session

display trusted-access controller sdp session命令用来显示SDP会话信息。

【命令】

display trusted-access controller sdp session [ context context-name ] [ user user-name ] [ transparent ]

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

context-admin

context-operator

vsys-admin

vsys-operator

【参数】

context context-name:显示指定SDP访问实例下的SDP会话的详细信息。context-name表示SDP访问实例名称,为1~31个字符的字符串,只能包含字母、数字、下划线,不区分大小写。如果不指定本参数,则显示所有SDP访问实例下的SDP会话的详细信息。

user user-name:显示指定或所有SDP访问实例下指定SDP用户对应的SDP会话的详细信息。user-name表示SDP用户名称,为1~63个字符的字符串,不区分大小写。如果不指定本参数,则显示指定或所有SDP访问实例下所有SDP用户的SDP会话的详细信息。

transparent:显示指定或所有SDP访问实例下指定或所有SDP用户对应的SDP会话的透明模式相关信息。如果不指定本参数,则显示指定或所有SDP访问实例下指定或所有SDP用户的SDP会话的详细信息。

【举例】

# 显示所有SDP用户对应的SDP会话的详细信息。

<Sysname> display trusted-access controller sdp session

Total users: 1

 

User                  : z1

Context               : default

Created at            : 09:46:10 Beijing Wed 03/26/2025

Lastest               : 09:46:10 Beijing Wed 03/26/2025

Allocated IPv4        : 10.1.0.2

Allocated IPv6        : 3001::3

Session ID            : 1

Send rate             : 0.00 B/s

Receive rate          : 0.00 B/s

Sent bytes            : 0.00 B

Received bytes        : 0.00 B

Mode                  : Tunnel

Apps                  : 01_01_V4/permit;

                        3/permit;

                        5/permit;

                        testweb/permit

 

# 显示SDP用户user1对应的SDP会话的详细信息。

<Sysname> display trusted-access controller sdp session user user1

User                   : user1

Context                : default

Created at             : 13:49:27 UTC Wed 04/14/2021

Latest                 : 17:50:58 UTC Wed 04/14/2021

Allocated IPv4         : 2.2.2.1

Allocated IPv6         : 3001::C34C

Session ID             : 1

Send rate              : 0.00 B/s

Receive rate           : 0.00 B/s

Sent bytes             : 0.00 B

Received bytes         : 0.00 B

Mode                   : Tunnel

Apps                   : app1/permit;

# 显示SDP用户对应的SDP会话的透明模式相关信息。

<Sysname> display trusted-access controller sdp session transparent

User                   : user1

Context                : default

Session ID             : 1

Source IPv4 address    : 192.0.2.1,192.67.1.1

Source IPv6 address    : 12::12

表1-6 display trusted-access controller sdp session命令显示信息描述表

字段

描述

Total users

SDP用户总数

User

SDP用户的登录名

Context

SDP用户所属的SDP访问实例,SDP访问实例的名称必须配置为default

Created at

SDP会话的创建时间

Latest

用户最近一次访问时间

Allocated IPv4

iNode客户端分配到的IPv4地址。对于通过iNode客户端登录的用户,会显示该字段信息

Allocated IPv6

iNode客户端分配到的IPv6地址。对于通过iNode客户端登录的用户,会显示该字段信息

Session ID

SDP会话的标识

Send rate

SDP会话的报文发送速率,单位取值包括:

·     B/s:字节/秒

·     KB/s:千字节/秒

·     MB/s:兆字节/秒

·     GB/s:吉字节/秒

·     TB/s:太字节/秒

·     PB/s:拍字节/秒

透明模式下,不显示此字段

Receive rate

SDP会话的报文接收速率,单位取值包括:

·     B/s:字节/秒

·     KB/s:千字节/秒

·     MB/s:兆字节/秒

·     GB/s:吉字节/秒

·     TB/s:太字节/秒

·     PB/s:拍字节/秒

透明模式下,不显示此字段

Sent bytes

SDP会话的报文总发送流量,单位取值包括:

·     B:字节

·     KB:千字节

·     MB:兆字节

·     GB:吉字节

·     TB:太字节

·     PB:拍字节

透明模式下,不显示此字段

Received bytes

SDP会话的报文总接收流量,单位取值包括:

·     B:字节

·     KB:千字节

·     MB:兆字节

·     GB:吉字节

·     TB:太字节

·     PB:拍字节

透明模式下,不显示此字段

Mode

SDP用户接入的模式,取值包括:

·     Transparent (client):有客户端透明模式(透明直连接入),该模式仅适用于内网零信任场景

·     Tunnel:IP隧道模式

·     Web proxy:Web代理模式

·     Transparent (no client):无客户端透明模式(透明直连接入),该模式仅适用于内网零信任场景

Apps

SDP控制器允许用户访问或拒绝用户访问的APP

APIs

SDP控制器允许用户访问或拒绝用户访问的API

Source IPv4 address

透明模式下,SDP用户的源IPv4地址

Source IPv6 address

透明模式下,SDP用户的源IPv6地址

 

1.1.6  display trusted-access controller sdp tcp-proxy-connection

display trusted-access controller sdp tcp-proxy-connection命令用来显示TCP代理类型应用的连接信息。

【命令】

display trusted-access controller sdp tcp-proxy-connection [ context context-name ] [ slot slot-number ]

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

context-admin

context-operator

vsys-admin

vsys-operator

【参数】

context context-name:显示指定SDP访问实例下的TCP代理应用连接信息。context-name 表示SDP访问实例名称,为1~31个字符的字符串,只能包含字母、数字、下划线,不区分大小写。如果不指定本参数,则显示所有SDP访问实例下的TCP代理应用连接信息。

slot slot-number:指定成员设备。slot-number为设备在IRF中的成员编号。如果不指定本参数,则表示指定Master设备。对于本产品,slot-number只能为固定取值,无论是否指定本参数,均表示整台设备。‌‌

【举例】

# 显示所有SDP访问实例下TCP代理应用的连接信息。‌‌

<Sysname> display trusted-access controller sdp tcp-proxy-connection

Slot                    : 1

Total count             : 2

Context                 : default

  User                  : user1

  Client address        : 192.0.2.1

  Client port           : 1025

  Server address        : 192.168.0.39

  Server port           : 80

  TCP connection status : Connected

 

  User                  : user2

  Client address        : 192.0.2.4

  Client port           : 56190

  Server address        : 192.168.0.50

  Server port           : 23

  TCP connection status : Connecting

表1-7 display trusted-access controller sdp tcp-proxy-connection命令显示信息描述表

字段

描述

Total count

当前SDP访问实例下SDP用户总数

Context

SDP访问实例

User

SDP用户的登录名称

Client address

SDP客户端的IP地址

Client port

SDP客户端的端口号

Server address

应用服务器的IP地址

Server port

应用服务器的端口号

TCP connection status

TCP连接状态,取值包括:

·     Connected:连接成功

·     Connecting:正在连接

 

1.1.7  sdp access-method

sdp access-method命令用来配置用户通过SDP网关访问内网资源的方式。

undo sdp access-method命令用来恢复缺省情况。

【命令】

sdp access-method { ip-tunnel | mix | web-access }

undo sdp access-method

【缺省情况】

用户通过SDP网关访问内网资源的方式为混合方式。

【视图】

SDP可信访问控制器视图

【缺省用户角色】

network-admin

context-admin

vsys-admin

【参数】

ip-tunnel:IP接入方式,该方式下用户仅能通过iNode客户端登录SDP控制器进行身份认证,认证成功后仅能通过iNode客户端访问内网资源。

mix:混合方式,该方式下用户必须首先通过iNode客户端登录SDP控制器进行身份认证,认证成功后可以通过浏览器或iNode客户端访问内网资源。

web-access:Web接入方式,该方式下用户仅能通过浏览器登录SDP控制器进行身份认证,认证成功后仅能通过浏览器访问内网资源。

【使用指导】

本功能仅在SDP可信访问控制功能处于开启状态下生效。

对于已登录的用户,若管理员通过本命令修改了访问方式,则该用户需要重新登录SDP控制进行身份认证,认证成功后才能继续访问内网资源。

多次执行本命令,最后一次执行的命令生效。

【举例】

# 配置用户访问SDP网关的访问方式为Web接入方式。

<Sysname> system-view

[Sysname] trusted-access controller sdp

[Sysname-tac-sdp] sdp access-method web-access

【相关命令】

·     sdp enable

1.1.8  sdp api-access default

sdp api-access default命令用来配置用户通过SDP网关访问内网API的缺省动作。

undo sdp api-access default命令用来恢复缺省情况。

【命令】

sdp api-access default { deny | permit }

undo sdp api-access default

【缺省情况】

用户通过SDP网关访问内网API的缺省动作为允许。

【视图】

SDP可信访问控制器视图

【缺省用户角色】

network-admin

context-admin

vsys-admin

【参数】

deny:表示用户通过SDP网关访问内网API的缺省动作为拒绝。

permit:表示用户通过SDP网关访问内网API的缺省动作为允许。

【使用指导】

若用户访问的内网API地址不在SDP控制器下发给SDP网关的API列表中,设备将使用本命令设置的缺省动作来拒绝或允许用户对内网API的访问行为。

当内网API数量巨大时,管理员可以针对特定的API进行权限管理,例如允许或拒绝用户访问某些重要的API,其他的API访问权限可以通过本命令配置缺省处理动作,而不必对每一条API都进行权限配置。

本功能仅在SDP可信访问控制功能处于开启状态下生效。

【举例】

# 配置用户通过SDP网关访问内网API的缺省动作为拒绝。

<Sysname> system-view

[Sysname] trusted-access controller sdp

[Sysname-tac-sdp] sdp api-access default deny

【相关命令】

·     sdp enable

1.1.9  sdp enable

sdp enable命令用来开启SDP功能。

undo sdp enable命令用来关闭SDP功能。

【命令】

sdp enable

undo sdp enable

【缺省情况】

SDP功能处于关闭状态。

【视图】

SDP可信访问控制器视图

【缺省用户角色】

network-admin

context-admin

vsys-admin

【使用指导】

SDP(Software Defined Perimeter,软件定义边界)功能是指设备作为SDP网关与SDP控制器联动,对访问指定APP或API的用户进行身份认证和鉴权,以实现对用户身份和访问权限的集中控制,防止非法用户访问。

SDP网关借助云平台连接功能向SDP可信访问控制器通报保活状态,由于SDP可信访问控制器设置的保活时间为30秒,为了保证SDP可信访问控制功能的正常运行,需要将设备向云平台服务器发送Keepalive报文的时间间隔(通过cloud-management keepalive命令)设置为10~29秒。关于云平台连接的详细介绍,请参见“网络管理和监控配置指导”中的“云平台连接”。

在零信任场景中SDP网关作为SSL VPN网关连接远端用户和企业内部网络。

【举例】

# 开启SDP可信访问控制功能。

<Sysname> system-view

[Sysname] trusted-access controller sdp

[Sysname-tac-sdp] sdp enable

【相关命令】

·     cloud-management keepalive

1.1.10  spa enable

spa enable命令用来开启单包认证功能。

undo spa enable命令用来关闭单包认证功能。

【命令】

spa enable

undo spa enable

【缺省情况】

单包认证功能处于关闭状态。

【视图】

SDP可信访问控制器视图

【缺省用户角色】

network-admin

context-admin

vsys-admin

【使用指导】

单包认证功能是指客户端访问SDP网关之前,必须向SDP网关发送SPA(Single Packet Authentication,单包认证)报文,SDP网关通过验证SPA报文判断客户端是否合法,若客户端合法,SDP网关将接收客户端的后续访问请求,否则SDP网关将拒绝客户端的访问请求。

本功能仅在SDP可信访问控制功能处于开启状态下生效,且仅在IP接入方式和混合方式下支持本功能。

重新使能本功能对在线用户有影响,在有用户访问资源的情况下,请不要随意重新使能本功能,可通过display trusted-access controller sdp session命令查看是否有在线用户。

本功能对TCP SPA认证和UDP SPA认证均生效。

【举例】

# 开启单包认证功能。

<Sysname> system-view

[Sysname] trusted-access controller sdp

[Sysname-tac-sdp] spa enable

【相关命令】

·     sdp enable

·     sdp access-method

·     display trusted-access controller sdp session

1.1.11  trusted-access controller sdp

trusted-access controller sdp命令用来进入SDP可信访问控制器视图。

undo trusted-access controller sdp命令用来退出SDP可信访问控制器视图。

【命令】

trusted-access controller sdp

undo trusted-access controller sdp

【缺省情况】

不存在SDP可信访问控制器视图。

【视图】

系统视图

【缺省用户角色】

network-admin

context-admin

vsys-admin

【举例】

# 进入SDP可信访问控制器视图。

<Sysname> system-view

[Sysname] trusted-access controller sdp

[Sysname-tac-sdp]

不同款型规格的资料略有差异, 详细信息请向具体销售和400咨询。H3C保留在没有任何通知或提示的情况下对资料内容进行修改的权利!

新华三官网
联系我们