Using Niagara SCRAM-SHA authentication

The default authenticator on a Niagara users credentials is SCRAM-SHA Digest, which is a more complex variant of Digest authentication.
Prerequisites: You are working in Workbench and are connected to the station with an HttpClientNetwork.
  1. Double-click HttpClient and expand Address.
    The Property Sheet opens.
    Image

    In this example, the address has been changed to a url protected by digest auth.

  2. Set Mode to Secure and Path, for example, to /ord/station:%7Cslot:/.
  3. Expand Config > Drivers > HttpClientNetwork, double-click the HttpClientDevice and expand Authenticator.
    The properties expand.
    Image
  4. Select HttpScramShaDigestAuth from the Auth Type drop-down list and click Save
    The driver updates the Config options.
  5. Expand Config and set up Credentials (Username and Password) and click Save.
    We do not recommend the use of admin accounts for this utility.
  6. Right-click HttpClient and click Actions > Send.
    The driver sends the request and the Out slot reports success.
    Image

    The read-only hasSession property populates on a successful connection.

    It automatically becomes invalid if the session becomes inactive or it expires. In this instance, the client receives a 401 error and automatically repeats the SCRAM-SHA handshake on the next request attempt.

  7. To manually clear the session, right-clickAuthenticator > Config and click Actions > Clear Session.