ictxApplicationInfo - Authentication Context Application Info

This describes the application information that may be provided when working with authentication contexts. See eServer Implementation Notes for details on platform-specific details.

Application Information

The structure ictxApplicationInfo_t describes the application used for authentication contexts. New fields may be added to the end of this structure. On a parse operation the fields will be returned if they exist in the authentication context. Code that has been rebuilt with the new structure may access these new fields. A version supplied with the build information indicates which new fields have been provided.

The layout for ictxApplicationInfo_t follows:

typedef struct ictxApplicationInfo
{
    char           * appid;           /* Application identifier name  */
    char           * instance;        /* Application instance info    */
    char           * implemSpecific;  /* Additional data, optional    */
    
} ictxApplicationInfo_t;

Field Descriptions

appid  

The name of the application identifier that has been defined for the application.

instance  

The instance identifier that uniquely identifies the instance of the application in the network.

implemSpecific  

This is implementation specific data that would be added to an authentication context. This value may be NULL. The sender and the receiver must agree on format and content of this data. The recommended layout for this data would be a series of the following:

<LABEL>xxxxx</LABEL><DATA>yyyyy</DATA>

An example would be:

<LABEL>TCPIP address</LABEL><DATA>9.5.6.132</DATA>

Build Information

The application information used for building of an authentication context is contained in the ictxAppInfo structure. The layout for ictxAppInfo follows:

typedef struct ictxAppInfo
{
    enum ictxAppInfoFormat format;
    union
    {
        ictxAppInfoFormat0_t * format0;
    } appInfo;

} ictxAppInfo_t;

Field Descriptions

format  

Valid values for the format are:

enum ictxAppInfoFormat  {
    ICTX_APP_INFO_FORMAT_0
};

When format is ICTX_APP_INFO_FORMAT_0 (0), the appInfo field must contain an ictxAppInfoFormat0_t structure.

typedef struct ictxAppInfoFormat0
{
{
    int                   version;
    ictxApplicationInfo_t  * appInfo;
} ictxAppInfoFormat0_t;

version  

The version indicates which fields are available in the the appInfo field. Version 0 corresponds to the initial structure defined here. In the future if new fields are added to the appInfo structure and the users wants to pass that information in for a build they can indicate the new version of the structure that they are providing.

appInfo  

This is the structure that contains the application information fields.

eServer Implementation Notes

1. AIX implementation details:
   • None.
2. Linux implementation details:
   • None.
3. i5/OS implementation details:
   
   • None.
4. Windows implementation details:
   • None.
5. z/OS implementation notes:
   
   • None.