Contents

Preparation


Summary

What you will need to prepare in advance of implementing the 1E Service Catalog Connect app. Typically, these are tasks that may take some time to organize, depending on how your organization works. A more complete checklist of tasks is provided in the Requirements page.

You must install and configure 1E Core prior to installing and configuring 1E Service Catalog Connect.

On this page:

Add the Service Catalog Connect app user to Tachyon

ServiceNow users that log in to the 1E Service Catalog Connect app will actually be interacting with Tachyon using a user account that is configured on the 1E Service Catalog Connect app's Tachyon Settings page. This user retrieves, executes and approves instructions and fetches responses from Tachyon using Tachyon's API and the consumer added above.

In our example, we will add the user to Tachyon. The user must already exist in AD and the username must have a maximum length of 20. The added account  will have the following function and the following system roles applied:

User accountFunctionAssigned Tachyon role
Contoso\ServCatConnect Tachyon userGlobal Actioners

System (global) roles allow access to all instruction sets and all devices. We could define more granular permissions using custom roles instead of system roles. This would involve creating the custom role in Tachyon and assigning specific instruction sets and management groups, ensuring both roles are configured with an instruction set and management group. 

Please refer to:

Adding the Service Catalog Connect app Tachyon user account as a Tachyon user

To configure the Tachyon user:

  1. Login to Tachyon Settings app using a Tachyon user account that has at least the following rights:

    • Permission Administrators role
  2. Navigate to Permissions→Users.
  3. Click the Add button.

  1. Type in some characters from the name of the user you want to add. In our example the account has the letters Serv in it.
  2. Select the account (ServCatConnect in our example).

  3. Click the Add button.

  1. Now that the user has been added, click the Roles node under the Permissions.

  2. Click on the Global Actioners role name.

  1. Select the Members tab.

  2. Type in some characters from the name of the user you want to add. In our example the account has the letters Serv in it.

  3. Click the Add button.

  1. The user will then appear in the list of users for the role.

Add the WSA Instruction to Tachyon

1E Service Catalog Connect runs a Tachyon instruction to invoke the WSA wizard. That instruction must be uploaded into Tachyon so that it is available to run on clients. To add the instruction:

  1. Obtain the product pack either directly from the 1E Service Catalog Connect Product Pack page on Tachyon Exchange: https://tachyonexchange.1e.com/product-packs/1e-service-catalog-connect-product-pack/ or go to  https://tachyonexchange.1e.com and search for "WSA"
  2. Download the product pack.

  1. Upload the product pack to Tachyon, following the Tachyon 5.0 - Tachyon instructions: Instruction sets page.

    • You can put the instruction from the product pack into an instruction set of your choice.

Configuring Shopping

The following are required after installing Shopping.

Enable Basic Authentication

Access to Shopping by third-party applications is commonly done through Shopping's web site. To allow the ServiceNow Shopping user account to access Shopping you need to enable basic authentication on the Shopping web site in IIS.

For convenience the following script is provided that ensures that the basic authentication role is installed, enabled and then applied to the Tachyon Consumer API:

 View EnableBasicAuthentication.ps1 ...

Download...

Enable Basic Authentication using PowerShell
<# 1E Ltd Copyright 2019
    Disclaimer:
    Your use of this script is at your sole risk. This script is provided "as-is", without any warranty, whether express
    or implied, of accuracy, completeness, fitness for a particular purpose, title or non-infringement, and is not
    supported or guaranteed by 1E. 1E shall not be liable for any damages you may sustain by using this script, whether
    direct, indirect, special, incidental or consequential, even if it has been advised of the possibility of such damages.
#>

Import-Module ServerManager

Write-Host ''
Write-Host 'Enable Basic Authentication'
Set-WebConfigurationProperty -filter "/system.webServer/security/authentication/BasicAuthentication" -name Enabled -value True -PSPath "IIS:\" -location "Shopping/Shopping"
Write-Host 'Done'

If you prefer to run the steps by hand these are as follows:

This is done in two steps:

  • As for 1E Core's use of Tachyon, ensure that the Basic Authentication role is installed for IIS.
  • Use the IIS Manager console to enable Basic Authentication on the Shopping web application in the Shopping website.


  1. Navigate to the Sites→Shopping→Shopping node.

  2. Double-click the Authentication feature.

  3. Right-click on Basic Authentication and select the Enable option from the context menu.

Configure Shopping Settings


  1. Open the Shopping Admin console.
  2. Go to Settings.

  3. Navigate to the WSA property section.

    1. Enter your ServiceNow instance URL in the value field of Alternative Urls property.
      • If you want to give multiple URLs, separate them using the pipe character ('|').
    2. Set Firefox support enabled to true if you expect some of your users will use the Firefox web browser.
    3. Enter a user name with domain name in the value field of Sync WSA Orders Account.
      • This user will be used in Shopping User field on the Shopping Settings page of 1E Service Catalog Connect app.
    4. Adjust the WSA System Folder Exclusions if necessary.

  4. Navigate to the Web Application property section

    1. Ensure the value of 1E Tachyon Agent loopback URL starts with https . By default this value is set to http. This is required when Shopping is on HTTPS and 1E Client talks to Shopping on HTTPS. If shopping is on HTTP then there is no need to change HTTP to HTTPS.
  5. Click on the Save button.