You can run a workflow to add a REST host and configure the host connection parameters.

Procedure

  1. Log in to the Orchestrator client as an administrator.
  2. Click the Workflows view in the Orchestrator client.
  3. In the workflows hierarchical list, expand Library > HTTP-REST > Configuration and navigate to the Add a REST host workflow.
  4. Right-click the Add a REST host workflow and select Start workflow.
  5. In the Name text box, enter the name of the host.
  6. In the URL text box, enter the address of the host.
    Note:

    The Kerberos authentication requires a Fully Qualified Domain Name (FQDN) host address.

  7. In the Connection timeout text box, enter the number of seconds before a connection times out.
  8. In the Operation timeout text box, enter the number of seconds before an operation times out.
  9. Select Yes to accept the REST host certificate.

    The certificate is added to the Orchestrator server trust store.

  10. Select the authentication type.

    Option

    Description

    None

    No authentication is required.

    OAuth 1.0

    Provide the required authentication parameters.

    OAuth 2.0

    Provide the authentication token.

    Basic

    Provides basic access authentication.

    Select the session mode.

    • If you select Shared Session, provide credentials for the shared session.

    • If you select Per User Session, the Orchestrator client retrieves credentials from the user who is logged in.

    Digest

    Provides digest access authentication that uses encryption.

    Select the session mode.

    • If you select Shared Session, provide credentials for the shared session.

    • If you select Per User Session, the Orchestrator client retrieves credentials from the user who is logged in.

    NTLM

    Provides NT LAN Manager (NTLM) access authentication within the Window Security Support Provider (SSPI) framework.

    Select the session mode.

    • If you select Shared Session, provide credentials for the shared session.

    • If you select Per User Session, the Orchestrator client retrieves credentials from the user who is logged in.

    Provide the NTLM settings.

    Kerberos

    Provides Kerberos access authentication.

    Select the session mode.

    • If you select Shared Session, provide credentials for the shared session.

    • If you select Per User Session, the Orchestrator client retrieves credentials from the user who is logged in.

  11. To use a proxy, enter the address and the port of the proxy server.
    1. (Optional) : Select the proxy authentication type.

      Option

      Description

      None

      No authentication is required.

      Basic

      Provides basic access authentication.

      Select the session mode.

      • If you select Shared Session, provide credentials for the shared session.

      • If you select Per User Session, the Orchestrator client retrieves credentials from the user who is logged in.

  12. Select whether you want the target hostname to match the name stored in the server certificate.
  13. (Optional) : Select a keystore entry to use to authenticate against the server. The keystore entry must be of the PrivateKeyEntry type.
  14. Click Submit to run the workflow.

Results

After the workflow runs successfully, the REST host appears in the Inventory view.

What to do next

You can add operations and XSD schema to the REST host, and run workflows from the Inventory view.