2.20.4 create-connector-security-map

Synopsis

asadmin [asadmin-options] create-connector-security-map [--help]
    --poolname connector_connection_pool_name
    [--principals principal-name1[,principal-name2]...]
    [--usergroups user-group1[,user-group2]...]
    --mappedusername user-name mapname

Storage location

Application Server installation directory/javaee/glassfish/bin

Function

The create-connector-security-map subcommand creates a security map for the specified connector connection pool. If the security map is not available, a new one is created. This command can also map the caller identity of the application (principal or user group) to a suitable Enterprise Information System (EIS) principal, in container-managed authentication scenarios. One or more named security maps can 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. To specify the EIS password,AS_ADMIN_MAPPEDPASSWORD entry can be added to the password file, then specify the file by using the --passwordfile asadmin utility option. This command is supported in remote mode only.

For this command to succeed, a connector connection pool using the create-connector-connection-pool subcommand has to be created.

Precondition

DAS has to be in a running state.

Arguments

--help | -?

Displays the help text for the subcommand.

--poolname connector_connection_pool_name

Specifies the name of the connector connection pool to which the security map belongs.

Type: String

The following values can be specified:

• Pool name

Default value: N/A

--principals principal-name1[,principal-name2]...

Specifies a list of backend EIS principals.

• Use either the --principals or --usergroups options, but not both in the same command.

• More than one principal can be specified using a comma separated list.

Type: String

The following values can be specified:

• Backend EIS principle name

Default value: N/A

--usergroups user-group1[,user-group2]...

Specifies a list of backend EIS user group.

• Use either the --principals or --usergroups options, but not both in the same command.

• More than one user groups can be specified using a comma separated list.

Type: String

The following values can be specified:

• EIS user group

Default value: N/A

--mappedusername user-name

Specifies the EIS username.

Type: String

The following values can be specified:

• User name

Default value: N/A

mapname

Specifies the name of the security map to be created.

Type: String

The following values can be specified:

• Name of map

Default value: N/A

asadmin create-connector-security-map --poolname connector-pool1
--principals principal1,principal2 --mappedusername backend-username 
securityMap1

Exit Status

Exit Status	Explanation
0	command executed successfully.
1	error in executing the command.