Administering Non-default Message Security Providers

The following topics are addressed here:

• To Create a Message Security Provider

• To List Message Security Providers

• To Update a Message Security Provider

• To Delete a Message Security Provider

To Create a Message Security Provider

Use the create–message–security–provider subcommand in remote mode to create a new message provider for the security service. If the message layer does not exist, the message layer is created, and the provider is created under it.

1. Ensure that the server is running.

   Remote subcommands require a running server.

2. Create the message security provider by using the create-message-security-provider(1) subcommand.

   Information about properties for this subcommand is included in this help page.

3. (Optional)

   If needed, restart the server.

   Some properties require server restart. See Configuration Changes That Require Server Restart. If your server needs to be restarted, see To Restart a Domain.

Creating a Message Security Provider

This example creates the new message security provider mySecurityProvider.

asadmin> create-message-security-provider 
--classname com.sun.enterprise.security.jauth.ClientAuthModule --providertype client mySecurityProvider
Command create-message-security-provider executed successfully.

See Also

You can also view the full syntax and options of the subcommand by typing asadmin help create–message–security–provider at the command line.

To List Message Security Providers

Use the list–message–security–providers subcommand in remote mode to list the message providers for the security layer.

1. Ensure that the server is running.

   Remote subcommands require a running server.

2. List the message security providers by using the list-message-security-providers(1) subcommand.

Listing Message Security Providers

This example lists the message security providers for a message layer.

asadmin> list-message-security-providers --layer SOAP
XWS_ClientProvider 
ClientProvider
XWS_ServerProvider
ServerProvider
Command list-message-security-providers executed successfully.

See Also

You can also view the full syntax and options of the subcommand by typing asadmin help list–message–security–providers at the command line.

To Update a Message Security Provider

1. Ensure that the server is running.

   Remote subcommands require a running server.

2. List the message security providers by using the list-message-security-providers(1) subcommand.

3. Modify the values for the specified message security provider by using the set(1) subcommand.

   The message security provider is identified by its dotted name.

To Delete a Message Security Provider

Use the delete-message-security-provider subcommand in remote mode to remove

1. Ensure that the server is running.

   Remote subcommands require a running server.

2. List the message security providers by using the list-message-security-providers(1) subcommand.

3. Delete the message security provider by using the delete-message-security-provider(1) subcommand.

Deleting a Message Security Provider

This example deletes the myServerityProvider message security provider.

asadmin> delete-message-security-provider --layer SOAP myServerityProvider
Command delete-message-security-provider executed successfully.

See Also

You can also view the full syntax and options of the subcommand by typing asadmin help delete–message–security–provider at the command line.