從指令行管理 CoS (Sun Java System Directory Server Enterprise Edition 6.2 管理指南)

Sun Java System Directory Server Enterprise Edition 6.2 管理指南

從指令行管理 CoS

由於所有配置資訊與範本資料皆會儲存為目錄中的項目，因此您可以使用 LDAP 指令行工具配置並管理 CoS 定義。本節顯示如何從指令行建立 CoS 定義項目與 CoS 範本項目。

從指令行建立 CoS 定義項目

所有 CoS 定義項目皆有 LDAPsubentry 物件類別，且繼承 cosSuperDefinition 物件類別。此外，每種 CoS 類型皆繼承特定物件類別並包含對應的屬性。下表列出與各種 CoS 定義項目類型相關的物件類別與屬性。

表 9–1 CoS 定義項目中的物件類別與屬性


CoS 類型	CoS 定義項目
指標 CoS	`objectclass: top` `objectclass: LDAPsubentry` `objectclass: cosSuperDefinition` `objectclass: cosPointerDefinition` `cosTemplateDN:` `DN` `cosAttribute:` `attributeName` `override` `merge`
間接 CoS	`objectclass: top` `objectclass: LDAPsubentry` `objectclass: cosSuperDefinition` `objectclass: cosIndirectDefinition` `cosIndirectSpecifier:` `attributeName` `cosAttribute:` `attributeName` `override` `merge`
類別 CoS	`objectclass: top` `objectclass: LDAPsubentry` `objectclass: cosSuperDefinition` `objectclass: cosClassicDefinition` `cosTemplateDN:` `DN` `cosSpecifier:` `attributeName` `cosAttribute:` `attributeName` `override` `merge`

cosAttribute 一律為多值。各值會定義 CoS 機制所產生的一個屬性。

您可以使用 CoS 定義項目中的下列屬性。如需有關各屬性的更多資訊，請參閱「Sun Java System Directory Server Enterprise Edition 6.2 Man Page Reference」中個別屬性的說明。

表 9–2 CoS 定義項目屬性


屬性	CoS 定義項目內的用途
`cosAttribute` `attributeName override merge`	定義要產生值的運算屬性名稱。此屬性為多值，每個值代表其值會從範本產生的屬性名稱。`override` 與 `merge` 限定元指定在此表之後所述的特殊案例中，CoS 屬性值的運算方式。 `attributeName` 無法包含任何子類型。含子類型的屬性名稱會遭忽略，不過仍會處理 `cosAttribute` 的其他值。
`cosIndirectSpecifier` `attributeName`	定義目標項目中的屬性名稱，間接 CoS 會使用其值識別範本項目。已命名的屬性稱為限定符號，必須包含每個目標項目中完整的 DN 字串。此屬性為單值，但是 `attributeName` 可以是多值，以定義多個範本。
`cosSpecifier` `attributeName`	定義目標項目中的屬性名稱，類別 CoS 會使用其值識別範本項目。已命名的屬性稱為限定符號，且必須包含範本項目的 RDN 中可以找到的字串。此屬性為單值，但是 `attributeName` 可以是多值，以定義多個範本。
`cosTemplateDN` `DN`	提供範本項目的完整 DN 給指標 CoS 定義，或提供範本項目的基底 DN 給類別 CoS。此屬性為單值。

備註 –

您無法使用 isMemberOf 屬性做為 CosSpecifier，讓靜態群組的所有成員自動繼承共用運算屬性值。

cosAttribute 屬性允許 CoS 屬性名稱之後跟隨兩個限定元：override 限定元與 merge 限定元。

override 限定元說明 CoS 動態產生的屬性已實際存在於項目中時的運作方式。override 限定元可以是下列其中之一：

default (預設) (或無限定元) - 表示當屬性類型與運算屬性類型相同時，伺服器不會覆寫儲存在項目中的實際屬性值。
override - 表示即使項目已儲存了值，伺服器也一律會傳回 CoS 產生的值。
operational - 表示只有在搜尋中明確請求時，才會傳回該屬性。操作屬性不需要通過模式檢查便會傳回。operational 限定元的運作方式與 override 限定元相同。

如果屬性在模式中也定義為操作，您僅能有一個操作屬性。例如，如果 CoS 產生 description 屬性的值，由於 description 屬性在模式中未標示為操作屬性，因此您無法使用 operational 限定元。

merge 限定元不存在或為 merge-schemes。此限定元允許運算的 CoS 屬性可為來自多個範本或多個 CoS 定義的多重值。如需更多資訊，請參閱多值 CoS 屬性。

覆寫實際屬性值

您可能依下列方式建立包含 override 限定元的指標 CoS 定義項目：

