Sun Java System Access Manager 7 2005Q4 管理指南

第 IV 部分 指令行參照

這是「指令行參照」,「Sun Java System Access Manager 7 2005Q4 管理指南」的第四部分。

描述於本部分的所有指令行工具皆可於下列預設位置中取得:

AccessManager-base/SUNWam/bin (Solairs)

AccessManager-base/identity/bin (Linux)

本部分包含以下章節:

第 14 章 amadmin 指令行工具

本章提供 amadmin 指令行工具的資訊。

amadmin 指令行工具可執行檔

指令行工具可執行檔 amadmin 的主要用途是將 XML 服務檔載入資料存放區,以及在 DIT 上執行批次管理作業。您可在 AccessManager-base/SUNWam/bin 中找到 amadmin,並用於:


備註 –

XML 服務檔案以 XML 資料之靜態 blobs 格式儲存於資料存放區中,可為 Access Manager 所參照。Directory Server 僅能夠識別 LDAP,並不使用該資訊。



備註 –

amadmin 僅支援 Access Manager 主控台支援的部分功能,並不能取代主控台。建議將主控台用於小型管理工作,而將 amadmin 用於較大型的管理工作。


amadmin 語法

要使用 amadmin,必須遵循許多結構上的規則。使用該工具的一般語法如下:


備註 –

必須如語法中所示,準確輸入兩個連字符號。


amadmin 選項

以下是 amadmin 指令行參數選項的定義:

--runasdn (-u)

--runasdn 用於為 LDAP 伺服器認證使用者。此引數的值等於經授權執行 amadmin 的使用者之識別名稱 (DN);例如

--runasdn uid=amAdmin,ou=People,o=iplanet.com,o=isp

DN 亦可透過在網域之間插入空格並為整個 DN 加上雙引號來進行格式化,例如:--runasdn "uid=amAdmin, ou=People, o=iplanet.com, o=isp"

--password (-w)

--password 是強制性選項,其值等於使用 --runasdn 選項指定的 DN 之密碼。

--locale (-l)

--locale 是值等於語言環境名稱的選項。此選項可用於自訂訊息語言。如果沒有提供語言環境,系統會使用預設語言環境 en_US

--continue (-c)

--continue 是在即使出現錯誤的情況下仍將繼續處理 XML 檔案的選項。例如,如果要同時載入三個 XML 檔案,並且載入第一個 XML 檔案失敗,而 amadmin 將繼續載入其餘檔案。continue 選項只能套用到個別請求。

--session (-m)

--session (-m) 是管理階段作業或顯示目前階段作業的選項。指定的 --runasdn 必須與 AMConfig.properties 中超級使用者的 DN 相同,或者就是頂層管理員使用者的 ID。

以下範例將顯示特定服務主機名稱的所有階段作業:

amadmin -u uid=amadmin,ou=people,dc=iplanet,dc=com 
-v  -w 12345678 -m http://sun.com:58080

以下範例將顯示特定使用者的階段作業:

amadmin -u uid=amadmin,ou=people,dc=iplanet,dc=com -v 
 -w 12345678 -m http://sun.com:58080 username

您可以輸入索引編號來終止相應的階段作業,還可以輸入多重索引編號 (以空格分隔) 來終止相應的多重階段作業。

使用以下選項時:

amadmin -m | --session servername pattern

pattern 可以是萬用字元 (*)。如果此式樣使用萬用字元 (*),則必須使用圖元字元 (\\) 使其從 shell 退出。

--debug (-d)

--debug 是將訊息寫入 amAdmin 檔案 (於 /var/opt/SUNWam/debug 目錄之下建立) 的選項。這些訊息是技術方面的詳細說明,但不符合 i18n 標準。若要產生 amadmin 作業記錄,將資料庫驅動程式的類別路徑記錄到資料庫中時,需要將其手動加入。例如,在記錄到 amadmin 中的 mysql 時,可加入以下各行:

CLASSPATH=$CLASSPATH:/opt/IS61/SUNWam/lib/mysql-connector-java-3.0.6-stable-bin.jar
export CLASSPATH

--verbose (-v)

--verbose 是將 amadmin 指令的總體進度列印到螢幕上的選項。它不會將詳細資訊列印到檔案中。輸出到指令行的訊息符合 i18n 標準。

--data (-t)

