Skip to content

Lab 9 - Unlock additional ports

What you will learn

  • Understanding of metrics, healthcheck, and management.
  • How to configure functional accounts.

Before you begin

Your Domino server must be running.

Procedure

  1. Create a JSON file in the keepconfig.d directory and provide it with any filename, such as portmagic.json.
  2. Add the following content in the JSON file:

    {
      "DEBUG": true,
      "identity": {
        "healthcheckAPI": {
          "health": {
            "active": true,
            "secret": "FA1D8FC7DAA715F20A3C19F62451DCD011483EFBABE46A1C03F2CF0702365726:0A2AC2338974379073BEF880B2EA9E4FE86651974C83D3958DB73C81047CF3815456678A3EE206975CE17B7874589478A2FC92DCDF2C1794087AED94BF8FD4CA"
          }
        },
        "managementAPI": {
          "Doctor Notes": {
            "active": true,
            "secret": "FA1D8FC7DAA715F20A3C19F62451DCD011483EFBABE46A1C03F2CF0702365726:0A2AC2338974379073BEF880B2EA9E4FE86651974C83D3958DB73C81047CF3815456678A3EE206975CE17B7874589478A2FC92DCDF2C1794087AED94BF8FD4CA"
          }
        },
        "metricsAPI": {
          "metrics": {
            "active": true,
            "secret": "FA1D8FC7DAA715F20A3C19F62451DCD011483EFBABE46A1C03F2CF0702365726:0A2AC2338974379073BEF880B2EA9E4FE86651974C83D3958DB73C81047CF3815456678A3EE206975CE17B7874589478A2FC92DCDF2C1794087AED94BF8FD4CA"
          }
        }
      },
      "metrics": {
        "enabled": true,
        "jvmMetricsEnabled": true
      }
    }
    

    Note

    • The secret FA1D8FC7DAA715F20A3C19F62451DCD011483EFBABE46A1C03F2CF0702365726:0A2AC2338974379073BEF880B2EA9E4FE86651974C83D3958DB73C81047CF3815456678A3EE206975CE17B7874589478A2FC92DCDF2C1794087AED94BF8FD4CA is the result of salting the password supersecret.
    • Never use the password supersecret in production or externally reachable servers as it is weak and not a good password to use.
  3. Restart Domino REST API.

How to verify

To verify access using the functional accounts, navigate to the following URLs. You will be prompted for basic authentication. Enter the username corresponding to the key specified in the JSON file and the password supersecret.

Things to explore

Next step

Proceed to Lab 10 - Configure JWT.