You can add an endpoint and configure the HTTP-REST plug-in to connect to a REST host.

Before you begin

  • Log in to the vRealize Automation console as a tenant administrator.

  • Verify that you have access to a REST host.

About this task

Procedure

  1. Select Administration > Endpoints > OrchestratorEndpoints.
  2. Click the New icon (Add).
  3. Select HTTP-REST from the Plug-in drop-down menu.
  4. Click Next.
  5. Enter a name and, optionally, a description.
  6. Click Next.
  7. Provide information about the REST host.
    1. Enter the name of the host in the Name text box.
    2. Enter the address of the host in the URL text box.
      Note:

      If you use Kerberos access authentication, you must provide the host address in FDQN format.

    3. (Optional) : Enter the number of seconds before a connection times out in the Connection timeout (seconds) text box.

      The default value is 30 seconds.

    4. (Optional) : Enter the number of seconds before an operation times out in the Operation timeout (seconds) text box.

      The default value is 60 seconds.

  8. (Optional) : Configure proxy settings.
    1. Select Yes to use a proxy from the Use Proxy drop-down menu.
    2. Enter the IP of the proxy server in the Proxy address text box.
    3. Enter the port number to communicate with the proxy server in the Proxy port text box.
  9. Click Next.
  10. Select the authentication type.

    Option

    Action

    None

    No authentication is required.

    OAuth 1.0

    Uses OAuth 1.0 protocol. You must provide the required authentication parameters under OAuth 1.0.

    1. Enter the key used to identify the consumer as a service provider in the Consumer key text box.

    2. Enter the secret to establish ownership of the consumer key in the Consumer secret text box.

    3. Enter the access token that the consumer uses to gain access to the protected resources in the Access token text box.

    4. Enter the secret that the consumer uses to establish ownership of a token in the Access token secret text box.

    OAuth 2.0

    Uses OAuth 2.0 protocol.

    Enter the authentication token in the Token text box.

    Basic

    Provides basic access authentication. The communication with the host is in shared session mode.

    1. Enter the user name for the shared session in the Authentication user name text box.

    2. Enter the password for the shared session in the Authentication password text box.

    Digest

    Provides digest access authentication that uses encryption. The communication with the host is in shared session mode.

    1. Enter the user name for the shared session in the Authentication user name text box.

    2. Enter the password for the shared session in the Authentication password text box.

    NTLM

    Provides NT LAN Manager (NTLM) access authentication within the Window Security Support Provider (SSP) framework. The communication with the host is in shared session mode.

    1. Provide the user credentials for the shared session.

      • Enter the user name for the shared session in the Authentication user name text box.

      • Enter the password for the shared session in the Authentication password text box.

    2. Configure the NTLM details

      • Enter the workstation name in the Workstation for NTLM authentication text box.

      • Enter the domain name in the Domain for NTLM authentication text box.

    Kerberos

    Provides Kerberos access authentication. The communication with the host is in shared session mode.

    1. Enter the user name for the shared session in the Authentication user name text box.

    2. Enter the password for the shared session in the Authentication password text box.

  11. Click Finish.

Results

You configured the endpoint and added a REST host. XaaS architects can use XaaS to publish HTTP-REST plug-in workflows as catalog items and resource actions.