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

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

You can edit the file by using the built-in YAML editor that is provided in the IBM App Connect Enterprise Toolkit, either by double-clicking the file in the Application Development view or by right-clicking the file and selecting Open with > YAML editor. If you choose to edit the file by using a plain text editor, ensure that you do not include any tab characters (which are not valid in YAML) and use a YAML validation tool to validate the contents of your file.

For more information about working with YAML, see http://www.yaml.org/start.html.
Uncomment the following line in the .yaml file, by removing the # from the beginning of the line:
```
#basicAuth: true       # Clients require a web username and password
```
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.
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.
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.