Apple Federal Smart Card Package User Manual

Page 15

Advertising
background image

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

$<n>

, where

<n>

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

Advertising