dn: cn=pointerCoS,dc=example,dc=com
objectclass: top
objectclass: LDAPsubentry
objectclass: cosSuperDefinition
objectclass: cosPointerDefinition
cosTemplateDn: cn=exampleUS,cn=data
cosAttribute: postalCode override

此指標 CoS 定義項目表示項目與產生 postalCode 屬性值的範本項目 cn=exampleUS,cn=data 相關。override 限定元表示如果目標項目內存在 postalCode 屬性，則此值會取代屬性值。

備註 –

如果使用 operational 或 override 限定元定義 CoS 屬性，則無法在 CoS 範圍內任何項目中的屬性「實際」值上執行寫入作業。

多值 CoS 屬性

當您指定 merge-schemes 限定元時，產生的 CoS 屬性可以兩種方式成為多值屬性：

若是間接或類別 CoS，目標項目中的限定符號屬性可以是多值。在此例中，每個值各會決定一個範本，且來自各個範本的該值是產生的值之一部分。
任何類型的多重 CoS 定義項目，可以在其 cosAttribute 中包含相同的屬性名稱。在此例中，如果所有定義包含 merge-schemes 限定元，產生的屬性會包含各個定義所運算的所有值。

這兩種情況可同時發生，並定義更多值。但是在所有情況下，重複的值僅會在產生的屬性中一次傳回。

如果沒有 merge-schemes 限定元，會使用範本項目的 cosPriority 屬性，為產生的屬性決定所有範本之間的單一值。此範例會在下一節中說明。

merge-schemes 限定元永遠不會合併在目標中以範本產生的值所定義之「實際」值。merge 限定元與 override 限定元無關。所有配對皆有可能，且可進行各配對的運作方式。此外，限定元可以在屬性名稱之後以任何順序指定。

備註 –

同一屬性有多個 CoS 定義時，所有定義皆必須有相同的 override 與 merge 限定元。當 CoS 定義中有不同的成對之限定元時，會任意從所有定義選取其中一個組合。

CoS 屬性優先權

若有多個 CoS 定義或多值限定符號，但沒有 merge-schemes 限定元，則目錄伺服器會使用優先權屬性選取單一範本，以定義運算屬性的單一值。

cosPriority 屬性表示特定範本在所考慮的所有範本之間的全域優先權。優先權零是最高優先權。沒有 cosPriority 屬性的範本會視為最低的優先權。當兩個以上的範本提供一個屬性值，但有相同的優先權或沒有優先權時，會隨意選擇值。

使用 merge-schemes 限定元時不會考量範本優先權。合併時，所有考量的範本會定義一個值，而不管範本定義的優先權。如下節中所述，會在 CoS 範本項目上定義 cosPriority 屬性。

備註 –

cosPriority 屬性不得有負值。此外，間接 CoS 產生的屬性不支援優先權。請勿在間接 CoS 定義的範本項目中使用 cosPriority。

從指令行建立 CoS 範本項目

使用指標 CoS 或類別 CoS 時，範本項目會包含 LDAPsubentry 與 cosTemplate 物件類別。必須特別針對 CoS 定義建立此項目。使 CoS 範本項目成為 LDAPsubentry 物件類別的實例，即可允許執行一般搜尋，而不受配置項目的阻礙。

間接 CoS 機制的範本為目錄中任意的現有項目。目標不需要提前識別或提供 LDAPsubentry 物件類別，但是目標必須有輔助 cosTemplate 物件類別。只有在 CoS 評估為產生運算屬性與其值時，才需存取間接 CoS 範本。

在所有情況下，CoS 範本項目必須包含目標項目上 CoS 所產生的屬性與值。屬性名稱指定於 CoS 定義項目的 cosAttribute 屬性中。

下列範例顯示產生 postalCode 屬性的指標 CoS 最高優先權之範本項目：

dn: cn=ZipTemplate,ou=People,dc=example,dc=com
objectclass: top
objectclass: LDAPsubentry
objectclass: extensibleobject
objectclass: cosTemplate
postalCode: 95054
cosPriority: 0

下節提供範本項目範例，以及各種 CoS 定義項目類型的範例。

指標 CoS 的範例

下列指令會建立具有 cosPointerDefinition 物件類別的指標 CoS 定義項目。此定義項目使用上節範例中陳述的 CoS 範本項目，以在 ou=People,dc=example,dc=com 樹狀結構的所有項目之間共用郵遞區號。

$ ldapmodify -a -h host1 -p 1389 -D cn=admin,cn=Administrators,cn=config -w -
dn: cn=pointerCoS,ou=People,dc=example,dc=com
objectclass: top
objectclass: LDAPsubentry
objectclass: cosSuperDefinition
objectclass: cosPointerDefinition
cosTemplateDn: cn=ZipTemplate,ou=People,dc=example,dc=com
cosAttribute: postalCode

