AdminTask 对象的 SpnegoTAICommands 组(不推荐使用)

要通过 wsadmin 工具配置安全性,可以使用 Jython 或 Jacl 脚本编制语言来实现。 SpnegoTAICommands 命令组中的命令和参数可用于创建和管理供“简单且受保护的 GSS-API 协商机制” (SPNEGO) 信任关联拦截器 (TAI) 使用的配置。

不推荐使用的功能部件:

WebSphere® Application Server V6.1 中引入了信任关联拦截器 (TAI) , TAI 使用 "简单且受保护的 GSS-API 协商机制" (SPNEGO) 来安全地协商和认证安全资源的 HTTP 请求。 在 WebSphere Application Server V7.0 中不推荐使用此功能。 SPNEGO Web 认证已取代该 TAI,以提供动态重新装入 SPNEGO 过滤器的功能以及对应用程序登录方法启用回退。

addSpnegoTAIProperties

addSpnegoTAIProperties 命令在应用程序服务器的简单且受保护的 GSS-API 协商机制 (SPNEGO) 信任关联拦截器 (TAI) 配置中添加属性。

目标对象

参数和返回值

-spnId
它是将使用此命令定义的一组定制属性的 SPN 标识。 如果您未指定此参数,那么将分配未使用的 SPN 标识。 (字符串,可选)
-host
指定由 SPNEGO TAI 用来建立 Kerberos 安全上下文的 SPN 中的主机名部分。 (字符串,必需)
-filter
定义由通过给定属性指定的类使用的过滤条件。 如果未指定过滤器,那么所有 HTTP 请求都要进行 SPNEGO 认证。 (字符串,可选)
-filterClass
指定 SPNEGO TAI 用于选择哪些 HTTP 请求将接受 SPNEGO 认证的 Java™ 类的名称。 如果未指定过滤器类,那么将使用缺省过滤器类 com.ibm.ws.security.spnego.HTTPHeaderFilter。 (字符串,可选)
-noSpnegoPage
指定资源的 URL,该资源包含 SPNEGO TAI 将包括在 HTTP 响应中的内容,如果(浏览器)客户机应用程序不支持 SPNEGO 认证,那么(浏览器)客户机应用程序将显示该内容。 (字符串,可选)。
如果您未指定 noSpnegoPage 属性,那么将使用缺省值:
"<html><head><title>SPNEGO authentication is not supported.</title></head>" +
"<body>SPNEGO authentication is not supported on this client.</body></html>";
-ntlmTokenPage
指定资源的 URL,该资源包含 SPNEGO TAI 将包括在 HTTP 响应中的内容,当拦截器在执行提问应答握手之后接收到的 SPNEGO 令牌包含 NT LAN 管理器 (NTLM) 令牌而不是期望的 SPNEGO 令牌时,(浏览器)客户机应用程序将显示该内容。 (字符串,可选)。
如果您未指定 ntlmTokenPage 属性,那么将使用缺省值:
"<html><head><title>An NTLM Token was received.</title></head>" + "<body>Your browser configuration 
is correct, but you have not logged into a supported Windows Domain." + "<p>Please login to the application 
using the normal login page.</html>";
-trimUserName
指定 SPNEGO TAI 是 (true) 否 (false) 要从 Kerberos 领域名前面的 @ 开始移除主体用户名的后缀。 如果此属性设置为 true,那么将移除主体用户名的后缀。 如果此属性设置为 false,那么将保留主体名称的后缀。 使用的缺省值为 true。 (字符串,可选)

示例

批处理方式示例用法:

  • 使用 Jacl:
    $AdminTask addSpnegoTAIProperties -host myhost.ibm.com -filter user-agent%=IE 6
  • 使用 Jython 字符串:
    AdminTask.addSpnegoTAIProperties ('[-host myhost.ibm.com -filter user-agent%=IE 6]')
  • 使用 Jython 列表:
    AdminTask.addSpnegoTAIProperties (['-host', 'myhost.ibm.com', '-filter', 'user-agent%=IE', '6'])

交互方式示例用法:

  • 使用 Jacl:
    $AdminTask addSpnegoTAIProperties -interactive
  • 使用 Jython 字符串:
    AdminTask.addSpnegoTAIProperties ('[-interactive]')
  • 使用 Jython 列表:
    AdminTask.addSpnegoTAIProperties ['-interactive'])

deleteSpnegoTAIProperties

deleteSpnegoTAIProperties 命令用于删除 WebSphere Application Server的简单且受保护的 GSS-API 协商机制 (SPNEGO) 信任关联拦截器 (TAI) 配置中的属性。

目标对象

参数和返回值

-spnId
将使用此命令删除的一组定制属性的 SPN 标识。 如果您未指定此参数,那么将删除所有 SPNEGO TAI 定制属性。 (字符串,可选)

示例

批处理方式示例用法:

  • 使用 Jacl:
    $AdminTask deleteSpnegoTAIProperties {-spnId 2}
  • 使用 Jython 字符串:
    AdminTask.deleteSpnegoTAIProperties ('[-spnId 2]')
  • 使用 Jython 列表:
    AdminTask.deleteSpnegoTAIProperties (['-spnId', '2'])

交互方式示例用法:

  • 使用 Jacl:
    $AdminTask deleteSpnegoTAIProperties -interactive
  • 使用 Jython 字符串:
    AdminTask.deleteSpnegoTAIProperties ('[-interactive]')
  • 使用 Jython 列表:
    AdminTask.deleteSpnegoTAIProperties ['-interactive'])

