Apple Federal Smart Card Package User Manual
Page 15

FSCP Installation and Setup Guide
15
The formatString Key
The value of the
formatString
key specifies the format of the search string. You can
specify which items in the
values
array to use in the search string, their order, and any
literal string elements needed to search your directory service for the user record.
To specify values in the
values
array to include in the search string, use
$
, where
is
an index to the item in the
values
array. The first item in the array is 1, the second 2, and so
forth.
As seen in the examples above, the
formatString
value can be as simple as
$1
, which
indicates using the first and only item in the
values
array for the search string.
You can form more complicated searches by combining several items from the
values
array
with string literals. The following example includes the first, second, and third element from
the
values
array separated by periods and followed by the string literal “.mil”:
$1.$2.$3.mil
The
userLookup
Key
The
userLookupKey
key specifies the data key of the directory service to search. You
specify the key by its type and name. There are two types of attributes: “standard” and
“native.”
m Open Directory defines the “standard” attribute keys. You identify a standard attribute key
in the value of the
userLookupKey
key using this attribute type:
dsAttrTypeStandard
m The directory service defines “native” attribute keys. You identify a native attribute in the
value of the
userLookupKey
key using this attribute type:
dsAttrTypeNative
For example, if the name of the attribute in your directory service is “MyUniqueIDField,”
you would set the value of the
userLookupKey
key to
dsAttrTypeNative:MyUniqueIDField
Note: For more information on the way Open Directory works, see Inside Mac OS X.
Open Directory defines both of the attribute type identifiers and the standard attribute keys
in the file named DirServicesConst.h, located in
/System/Library/Frameworks/DirectoryService.framework/Versions/Current/Headers/
Sphinx Page 15 Tuesday, January 14, 2003 12:53 PM