In addition to the site preferences stored in the Kerberos configuration, users may also want to have their own personal preferences for controlling credential acquisition. As a result, KIM provides user preferences for initial credential options and user interface behavior such as the default client identity and the favorite realms list.
In order to view and edit the user's preferences, call
kim_preferences_create() to acquire a preferences object containing the user's preferences. You can examine preferences with the functions starting with "kim_preferences_get_" and change preferences with the functions starting with "kim_preferences_set_". Once you are done making changes, you can write changes back out to the user's preferences with
kim_preferences_synchronize().
- Note:
- The location of user preferences and the semantics of preference synchronization is platform-specific. Where possible KIM will use platform-specific preference mechanisms.
KIM provides user preferences for initial credential options. These are the options
kim_options_create() will use when creating a new KIM options object. They are also the options specified by KIM_OPTIONS_DEFAULT. You can view and edit the initial credential options using
kim_preferences_get_options() and
kim_preferences_set_options().
- Note:
- Not all credential options in the kim_options_t object have corresponding user preferences. For example, the prompt callback function is not stored in the user preferences since it has no meaning outside of the current application. Some options which are not currently stored in the preferences may be stored there in the future.
If you are implementing a user interface for credentials acquisition, you should be aware that KIM has a user preference to manage the initial credential options preferences. If the user successfully acquires credentials with non-default options and
kim_preferences_get_remember_options() is set to TRUE, you should store the options used to get credentials with
kim_preferences_set_options().
KIM also provides user preferences for the default client identity. This identity is used whenever KIM needs to display a graphical dialog for credential acquisition but does not know what client identity to use. You can view and edit the default client identity using
kim_preferences_get_client_identity() and
kim_preferences_set_client_identity().
If you are implementing a user interface for credentials acquisition, you should be aware that KIM has a user preference to manage the client identity preferences. If the user successfully acquires credentials with non-default options and kim_preferences_get_remember_client_identity() is set to TRUE, you should store the client identity for which credentials were acquired using kim_preferences_set_client_identity().
When presenting a graphical interface for credential acquisition, KIM may need to display a list of realms for the user to select from. This list is generated by the user's favorite realms preference. You can view and edit the favorite realms preference using
kim_preferences_get_favorite_realms() and
kim_preferences_set_favorite_realms(). Please see the
KIM Favorite Realms Overview for more information.
See KIM Preferences Documentation for information on specific APIs.