CoS 範本項目 (cn=ZipTemplate,ou=People,dc=example,dc=com) 會提供儲存在其 postalCode 屬性中的值，給所有位於 ou=People,dc=example,dc=com 尾碼下的項目。如果搜尋相同子樹狀結構中沒有郵遞區號的任何項目，則會看到產生的屬性值：

$ ldapsearch -h host1 -p 1389 -D cn=admin,cn=Administrators,cn=config -w - \
 -b "ou=People,dc=example,dc=com" -s sub "(cn=*Jensen)"
dn: cn=Babs Jensen,ou=People,dc=example,dc=com
cn: Babs Jensen
...
postalCode: 95054

間接 CoS 的範例

間接 CoS 可命名 cosIndirectSpecifier 屬性中的屬性，可找出每個目標特有的範本。間接 CoS 的範本項目可以是目錄中的任何項目，包含其他使用者項目。此間接 CoS 範例使用目標項目的 manager 屬性識別 CoS 範本項目。範本項目是經理的使用者項目。經理的使用者項目包含要產生的屬性值。在此案例中為 departmentNumber 的值。

下列指令建立包含 cosIndirectDefinition 物件類別的間接 CoS 定義項目：

$ ldapmodify -a -h host1 -p 1389 -D cn=admin,cn=Administrators,cn=config -w -
dn: cn=generateDeptNum,ou=People,dc=example,dc=com
objectclass: top
objectclass: LDAPsubentry
objectclass: cosSuperDefinition
objectclass: cosIndirectDefinition
cosIndirectSpecifier: manager
cosAttribute: departmentNumber

接著，將 cosTemplate 物件類別增加至範本項目中，並確定這些項目會定義要產生的屬性。在此範例中，所有經理項目皆為範本：

$ ldapmodify -h host1 -p 1389 -D cn=admin,cn=Administrators,cn=config -w -
dn: cn=Carla Fuentes,ou=People,dc=example,dc=com
changetype: modify
add: objectclass
objectclass: cosTemplate
-
add: departmentNumber
departmentNumber: 318842

在此 CoS 中，包含 manager 屬性的目標項目 (ou=People,dc=example,dc=com 下的項目) 自動會有其經理的部門號碼。由於伺服器沒有 departmentNumber 屬性，因此會在目標項目上運算該屬性。但是，departmentNumber 屬性會以目標項目的一部分傳回。例如，如果 Babs Jensen 的經理定義為 Carla Fuentes，其部門號碼如下所示：

$ ldapsearch -h host1 -p 1389 -D cn=admin,cn=Administrators,cn=config -w - \
 -b "ou=People,dc=example,dc=com" -s sub "(cn=*Jensen)"
dn: cn=Babs Jensen,ou=People,dc=example,dc=com
cn: Babs Jensen
...
manager: cn=Carla Fuentes,ou=People,dc=example,dc=com
departmentNumber: 318842

類別 CoS 的範例

此範例說明如何使用類別 CoS 產生郵寄地址。產生的值會在範本項目中指定，此範本項目由 CoS 定義中的 cosTemplateDN 與目標項目中的 cosSpecifier 屬性值之組合所找到。下列指令使用 cosClassicDefinition 物件類別建立定義項目：

$ ldapmodify -a -h host1 -p 1389 -D cn=admin,cn=Administrators,cn=config -w -
dn: cn=classicCoS,dc=example,dc=com
objectclass: top
objectclass: LDAPsubentry
objectclass: cosSuperDefinition
objectclass: cosClassicDefinition
cosTemplateDn: ou=People,dc=example,dc=com
cosSpecifier: building
cosAttribute: postalAddress

使用相同的指令，建立提供每棟大樓的郵寄地址之範本項目：

dn: cn=B07,ou=People,dc=example,dc=com
objectclass: top
objectclass: LDAPsubentry
objectclass: extensibleobject
objectclass: cosTemplate
postalAddres: 7 Old Oak Street, Anytown, CA 95054

在此 CoS 中，包含 building 屬性的目標項目 (ou=People,dc=example,dc=com 下的項目) 自動會有對應的郵寄地址。CoS 機制會搜尋其 RDN 中有限定符號屬性值的範本項目。在此範例中，如果 Babs Jensen 指定給大樓 B07，會產生如下的郵寄地址：

$ ldapsearch -h host1 -p 1389 -D cn=admin,cn=Administrators,cn=config -w - \
 -b "ou=People,dc=example,dc=com" -s sub "(cn=*Jensen)"
dn: cn=Babs Jensen,ou=People,dc=example,dc=com
cn: Babs Jensen
...
building: B07
postalAddress: 7 Old Oak Street, Anytown, CA 95054