modifySpnegoTAIProperties

modifySpnegoTAIProperties 命令修改 WebSphere Application Server的简单且受保护的 GSS-API 协商机制 (SPNEGO) 信任关联拦截器 (TAI) 配置中的属性。

目标对象

参数和返回值

-spnId
将使用此命令定义的一组定制属性的 SPN 标识。 (字符串,必需)
-host
指定由 SPNEGO TAI 用来建立 Kerberos 安全上下文的 SPN 中的主机名部分。 (字符串,可选)
-filter
定义由通过给定属性指定的类使用的过滤条件。 (字符串,可选)
-filterClass
指定 SPNEGO TAI 用于选择哪些 HTTP 请求将接受 SPNEGO 认证的 Java 类的名称。 如果未指定类,那么所有 HTTP 请求都要进行 SPNEGO 认证。 (字符串,可选)
-noSpnegoPage
指定资源的 URL,该资源包含 SPNEGO TAI 将包括在 HTTP 响应中的内容,如果(浏览器)客户机应用程序不支持 SPNEGO 认证,那么(浏览器)客户机应用程序将显示该内容。 (字符串,可选)
-ntlmTokenPage
指定资源的 URL,该资源包含 SPNEGO TAI 将包括在 HTTP 响应中的内容,当拦截器在执行提问应答握手之后接收到的 SPNEGO 令牌包含 NT LAN 管理器 (NTLM) 令牌而不是期望的 SPNEGO 令牌时,(浏览器)客户机应用程序将显示该内容。 (字符串,可选)
-trimUserName
指定 SPNEGO TAI 是 (true) 否 (false) 要从 Kerberos 领域名前面的 @ 开始移除主体用户名的后缀。 如果此属性设置为 true,那么将移除主体用户名的后缀。 如果此属性设置为 false,那么将保留主体名称的后缀。 使用的缺省值为 true。 (字符串,可选)

示例

批处理方式示例用法:

  • 使用 Jacl:
    $AdminTask modifySpnegoTAIPROPERTIES -spnId 1 -filter host==myhost.company.com
  • 使用 Jython 字符串:
    AdminTask.modifySpnegoTAIPROPERTIES ('[-spnId 1 -filter host==myhost.company.com]')
  • 使用 Jython 列表:
    AdminTask.modifySpnegoTAIPROPERTIES (['-spnId', '1', '-filter', 'host==myhost.company.com'])

交互方式示例用法:

  • 使用 Jacl:
    $AdminTask modifySpnegoTAIProperties -interactive
  • 使用 Jython 字符串:
    AdminTask.modifySpnegoTAIProperties ('[-interactive]')
  • 使用 Jython 列表:
    AdminTask.modifySpnegoTAIProperties ['-interactive'])

showSpnegoTAIProperties

showSpnegoTAIProperties 命令显示 WebSphere Application Server的简单且受保护的 GSS-API 协商机制 (SPNEGO) 信任关联拦截器 (TAI) 配置中的属性。

目标对象

参数和返回值

-spnId
将使用此命令显示的一组定制属性的服务主体名称 (SPN) 标识。 如果您未指定此参数,那么将显示所有 SPNEGO TAI 定制属性。 (字符串,可选)

示例

批处理方式示例用法:

  • 使用 Jacl:
    $AdminTask showSpnegoTAIProperties -spnId 1 
  • 使用 Jython 字符串:
    AdminTask.showSpnegoTAIProperties ('[-spnId 1]')
  • 使用 Jython 列表:
    AdminTask.showSpnegoTAIProperties (['-spnId', '1'])

交互方式示例用法:

  • 使用 Jacl:
    $AdminTask showSpnegoTAIProperties -interactive
  • 使用 Jython 字符串:
    AdminTask.showSpnegoTAIProperties ('[-interactive]')
  • 使用 Jython 列表:
    AdminTask.showSpnegoTAIProperties ['-interactive'])

createKrbConfigFile

createKrbConfigFile 命令创建 Kerberos 配置文件,以便与 WebSphere Application Server的 "简单且受保护的 GSS-API 协商机制" (SPNEGO) 信任关联拦截器 (TAI) 配合使用。

目标对象

参数和返回值

-krbPath
提供 Kerberos 配置(krb5.ini 或 krb5.conf)文件的标准文件系统位置。 (字符串,必需)
-realm
提供 Kerberos 领域名称。 The value of this attribute is used by the SPNEGO TAI to form the Kerberos service principal name for each of the hosts specified with the property com.ibm.ws.security.spnego.SPN<id>.hostname (String, required)
-kdcHost
提供 Kerberos 密钥分发中心 (KDC) 的主机名。 (字符串,必需)
-kdcPort
提供 KDC 的端口号。 如果未指定值,那么缺省值为 88。 (字符串,可选)
-dns
提供用来生成标准主机名的缺省域名服务 (DNS)。 (字符串,必需)
-keytabPath
提供 Kerberos 密钥表文件的文件系统位置。 (字符串,必需)
-encryption
标识受支持的加密类型的列表,各个类型用空格分隔。 指定的值用于 default_tkt_enctypes 和 default_tgs_enctypes。 缺省加密类型 (如果未指定) 为 c4-hmac。 (字符串,可选)

示例

交互方式示例用法:

  • 使用 Jacl:
    $AdminTask createKrbConfigFile -interactive
  • 使用 Jython 字符串:
    AdminTask.createKrbConfigFile ('[-interactive]')
  • 使用 Jython 列表:
    AdminTask.createKrbConfigFile ['-interactive'])