--data 是以要匯入的批次處理 XML 檔案之名稱作為值的選項。可以指定一個或多個 XML 檔案。這種 XML 檔案可以建立、刪除和讀取各種目錄物件,還可以註冊和取消註冊服務。

--schema (-s)

--schema 是將 Access Manager 服務的屬性載入 Directory Server 的選項。它以定義服務屬性的 XML 服務檔案作為引數。此種 XML 服務檔以 sms.dtd 為基礎。可以指定一個或多個 XML 檔案。


備註 –

必須指定 --data--schema 選項,具體情況取決於是對 DIT 配置批次更新,還是載入服務模式和配置資料。


--deleteservice (-r)

--deleteservice 是用於僅刪除服務及其模式的選項。

--serviceName

--serviceName 是值等於在 XML 服務檔案的 Service name=... 標籤下定義的服務名稱的選項。這部分會顯示在 --serviceName 中。


範例 14–1 sampleMailService.xml 的部分


...
<ServicesConfiguration>
    <Service name="sampleMailService" version="1.0">
        <Schema
 serviceHierarchy="/other.configuration/sampleMailService"
            i18nFileName="sampleMailService"
            i18nKey="iplanet-am-sample-mail-service-description">
...

                  

--help (-h)

--help 是顯示 amadmin 指令語法的引數。

--version (-n)

--version 是顯示公用程式名稱、產品名稱、產品版本和法律聲明的引數。

在聯合管理中使用 amadmin

這個部份列出用於聯合管理的 amadmin 參數。如需有關聯合管理的更多資訊,請參閱「Access Manager Federation Management Guide」。

載入自由中繼相容 XML 到 Directory Server

amadmin -u|--runasdn <user’s DN>
-w|--password <password> or -f|--passwordfile <passwordfile>
-e|--entityname <entity name>
-g|--import <xmlfile>

--runasdn (-u)

使用者的 DN

--password (-w)

使用者的密碼。

--passwordfile (-f)

包含使用者密碼的檔案名稱。

--entityname (-e)

實體名稱。例如,http://www.example.com。實體必須只屬於一個組織。

--import (-g)

包含中介資料資訊的 XML 檔案名稱。這個檔案必須附屬在 Liberty 中介資料規格以及 XSD 中。

匯出一個實體到 XML 檔 (無 XML 數位登入)

amadmin -u|--runasdn <user’s DN>

-w|--password <password> or -f|--passwordfile <passwordfile>
-e|--entityname <entity name>
-o|--export <filename>

--runasdn (-u)

使用者的 DN

--password (-w)

使用者的密碼。

--passwordfile (-f)

包含使用者密碼的檔案名稱。

--entityname (--e)

位於 Directory Server 中的實體名稱

--export (-o)

包含實體 XML 的檔案名稱。XML 必須符合 Liberty 中介資料 XSD。

匯出一個實體到 XML 檔 (含 XML 數位登入)

amadmin -u|--runasdn <user’s DN>
-w|--password <password> or -f|--passwordfile <passwordfile>
-e|--entityname <entity name>
-q|--exportwithsig <filename>

--runasdn (-u)

使用者的 DN

--password (-w)

使用者的密碼。

--passwordfile (-f)

包含使用者密碼的檔案名稱。

--entityname (--e)

位於 Directory Server 中的實體名稱

--exportwithsig (-o)

包含實體 XML 的檔案名稱。已經數位簽名這個檔案。XML 必須符合 Liberty 中介資料 XSD。

在資源套件中使用 amadmin

下列部分顯示新增、尋找和刪除資源套件的 amadmin 語法。

新增資訊套件。

amadmin -u|--runasdn <user-dn> -w|--password <user-password>

-b|--addresourcebundle <name-of-resource-bundle>

-i|--resourcebundlefilename <resource-bundle-file-name>

[-R|--resourcelocale] <locale>

取得資源字串。

amadmin -u|--runasdn <user-dn> -w|--password <user-password>

-z|--getresourcestrings <name-of-resource-bundle>

[-R|--resourcelocale] <locale>

刪除資訊套件。

amadmin -u|--runasdn <user-dn> -w|--password <user-password>

-j|--deleteresourcebundle <name-of-resource-bundle>

[-R|--resourcelocale] <locale>

第 15 章 ampassword 指令行工具

本章提供有關 amPassword 指令行工具的資訊,包含以下小節:

ampassword 指令行可執行檔

在 SPARC 系統上,Access Manager 的 ampassword 公用程式位於 /opt/SUNWam/bin,在 Linux 系統上位於 /opt/sun/Identity/bin。該公用程式可讓您變更管理員或使用者的 Directory Server 密碼。

Procedure在 SSL 模式中使用 Access Manager 執行 ampassword

步驟
  1. 修改位於以下目錄中的 serverconfig.xml 檔案:


    AccessManager-base/SUNWam/config/
  2. 將伺服器屬性 port 變更為 Access Manager 正在執行的 SSL 連接埠。

  3. 將屬性 type 變更為 SSL。

    例如:


    <iPlanetDataAccessLayer>
    <ServerGroup name="default" minConnPool="1" maxConnPool="10">
        <Server name="Server1" host="sun.com" port="636" type="SSL" />
        <User name="User1" type="proxy">
            <DirDN>
                     cn=puser,ou=DSAME Users,dc=iplanet,dc=com
            </DirDN>
            <DirPassword>
                      AQIC5wM2LY4Sfcy+AQBQxghVwhBE92i78cqf
             </DirPassword>
     </User> ...
    
    
                   

    ampassword 僅變更 Directory Server 中的密碼。您必須手動變更 ServerConfig.xml 及 Access Manager 的所有認證範本中的密碼。

第 16 章 bak2am 指令行工具

本章提供有關 bak2am 指令行工具的資訊,包含以下小節:

bak2am 指令行可執行檔

Access Manager 在 AccessManager-base/SUNWam/bin 下包含一個 bak2am 公用程式。該公用程式可復原透過 am2bak 公用程式備份的 Access Manager 元件。

bak2am 語法

對於 Solaris 作業系統,使用 bak2am 工具的一般語法如下:

./bak2am [ -v | --verbose ] -z | --gzip tar.gz-file
./bak2am [ -v | --verbose ] -t | --tar tar-file
./bak2am -h | --help
./bak2am -n | --version

對於 Windows 2000 作業系統,使用 bak2am 工具的一般語法如下:

bak2am [ -v | --verbose ] -d | --directory directory-name

bak2am -h | --help
bak2am -n | --version

備註 –

必須如語法中所示,準確輸入兩個連字符號。


bak2am 選項

--gzip backup-name

--gzip 指定 tar.gz 格式的備份檔案之完整路徑和檔案名稱。依預設,路徑為 AccessManager-base/backup。此選項僅適用於 Solaris。

--tar backup-name

--tar 指定 tar 格式的備份檔案之完整路徑和檔案名稱。依預設,路徑為 AccessManager-base/backup。此選項僅適用於 Solaris。

--verbose

--verbose 用來以詳細模式執行備份公用程式。

--directory

--directory 指定備份目錄。依預設,路徑為 AccessManager-base/backup。此選項僅適用於 Windows 2000。

--help

--help 是顯示 bak2am 指令語法的引數。

--version

--version 是顯示公用程式名稱、產品名稱、產品版本和法律聲明的引數。

第 17 章 am2bak 指令行工具

本章提供有關 am2bak 指令行工具的資訊。

am2bak 指令行可執行檔

Access Manager 在 AccessManager-base/SUNWam/bin 下包含一個 am2bak 公用程式。該公用程式可執行 Access Manager 全部或可選元件的備份。進行記錄備份時必須執行 Directory Server。

am2bak 語法

對於 Solaris 作業系統,使用 am2bak 工具的一般語法如下:

./am2bak [ -v | --verbose ] [ -k | --backup backup-name ] [ -l | --location location ] [[-c | --config] | [-b | --debug] | [-g | --log] | [-t | --cert] | [-d | --ds] | [-a | --all]]*

./am2bak -h | --help

./am2bak -n | --version

對於 Windows 2000 作業系統,使用 am2bak 工具的一般語法如下:

am2bak [ -v | --verbose ] [ -k | --backup backup-name ] [ -l | --location location ] [[-c | --config] | [-b | --debug] | [-g | --log] | [-t | --cert] | [-d | --ds] | [-a | --all]]*

am2bak -h | --help

am2bak -n | --version


備註 –

必須如語法中所示,準確輸入兩個連字符號。


am2bak 選項

--verbose (-v)

--verbose 用來以詳細模式執行備份公用程式。

--backup backup-name (-k)

