Configuring HTTP basic authentication for an integration node or server

You configure HTTP basic authentication for your IBM® App Connect Enterprise integration node or server by modifying properties in a node.conf.yaml or server.conf.yaml configuration file. .

Before you begin

  • Start an instance of the IBM App Connect Enterprise command console. You can use the console to create a username and password by issuing the mqsiwebuseradmin command.

Procedure

  1. Use a YAML editor to open the .yaml configuration file for your integration node or server.

    If you do not have access to a YAML editor, you can edit the file by using a plain text editor; however, you must ensure that you do not include any tab characters, which are not accepted in YAML and would cause your configuration to fail. If choose to use a plain text editor, ensure that you use a YAML validation tool to validate the content of your file.

    For more information about working with YAML, see http://www.yaml.org/start.html.

  2. Uncomment the following line in the .yaml file:
    #basicAuth: true       # Clients require a web username and password
  3. Save the .yaml file.
    The properties that you set in the .yaml file take effect when the integration node or server is started. If you modify these properties again, you must also restart the integration node or server.
  4. In the IBM App Connect Enterprise command console, create a username and password by issuing the mqsiwebuseradmin command.
    For example:
    mqsiwebuseradmin -w c:\workdir\ACEServ1 -u admin -a password -c
    You can create multiple users; the permissions are identical for all users.
  5. Restart the integration node or server for the changes to take effect.

What to do next

When you manage your integration node or server, or the resources that are deployed to it, by using either the IBM App Connect Enterprise Toolkit or web user interface, you are prompted to enter the username and password that you have created in this task in addition to the host name and port number of the integration node or server. When you use the IBM App Connect Enterprise Toolkit to create a connection to the integration node or server, you can optionally save the password to the Eclipse Secure Storage by selecting the Save Password check box in the Create connection wizard.