288 lines
11 KiB
HTML
288 lines
11 KiB
HTML
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
||
|
|
<HTML>
|
||
|
|
<HEAD>
|
||
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
|
||
|
|
<meta name="Copyright" content="Copyright (c) 2006 by IBM Corporation">
|
||
|
|
<TITLE>ictxPremappedInfo - Authentication Context Premapped User Info</TITLE>
|
||
|
|
<!-- Begin Header Records ========================================= -->
|
||
|
|
<!-- All rights reserved. Licensed Materials Property of IBM -->
|
||
|
|
<!-- US Government Users Restricted Rights -->
|
||
|
|
<!-- Use, duplication or disclosure restricted by -->
|
||
|
|
<!-- GSA ADP Schedule Contract with IBM Corp. -->
|
||
|
|
<!-- Change History: -->
|
||
|
|
<!-- YYMMDD USERID Change description -->
|
||
|
|
<!-- Edited by Kersten Jan 02 -->
|
||
|
|
<!-- Created by Therese Dalton on 17 July 2001 -->
|
||
|
|
<!--File edited for Tidy July 2001 -->
|
||
|
|
<!-- End Header Records -->
|
||
|
|
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
|
||
|
|
</HEAD>
|
||
|
|
<BODY>
|
||
|
|
<!--Java sync-link-->
|
||
|
|
<script type="text/javascript" language="Javascript" src="../rzahg/synch.js">
|
||
|
|
</script>
|
||
|
|
|
||
|
|
<a name="Top_Of_Page"></a>
|
||
|
|
<!-- ============================================================== -->
|
||
|
|
<!-- -->
|
||
|
|
<!-- -->
|
||
|
|
<!-- ============================================================== -->
|
||
|
|
<H2>ictxPremappedInfo--Authentication Context Premapped User Info</H2>
|
||
|
|
<!-- ============================================================== -->
|
||
|
|
<!-- -->
|
||
|
|
<!-- D E S C R I P T I O N -->
|
||
|
|
<!-- -->
|
||
|
|
<!-- ============================================================== -->
|
||
|
|
<P>This describes the premapped user information that will be added to the
|
||
|
|
authentication context, or was parsed from the authentication context.
|
||
|
|
See <a href="#eserver_notes">eServer Implementation
|
||
|
|
Notes</a> for details on platform-specific details.
|
||
|
|
</P>
|
||
|
|
<!-- ============================================================== -->
|
||
|
|
<!-- -->
|
||
|
|
<!-- S T R U C T U R E -->
|
||
|
|
<!-- -->
|
||
|
|
<!-- ============================================================== -->
|
||
|
|
<H3>Premapped User Information</H3>
|
||
|
|
|
||
|
|
<P>The structure ictxPremappedUserInfo_t describes the
|
||
|
|
authentication information used for authentication
|
||
|
|
tokens that support authentication information.
|
||
|
|
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.
|
||
|
|
</P>
|
||
|
|
<P>
|
||
|
|
The layout for ictxPremappedUserInfo_t follows:</P>
|
||
|
|
<PRE>
|
||
|
|
typedef struct ictxPremappedUserInfo
|
||
|
|
{
|
||
|
|
char * user; /* Mapped user */
|
||
|
|
char * registry; /* Registry used for the mapping
|
||
|
|
operation. */
|
||
|
|
char * mappingSource; /* Indicates what type of
|
||
|
|
information was used as the
|
||
|
|
source for the mapping lookup
|
||
|
|
operation. */
|
||
|
|
char * mappingQualifiers;/* Additional information that
|
||
|
|
was used for the mapping
|
||
|
|
operation. */
|
||
|
|
char * implemSpecific; /* Additional data, optional */
|
||
|
|
} ictxPremappedUserInfo_t;
|
||
|
|
</PRE>
|
||
|
|
<!-- ============================================================== -->
|
||
|
|
<!-- -->
|
||
|
|
<!-- F I E L D D E S C R I P T I O N S -->
|
||
|
|
<!-- -->
|
||
|
|
<!-- ============================================================== -->
|
||
|
|
<H4>
|
||
|
|
<A name=Header_41>Field Descriptions</A>
|
||
|
|
</H4>
|
||
|
|
|
||
|
|
<DL>
|
||
|
|
|
||
|
|
<!-- ============================================================== -->
|
||
|
|
<!-- user -->
|
||
|
|
<!-- ============================================================== -->
|
||
|
|
<DT>
|
||
|
|
<STRONG>user</STRONG>
|
||
|
|
<DD>The name of the premapped user. <BR><BR>
|
||
|
|
</DD>
|
||
|
|
|
||
|
|
|
||
|
|
<!-- ============================================================== -->
|
||
|
|
<!-- registry -->
|
||
|
|
<!-- ============================================================== -->
|
||
|
|
<DT>
|
||
|
|
<STRONG>registry</STRONG>
|
||
|
|
<DD>The name of the user registry that was used for the mapping lookup operaton.
|
||
|
|
<BR><BR>
|
||
|
|
</DD>
|
||
|
|
|
||
|
|
<!-- ============================================================== -->
|
||
|
|
<!-- mappingQualifiers -->
|
||
|
|
<!-- ============================================================== -->
|
||
|
|
<DT>
|
||
|
|
<STRONG>mappingQualifiers</STRONG>
|
||
|
|
<DD>Additional information that was used for the mapping operation.
|
||
|
|
If EIM was used for the mapping lookup operation
|
||
|
|
then this would be the additionalInformation parameter.
|
||
|
|
<BR><BR>
|
||
|
|
</DD>
|
||
|
|
|
||
|
|
<!-- ============================================================== -->
|
||
|
|
<!-- implemSpecific -->
|
||
|
|
<!-- ============================================================== -->
|
||
|
|
<DT>
|
||
|
|
<STRONG>implemSpecific</STRONG>
|
||
|
|
<DD>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:
|
||
|
|
<PRE>
|
||
|
|
<LABEL>xxxxx</LABEL><DATA>yyyyy</DATA>
|
||
|
|
</PRE>
|
||
|
|
An example would be:
|
||
|
|
<PRE>
|
||
|
|
<LABEL>TCPIP address</LABEL><DATA>9.5.6.132</DATA>
|
||
|
|
</PRE>
|
||
|
|
<BR>
|
||
|
|
</DD>
|
||
|
|
|
||
|
|
</DL>
|
||
|
|
<!-- ============================================================== -->
|
||
|
|
<!-- -->
|
||
|
|
<!-- B U I L D I N F O R M A T I O N -->
|
||
|
|
<!-- -->
|
||
|
|
<!-- ============================================================== -->
|
||
|
|
<H3>
|
||
|
|
<A name=Header_41>Build Information</A>
|
||
|
|
</H3>
|
||
|
|
|
||
|
|
<P>The premapped user information used for building of an
|
||
|
|
authentication context is contained in the ictxPremappedInfo
|
||
|
|
structure.
|
||
|
|
The layout for ictxPremappedInfo follows:</P>
|
||
|
|
<PRE>
|
||
|
|
typedef struct ictxPremappedInfo
|
||
|
|
{
|
||
|
|
enum ictxPremappedInfoFormat format;
|
||
|
|
union
|
||
|
|
{
|
||
|
|
ictxPremappedInfoFormat0_t format0;
|
||
|
|
} premappedInfo;
|
||
|
|
} ictxPremappedInfo_t;
|
||
|
|
</PRE>
|
||
|
|
<P>
|
||
|
|
<BR>
|
||
|
|
<!-- ============================================================== -->
|
||
|
|
<!-- -->
|
||
|
|
<!-- F I E L D D E S C R I P T I O N S -->
|
||
|
|
<!-- -->
|
||
|
|
<!-- ============================================================== -->
|
||
|
|
<H4>
|
||
|
|
<A name=Header_41>Field Descriptions</A>
|
||
|
|
</H4>
|
||
|
|
<DL>
|
||
|
|
<!-- ============================================================== -->
|
||
|
|
<!-- format -->
|
||
|
|
<!-- ============================================================== -->
|
||
|
|
<DT>
|
||
|
|
<STRONG>format</STRONG>
|
||
|
|
<DD>Valid values for the format are:
|
||
|
|
<PRE>
|
||
|
|
enum ictxPremappedInfoFormat {
|
||
|
|
ICTX_PREMAPPED_INFO_FORMAT_0
|
||
|
|
};
|
||
|
|
</PRE>
|
||
|
|
<P>When format is ICTX_PREMAPPED_INFO_FORMAT_0 (0), the <em>premappedInfo</em> field
|
||
|
|
must contain an ictxPremappedInfoFormat0_t structure. <BR>
|
||
|
|
<PRE>
|
||
|
|
|
||
|
|
typedef struct ictxPremappedInfoFormat0
|
||
|
|
{
|
||
|
|
int version;
|
||
|
|
ictxPremappedUserInfo_t * premappedInfo;
|
||
|
|
} ictxPremappedInfoFormat0_t;
|
||
|
|
</PRE>
|
||
|
|
<BR>
|
||
|
|
|
||
|
|
<!-- ============================================================== -->
|
||
|
|
<!-- version -->
|
||
|
|
<!-- ============================================================== -->
|
||
|
|
<DT>
|
||
|
|
<STRONG>version</STRONG>
|
||
|
|
<DD>The version indicates which fields are available in the
|
||
|
|
the <em>authInfo</em> field. Version 0 corresponds to the initial structure
|
||
|
|
defined here. In the future if new fields are added to the premappedInfo
|
||
|
|
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.
|
||
|
|
<BR>
|
||
|
|
<BR>
|
||
|
|
</DD>
|
||
|
|
<!-- ============================================================== -->
|
||
|
|
<!-- premappedInfo -->
|
||
|
|
<!-- ============================================================== -->
|
||
|
|
<DT>
|
||
|
|
<STRONG>premappedInfo</STRONG>
|
||
|
|
<DD>This is the structure that contains the premapped user
|
||
|
|
information fields.
|
||
|
|
<BR>
|
||
|
|
</DD>
|
||
|
|
</DL>
|
||
|
|
|
||
|
|
|
||
|
|
<!-- ============================================================== -->
|
||
|
|
<!-- -->
|
||
|
|
<!-- E S E R V E R N O T E S -->
|
||
|
|
<!-- -->
|
||
|
|
<!-- ============================================================== -->
|
||
|
|
<h3>
|
||
|
|
<a name="eserver_notes">eServer Implementation Notes</a>
|
||
|
|
</h3>
|
||
|
|
<ol>
|
||
|
|
<li>
|
||
|
|
<strong>AIX implementation details:</strong>
|
||
|
|
<ul>
|
||
|
|
<li>
|
||
|
|
None.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</li>
|
||
|
|
<li>
|
||
|
|
<strong>Linux implementation details:</strong>
|
||
|
|
<ul>
|
||
|
|
<li>
|
||
|
|
None.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</li>
|
||
|
|
<li>
|
||
|
|
<strong>i5/OS implementation details:</strong><br>
|
||
|
|
|
||
|
|
<ul>
|
||
|
|
<li>
|
||
|
|
None.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</li>
|
||
|
|
<li>
|
||
|
|
<strong>Windows implementation details:</strong>
|
||
|
|
<ul>
|
||
|
|
<li>
|
||
|
|
None.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</li>
|
||
|
|
<li>
|
||
|
|
<strong>z/OS implementation notes:</strong><br>
|
||
|
|
|
||
|
|
<ul>
|
||
|
|
<li>
|
||
|
|
None.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</li>
|
||
|
|
</ol>
|
||
|
|
|
||
|
|
<!-- ============================================================== -->
|
||
|
|
<!-- The End -->
|
||
|
|
<!-- ============================================================== -->
|
||
|
|
<hr>
|
||
|
|
<center>
|
||
|
|
<table cellpadding="2" cellspacing="2">
|
||
|
|
<tr align="center">
|
||
|
|
<td valign="middle" align="center">
|
||
|
|
<a href="#Top_Of_Page">Top</a> |
|
||
|
|
<a href="sec.htm">Security APIs</a> |
|
||
|
|
<a href="aplist.htm">APIs by category</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
</center>
|
||
|
|
</BODY>
|
||
|
|
</HTML>
|