Sun Java System Calendar Server 6.3 管理指南

8.1 通过 Access Manager 配置 SSO

Sun Java Enterprise System 服务器(包括 Calendar Server 和 Messaging Server)可以使用 Sun Java System Access Manager (6 2003Q4 版或更高版本)实现 SSO 功能

Access Manager 可以作为 Sun Java Enterprise System 服务器的 SSO 网关。即用户登录 Access Manager 后即可访问其他 Sun Java Enterprise System 服务器,只要这些服务器已经过适当配置,支持 SSO。

Procedure在 Calendar Server 中使用 SSO

  1. 请确保已安装和配置 Access Manager 和 Directory Server。有关安装和配置这些产品的信息,参阅《Sun Java Enterprise System 5 Installation Guide for UNIX》

  2. 停止 Calendar Server 服务后,通过设置8.1 通过 Access Manager 配置 SSO中显示的参数来为 Calendar Server 配置 SSO。要使这些值生效,必须重新启动 Calendar Server 服务。


    注 –

    设置 local.calendar.sso.amnamingurl 参数时,必须使用安装了 Access Manager 软件的主机的全限定主机名。


  3. 要为 Messaging Server 配置 SSO,参阅《Sun Java System Messaging Server 6.3 Administration Guide》

  4. 用户使用他们的 Directory Server LDAP 用户名和密码登录 Access Manager。(通过其他服务器例如 Calendar Server 或 Messaging Server 登录的用户将无法使用 SSO 访问其他 Sun Java Enterprise System 服务器。)

  5. 登录后,用户就可以使用适当的 URL,通过 Communications Express 访问 Calendar Server。用户还可以访问其他 Communications Suite 服务器(例如 Messaging Server),只要这些服务器已经过适当配置,支持 SSO。

    参数 

    说明 

    local.calendar.sso.amnamingurl

    指定 Access Manager SSO 命名服务的 URL。 

    默认值为 。 

    http://AccessManager:port/amserver/namingservice

    其中,AccessManager 是 Access Manager 的全限定名port 是 Access Manager 端口号。

    local.calendar.sso.amcookiename

    指定 Access Manager SSO Cookie 的名称。 

    默认值为 "iPlanetDirectoryPro"

    local.calendar.sso.amloglevel

    指定 Access Manager SSO 的日志级别。取值范围从 1(静默)到 5(详细)。默认值为 "3"。 

    local.calendar.sso.logname

    指定 Access Manager SSO API 日志文件名。 

    默认值为:am_sso.log

    local.calendar.sso.singlesignoff

    启用 ("yes") 或禁用 ("no") 从 Calendar Server 到 Access Manager 的单点注销。 

    如果启用,用户从 Calendar Server 注销的同时也将从 Access Manager 注销,而且用户通过 Access Manager 启动的任何其他会话(例如 Messaging Server Web 邮件会话)也将终止。 

    由于 Access Manager 是验证网关,因此总是启用从 Access Manager 到 Calendar Server 单点注销。 

    默认值为 "yes"。 


    提示 –

    更改 ics.conf 文件的最佳方法是将参数和其新值添加到文件末尾。系统会读取整个文件,然后使用最后找到的参数值。


8.1.1 在 Access Manager 中使用单点登录的注意事项

本节列出了一些在 Access Manager 中使用单点登录 (Single Sign-on, SSO) 的注意事项。

以下便是这些注意事项:

8.1.2 通过通信服务器信任环技术配置 SSO

在通过通信服务器信任环技术(也就是不通过 Access Manager)配置 SSO 时,请注意以下几点:

下表介绍了通过通信服务器信任环技术启用 SSO 所需的 Calendar Server 配置参数。

表 8–1 通过通信服务器信任环技术启用 SSO 所需的 Calendar Server 参数

参数 

说明 

sso.enable

必须将此参数设置为 "1"(默认值)才能启用 SSO。设置为 0 将禁用 SSO。 

sso.appid

此参数指定特定 Calendar Server 安装的唯一应用程序 ID。每个信任的应用程序也必须有一个唯一的应用程序 ID。默认值为:"ics50"

sso.appprefix

此参数指定了用于格式化 SSO Cookie 的前缀值。所有信任的应用程序必须使用相同的值,因为 Calendar Server 只能识别带有此前缀的 SSO Cookie。默认值为:"ssogrp1"

sso.cookiedomain

此参数指定浏览器只将 Cookie 发送到指定域中的服务器。该值必须以句点 (.) 开始 

sso.singlesignoff

如果将该值设置为 "true"(默认值),那么在客户机注销时,将清除客户机上前缀值与 sso.appprefix 中配置的值相匹配的所有 SSO cookie。

sso.userdomain

此参数设置用作用户的 SSO 验证一部分的域。 

sso.appid.url = "verifyurl"

此参数设置 Calendar Server 配置的对等 SSO 主机的验证 URL 值。每个信任的对等 SSO 主机都需要一个参数。 

此参数包括以下部分:

  • 应用程序 ID (appid),标识包含可信 SSO Cookie 的每个对等 SSO 主机。

  • 验证 URL (verifyurl),包括主机 URL、主机端口号以及 VerifySSO?(包括末尾处的问号 ?)。

    在本例中,Calendar Server 应用程序 ID 是 ics50,主机 URL 是 sesta.com,端口号是 8883

    Messenger Express 应用程序 ID 是 msg50,主机 URL 是 sesta.com,端口号是 8882

例如: 

sso.ics50.url=
  "http://sesta.com:8883
  /VerifySSO?"
sso.msg50.url=
  "http://sesta.com:8882
  /VerifySSO?" 

下表介绍了通过通信服务器信任环技术启用 SSO 所需的 Messaging Server 配置参数。

表 8–2 通过通信服务器信任环技术启用 SSO 所需的 Messaging Server 参数

参数 

说明 

local.webmail.sso.enable

必须将此参数设置为非零值才能启用 SSO。 

local.webmail.sso.prefix

此参数指定在格式化 HTTP 服务器设置的 SSO Cookie 时所使用的前缀。例如:ssogrp

local.webmail.sso.id

此参数指定 Messaging Server 的唯一应用程序 ID(例如:msg50)。

每个信任的应用程序也必须有一个唯一的应用程序 ID。 

local.webmail.sso.cookiedomain

此参数指定 HTTP 服务器设置的所有 SSO Cookie 的 Cookie 域值。 

local.webmail.sso.singlesignoff

如果将此值设置为非零值,那么当客户机注销时,将清除客户机上前缀值与 local.webmail.sso.prefix 中配置的值相匹配的所有 SSO Cookie。

local.sso.appid.url=verifyurl

此参数设置 Messaging Server 配置的对等 SSO 主机的验证 URL 值。每个信任的对等 SSO 主机都需要一个参数。 

参数包括以下部分:

  • 应用程序 ID (appid),标识包含可信 SSO Cookie 的每个对等 SSO 主机。

  • 验证 URL (verifyurl),包括主机 URL、主机端口号以及 VerifySSO?(包括末尾处的 ?)。

    例如:

    local.sso.ics50.verifyurl=

    http://sesta.com:8883/VerifySSO?

    在本例中,Calendar Server 应用程序 ID 是 ics50,主机 URL 是 sesta.com,端口号是 8883

    local.sso.msg50.verifyurl=

    http://sesta.com:8882/VerifySSO?

    在本例中,Messaging Server 应用程序 ID 是 msg50,主机 URL 是 sesta.com,端口号是 8882

有关配置 Messaging Server 以启用 SSO 的更多信息,参见《Sun Java System Messaging Server 6.3 Administration Guide》