--backup backup-name 定義備份檔案的名稱。預設為 ambak

--location (-l)

--location 指定備份的目錄位置。預設位置是 AccessManager-base/backup

--config (-c)

--config 指定備份僅用於配置檔案。

--debug (-b)

--debug 指定備份僅用於除錯檔案。

--log (-g)

--log 指定備份僅用於記錄檔。

--cert (-t)

--cert 指定備份僅用於憑證資料庫檔案。

--ds (-d)

--ds 指定備份僅用於 Directory Server。

--all (-a)

--all 指定整個 Access Manager 的完整備份。

--help (-h)

--help 是顯示 am2bak 指令語法的引數。

--version (-n)

--version 是顯示公用程式名稱、產品名稱、產品版本和法律聲明的引數。

Procedure執行備份程序

步驟
  1. 以超級使用者的身份登入。

    執行該程序檔的使用者必須具有超級使用者存取權限。

  2. 如有必要,請執行該程序檔以確保使用的路徑正確。

    該程序檔將備份以下 Solaris™ 作業環境檔案:

    • 配置檔案和自訂檔案:

      • AccessManager-base/SUNWam/config/

        • AccessManager-base/SUNWam/locale/

        • AccessManager-base/SUNWam/servers/httpacl

        • AccessManager-base/SUNWam/lib/*.properties (Java 特性檔)

        • AccessManager-base/SUNWam/bin/amserver. instance-name

        • AccessManager-base/SUNWam/servers/https- all_instances

        • AccessManager-base/SUNWam/servers/web-apps- all_instances

        • AccessManager-base/SUNWam/web-apps/services/WEB-INF/config

        • AccessManager-base/SUNWam/web-apps/services/config

        • AccessManager-base/SUNWam/web-apps/applications/WEB-INF/classes

        • AccessManager-base/SUNWam/web-apps/applications/console

        • /etc/rc3.d/K55amserver.all_instances

        • /etc/rc3.d/S55amserver.all_instances

        • DirectoryServer-base/slapd- host /config/schema/

        • DirectoryServer-base/slapd- host /config/slapd-collations.conf

        • Access Manager/slapd- host /config/dse.ldif

        記錄檔和除錯檔:

        • var/opt/SUNWam/logs (Access Manager 記錄檔)

        • var/opt/SUNWam/install (Access Manager 安裝記錄檔)

        • var/opt/SUNWam/debug (Access Manager 除錯檔)

        憑證:

        • Access Manager/SUNWam/servers/alias

        • Access Manager/alias

          該程序檔還備份以下 Microsoft® Windows 2000 作業系統檔案:

        配置檔案和自訂檔案:

        • AccessManager-base/web-apps/services/WEB-INF/config/*

        • AccessManager-base/locale/*

        • AccessManager-base/web-apps/applications/WEB-INF/classes/*.properties (java 特性檔)

        • AccessManager-base/servers/https- host/config/jvm12.conf

        • AccessManager-base/servers/https- host/config/magnus.conf

        • AccessManager-base/servers/https- host/config/obj.conf

        • DirectoryServer-base/slapd-host/config/schema/*.ldif

        • DirectoryServer-base/slapd-host/config/slapd-collations.conf

        • DirectoryServer-base/slapd-host/config/dse.ldif

        記錄檔和除錯檔:

        • var/opt/logs (Access Manager 記錄檔)

        • var/opt/debug (Access Manager 除錯檔)

        憑證:

        • AccessManager-base/servers/alias

        • AccessManager/alias

第 18 章 amserver 指令行工具

本章提供有關 amserver 指令行工具的資訊。本章包含以下小節:

amserver 指令行可執行檔

amserver 指令行可執行檔可分別啟動和停止與 Unix 和 SecurID 認證模組關聯的 amunixdamsercuridd 輔助程式。

amserver 語法

此工具的一般語法如下:

./amserver { start | stop }

start

start 是啟動輔助程式的指令。

stop

stop 是停止輔助程式的指令。

第 19 章 VerifyArchive 指令行工具

本章提供有關 VerifyArchive 指令行工具的相關資訊,包含以下小節:

VerifyArchive 指令行可執行檔

VerifyArchive 的用途是驗證記錄歸檔檔案。記錄歸檔檔案是一組標記了時間的記錄及其相應的鍵值儲存區 (鍵值儲存區包含用於產生和數位簽名用於偵測記錄檔竄改的鍵值)。歸檔檔案的驗證會偵測對歸檔檔案中任何檔案可能的竄改和/或刪除。

VerifyArchive 擷取給定 logName 的所有歸檔檔案集以及屬於每個歸檔檔案集的所有檔案。執行時,VerifyArchive 會搜尋每個記錄檔記錄,尋找竄改。如果偵測到竄改,會列印一個訊息,指出被竄改的檔案和記錄編號。

VerifyArchive 還檢查已從歸檔檔案集中刪除的所有檔案。如果偵測到已刪除的檔案,會列印訊息,說明驗證失敗。如果未偵測到被竄改或刪除的檔案,則會傳回訊息,說明歸檔檔案驗證已成功完成。


備註 –

若您以不具管理員權限的使用者身份執行 amverifyarchive,可能發生錯誤。


VerifyArchive 語法

需要所有的參數選項。語法如下所示:

amverifyarchive -l logName -p path -u 
uname -w password

選項

logName

logName 指要驗證的記錄檔之名稱 (如 amConsoleamAuthentication 等等)。VerifyArchive 會驗證給定 logName 的存取權限與錯誤記錄檔。例如,如果指定 amConsole,檢驗器會驗證 amConsole.accessamConsole.error 檔案。或者,可將 logName 指定為 amConsole.accessamConsole.error,只對那些記錄檔進行驗證。

path

path 是儲存記錄檔案的完整目錄路徑。

uname

uname 是 Access Manager 管理員的使用者 ID。

password

password 是 Access Manager 管理員的密碼。

第 20 章 amsecuridd 輔助程式

本章提供有關 amsecuiridd 輔助程式的資訊,包含以下小節:

amsecuridd 輔助程式指令行可執行檔

Access Manager SecurID 認證模組透過 Security Dynamic ACE/Client C API 和 amsecruidd 輔助程式來實作,此輔助程式可在 Access Manager SecurID 認證模組和 SecurID Server 之間通訊。SecurID 認證模組透過開啟 localhost:57943 的套接字來呼叫 amsecuridd 常駐程式,以偵聽 SecurID 認證請求。


備註 –

57943 是預設連接埠號。如果此連接埠號已被使用,您可在 SecurID 認證模組的 SecurID 輔助程式認證連接埠屬性中指定不同的連接埠號。此連接埠號在所有組織中必須是唯一的。


因為到 amsecuridd 的介面是透過 stdin 的純文字,所以只許可本機主機連線。amsecuridd 使用後端的 SecurID 遠端 API (5.x 版本) 加密資料。

amsecuridd 輔助程式偵聽連接埠號 58943 (依預設),以接收其配置資訊。如果此連接埠已被使用,您可在 AMConfig.properties 檔案 (依預設,位於 AccessManager-base /SUNWam/config/ 中) 的 securidHelper.ports 屬性中變更此連接埠。securidHelp.ports 屬性包含每個 amsecuridd 輔助程式實例之連接埠的清單 (以空格分隔)。儲存 AMConfig.properties 的變更之後,請重新啟動 Access Manager。


備註 –

對於和單獨 ACE/Server (包含不同的 sdconf.rec 檔案) 通訊的每個組織,系統應該執行單獨的 amsecuridd 實例。


amsecuridd 語法

語法如下所示:

amsecuridd [-v] [-c portnum]

amsecuridd 選項

verbose (-v)

開啟詳細模式,並記錄到 /var/opt/SUNWam/debug/securidd_client.debug

configure portnumber (-c portnm)

配置偵聽連接埠號。預設值為 58943。

執行 amsecuridd 輔助程式

依預設,amsecuridd 位於 AccessManager-base /SUNWam/share/bin。若要在預設連接埠上執行輔助程式,請輸入以下指令 (無選項):

./amsecuridd

若要在非預設連接埠上執行輔助程式,請輸入以下指令:

./amsecuridd [-v] [-c portnm]

還可透過 amserver 指令行公用程式來執行 amsecuridd,但它僅可在預設連接埠上執行。

必需的程式庫

為了執行輔助程式,需要以下程式庫 (大多數程式庫可在作業系統的 /usr/lib/ 中找到):


備註 –

LD_LIBRARY_PATH 設定為 AccessManager-base /Sunwam/lib/,以找到 libaceclnt.so