<!--Arbortext, Inc., 1988-2008, v.4002-->
<!DOCTYPE REFENTRY PUBLIC "-//Sun Microsystems//DTD SolBook 3.5//EN" [
<!ENTITY options-common SYSTEM "options-common.sgm">
<!ENTITY synopsis-common SYSTEM "synopsis-common.sgm">
<!ENTITY % commonents SYSTEM "common.ent">
%commonents;
]>
<?Pub UDT _bookmark _target>
<?Pub EntList bull rArr sect>
<?Pub Inc>
<refentry id="create-connector-security-map-1">
<!-- @(#)create-connector-security-map.1 1.11 07/06/04 SMI; -->
<refmeta><refentrytitle>create-connector-security-map</refentrytitle><manvolnum>1
</manvolnum>
<refmiscinfo class="date">30 Jan 2007</refmiscinfo>
<refmiscinfo class="sectdesc">&man1;</refmiscinfo>
<refmiscinfo class="software">&software;</refmiscinfo>
<refmiscinfo class="arch">generic</refmiscinfo>
<refmiscinfo class="copyright">Copyright (c) 2007, Sun Microsystems, Inc.
All Rights Reserved</refmiscinfo>
</refmeta>
<refnamediv><indexterm><primary>creates a security map for the specified connector
connection pool</primary></indexterm><indexterm><primary>create-connector-security-map
</primary></indexterm>
<refname>create-connector-security-map</refname><refpurpose>creates a security
map for the specified connector connection pool</refpurpose></refnamediv>
<refsynopsisdiv><title></title>
<synopsis><command>create-connector-security-map</command> &synopsis-common; <option
role="double-dash">poolname</option> <replaceable>connector_connection_pool_name</replaceable>
[<option role="double-dash">principals</option> <replaceable>principal_name1</replaceable>[, <replaceable>
principal_name2</replaceable>]* | 
<option role="double-dash">usergroups</option> <replaceable>user_group1</replaceable>[, <replaceable>
user_group2</replaceable>*]
 <option role="double-dash">mappedusername</option>  <replaceable>username </replaceable> {<replaceable>
security_map_name</replaceable>}</synopsis>
</refsynopsisdiv>
<refsect1 role="description"><title></title>
<para>Use this command to create a security map for the specified connector
connection pool. If the security map is not present, a new one is created.
Also, use this command to map the caller identity of the application (principal
or user group) to a suitable EIS principal in container-managed authen<?Pub
Caret>tication-based scenarios. One or more named security maps may be associated
with a connector connection pool. The connector security map configuration
supports the use of the wild card asterisk (*) to indicate all users or all
user groups.</para>
<para>For this command to succeed, you must have first created a connector
connection pool using the <command>create-connector-connection-pool</command> command. 
</para>
<para>The enterprise information system (EIS) is any system that holds the
data of an organization. It can be a mainframe, a messaging system, a database
system, or an application.</para>
<para>This command is supported in remote mode only.</para>
</refsect1>
<refsect1 role="options"><title></title>
<variablelist termlength="medium">&options-common;
<varlistentry><term><option role="double-dash">target</option></term>
<listitem><para>This option is deprecated in this release.</para>
</listitem>
</varlistentry>
<varlistentry><term><option role="double-dash">poolname</option></term>
<listitem><para>Specifies the name of the connector connection pool to which
the security map belongs.</para>
</listitem>
</varlistentry>
<varlistentry><term><option role="double-dash">principals</option></term>
<listitem><para>Specifies a list of backend EIS principals. More than one
principal can be specified using a comma separated list. Use either the <option
role="double-dash">principals</option> or <option role="double-dash">usergroups</option> options,
but not both.</para>
</listitem>
</varlistentry>
<varlistentry><term><option role="double-dash">usergroups</option></term>
<listitem><para>Specifies a list of backend EIS user group. More than one
usergroups can be specified using a comma separated list. </para>
</listitem>
</varlistentry>
<varlistentry><term><option role="double-dash">mappedusername</option></term>
<listitem><para> This property specifies the EIS username.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="operands"><title></title>
<variablelist termlength="medium">
<varlistentry><term><replaceable>security_map_name</replaceable></term>
<listitem><para> name of the security map to be created or updated.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="examples"><title></title>
<example><title>Using <command>create-connector-security-map</command> command</title>
<para>It is assumed that the connector pool has already been created using
the <command>create-connector-pool</command> command.</para>
<screen>asadmin> <userinput>create-connector-security-map --user admin 
--passwordfile pwd_file.txt --poolname connector-pool1 --principals principal1, principal2 --mappedusername backend-username securityMap1
</userinput>
Command create-connector-security-map executed successfully</screen>
</example>
</refsect1>
<refsect1 role="exit-status"><title></title>
<variablelist termlength="medium">
<varlistentry><term>0</term>
<listitem><para> command executed successfully</para>
</listitem>
</varlistentry>
<varlistentry><term>1</term>
<listitem><para> error in executing the command</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="see-also"><title></title>
<para><olink targetdoc="asrefman" targetptr="delete-connector-security-map-1">delete-connector-security-map(1)
</olink>, <olink targetdoc="asrefman" targetptr="list-connector-security-maps-1">
list-connector-security-maps(1)</olink>, <olink targetdoc="asrefman"
targetptr="update-connector-security-map-1">update-connector-security-map(1)</olink></para>
</refsect1>
</refentry>
<?Pub *0000005830 0>
