VoltConfig Credentials Provider

The VoltConfig Credentials Provider provides a mechanism that allows user name and password credentials to be provided to a Service Transport without being hardcoded within the Service Description. The credentials are defined by the Volt server administrator and are associated with an alias that is used in the Service Description.

Use the VoltConfig Credentials Provider when a Service Description needs to define a static set of credentials - it is typically used to access a backend resource or service, and is not specific to a particular user starting the service.

Configuring the VoltConfig Credentials Provider

To use the VoltConfig Credentials Provider, the Volt administrator must first define a user identity (User name, Password, and alias name) within the Volt configuration database (VoltConfig.nsf). To do this, complete the following steps:
  1. Use the HCL Notes client to open VoltConfig.nsf.
  2. Select the All Service Credentials view.
  3. Select New Credential Set.
  4. Enter the alias.
  5. OPTIONAL: Complete the Description field. The intent of this field is to help you remember the purpose of these credentials. As an example, "Credentials for the Acme Widget API".
  6. Enter the User name.
  7. Enter the Password.
  8. Select Done and choose to save the credentials.

When you save your credentials, the user name and password fields are automatically encrypted. Another administrator of the same VoltConfig database cannot read the encrypted data unless you have added them to the Consumers field. However, all administrators may read the credentials alias and description.

Using the VoltConfig Credentials Provider in a Service Description

The provider ID for the VoltConfig Credentials Provider to enter in a Service Description is: voltConfig.

Credentials Provider Parameters

Name Description Mandatory Default
alias The alias name of a user identity that contains the credentials that are required for the Service Description. This value must match the alias of a credentials set in VoltConfig.nsf. Yes N/A

Sample Service Description

<serviceDescription>
  <id>make-http-request</id>
  <defaultLocale>en-us</defaultLocale>
  <transportId>HTTPServiceTransport</transportId>
  <name xml:lang="en-us">Make an HTTP Request</name>
  <description xml:lang="en-us">Makes an HTTP request to the configured URL and returns the result</description>
  <credentials providerId="voltConfig">
    <property name="alias" value="Acme Widgets"/>
  </credentials>
  <inbound>
    <parameters>
      <parameter>
        <id>request-url</id>
        <name xml:lang="en-us">URL</name>
        <description xml:lang="en-us">URL to request.</description>
        <mandatory>true</mandatory>
        <type>STRING</type>
      </parameter>
      <parameter>
        <id>request-method</id>
        <name xml:lang="en-us">Method</name>
        <description xml:lang="en-us">HTTP method to use, one of GET, PUT, POST, or DELETE.</description>
        <mandatory>true</mandatory>
        <type>STRING</type>
      </parameter>
    </parameters>
  </inbound>
  <outbound>
    <parameters>
      <parameter>
        <id>response-entity</id>
        <name xml:lang="en-us">Response</name>
        <description xml:lang="en-us">Response returned by making a request to the configured URL.</description>
        <mandatory>false</mandatory>
        <type>STRING</type>
      </parameter>
    </parameters>
  </outbound>
</serviceDescription>