Configuring the Nomad server when you configure SafeLinx

In order to set up the Nomad server, you first have to create a SafeLinx LDAP server configuration, which is used in a SafeLinx authentication profile. The authentication profile is in turn used in an SafeLinx http-service to define the authentication sources for the Nomad server.

1. Add a Directory Server:
   
   
   
   • Common name: Defines the name of the SafeLinx Directory Server configuration that you are creating here. This is a free text field.
   • Host name: Should be the FQDN of the Domino LDAP server you are connecting to. In this example, it is "dominoldap.example.com".
   • Base distinguished name (DN): Defines the base within the LDAP tree of the Domino server below which searches start.
   Note: Make sure to specify a base DN where LDAP searches can find user AND server entries. For example, if you have users in "OU=USERS/O=DEMO" and servers in "OU=SERVERS/O-DEMO" that you have to specify "O=DEMO" as the base DN.
2. Configure LDAP bind user:
   
   
   
   • Port number of service is 389 for plan ldap. Change if you want to use secure ldap or your LDAP servers listens on another port.
   • Administrator's distinguished name (DN) is the DN of a user in the Domino Directory, that has read access to the directory via LDAP (eg. CN=Nomad Binduser,O=EXAMPLE).
   • Password for above mentioned user
   • (Recommended) Select Use secure connection and configure that section to use ldaps. See Securing communications with an LDAP server in the HCL SafeLinx documentation for more details.
   Note: For security reasons, configuring the SafeLinx LDAP service to bind anonymously to search the Domino LDAP directory is not recommended. However, should you need to bind anonymously for some reason, you must allow the LDAP service to access specific attributes. See Configuring the SafeLinx LDAP service for Nomad to bind anonymously for more details.
3. OU verification:
   
   
   

See Adding LDAP-bind authentication profiles for more details on each field in the following screens.

1. Add a new Authentication Profile:
   
   
   
   • "Request Windows credentials from GINA" has to be unchecked.
   • "Common name" specifies the name of the authentication profile. Choose a descriptive name.
   • "Description" can be left empty.
   • Set "password policy" to "None" as we will use the LDAP server specified in the previous step to verify credentials.
   • Leave "Challenge string" empty.
   • Leave "Include realm in authentication request" unchecked
2. Specify Directory Servers:
   
   
   
   • Select the "Domino LDAP" entry defined in the previous step as the "Directory Server'.
   • "User key field" specifies the LDAP attributes to query to identify a user for authentication. Per default, users can log in by specifying their email adress. If you want to allow more fields like "uid" or "cn", you can add them as as comma separated list. For example: mail,uid,cn.
   • Leave the other fields at their default value
3. LTPA configuration:
   
   
   

   Leave the LTPA configuration disabled.

4. OU verification:
   
   
   

1. Add a Nomad server:
   
   
   
   • Specify the service URL that end-users will use to access Nomad Web (eg. "https://nomad.example.com"). This name can differ from the hostname of the SafeLinx server.
   • As Nomad server requires https, the "TCP port to listen on" is 443.
   • Specify the prepared keystore in the "PKCS12 keystore file" field. Relative paths start in the SafeLinx binary directory.
   • Enter the password for the private key stored in the pkcs12 file in the "Keystore password" field
   • Leave "Current state" on "active" to automatically start the Nomad server
2. Add Application Server URLs:
   
   
   • For the "Authentication Profile" select the authentication profile you defined.
   • For the "Session COOKIE domain", use the DNS domain part of the hostname you used for "Service URL" in the previous screen. In this example, it's `example.com´.
   In addition to that, the minimum necessary data entry for this form is the mapping for the Nomad web static files.

   Note: The Nomad web static files are needed only if you use Nomad for web browsers. They are not needed if you only use Nomad on iOS or Android.

   With the "Application Server URL"s entries described in the following, you instruct SafeLinx/Nomad server to respond to HTTPS requests starting with /nomad by either returning the files from the local directory or pass the http request on to the Domino HTTP server in the backend.

   The keyword designation "NOMAD" signals to the underlying SafeLinx server to interpret the defined application server as belonging to "Nomad". See URLs with keyword designations in the HCL SafeLinx documentation for details.

   You specify application server URLs in the following format:

   [ <KEYWORD> | <Map> ] URL

   So for the Nomad Web static files this would generally be:

   NOMAD /nomad URL

3. Configure the Nomad web static files:
   • Static files stored on SafeLinx: In this case, the URL part of the "Application Server URL" always starts with the file:// protocol, followed by the full path to the directory containing the nomad directory you created earlier.

     Linux

     If you followed the instructions for Linux in Hosting the static web files on SafeLinx, you need to add a line similar to this to the Nomad server configuration as a "Application Server URL":

     NOMAD /nomad file:///srv/hcl

     If you decided on a different path for your Nomad static files, modify the statement accordingly.
     
     
     

     Windows

     If you followed the instructions for Linux in Hosting the static web files on SafeLinx, you need to add a line similar to this to the Nomad server configuration as a "Application Server URL":

     NOMAD /nomad file://C:/hcl

     If you decided on a different path for your Nomad static files, modify the statement accordingly.

     
     
     
   • Static files stored on Domino HTTP server: Add a line similar to this to the Nomad server configuration as a "Application Server URL":

     NOMAD /nomad http://domino12cent8.example.com/

     If you decided on a different path for your Nomad static files, modify the statement accordingly.

     
     
     
4. Add Domino server mappings (optional):
   • If Domino and Domino LDAP are configured correctly, no further entries are needed in "Application Server URL" form.
   • You can optionally add the Domino name and FQDN of any Domino server that cannot be resolved through lookups in the Domino LDAP server defined earlier for authentication.
   • You can optionally add the Domino name and FQDN of any Domino server for users that do not have an home mail server defined.
   Use the following format for the entries:

   NOMAD CN=Domino9Apps/OU=SRV/O=EXAMPLE/C=XP  
   nrpc://mydominoapplicationserver.example.com:1352

   Where mydominoapplicationserver.example.com is the FQDN (or IP address) of the Domino server Domino9Apps specified in this example.

   
   
   

lswg -s ibm-wlHttpService -L -F cn:state -l cn=nomad-web-proxy0,cn=safelinx.example.com,o=nwp

dn: cn=nomad-web-proxy0,cn=safelinx.example.com,o=nwp
cn: nomad-web-proxy0
state: 0