Preparation
What you will need to prepare in advance of implementing the 1E ITSM 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 ITSM Connect, please refer to 1E Core 2.1 - Welcome for more details on the 1E Core application.
Installing Tachyon
For information on installing Tachyon, please refer to Tachyon 8.1 - Implementing Tachyon (depending on your version).
Installing and configuring 1E Core
Please refer to the 1E Core 2.1 - Preparation page for more details on preparing the 1E Core application. In that documentation, you will need to follow the instructions for the following:
Disable Tachyon Two-factor Authentication.
Check your Tachyon License.
Enable basic authentication for the Consumer node of the Tachyon website.
Add the 1EServiceNowCore Consumer.
Bypass approval for the 1EServiceNowCore Consumer in the Tachyon database.
Add the ITSM Connect app proxy user to Tachyon
ServiceNow's users that log in to the 1E ITSM Connect app will actually be interacting with Tachyon using a proxy user that is configured on the 1E ITSM Connect app's App Configuration page. This proxy user retrieves and executes instructions and fetches responses from Tachyon using Tachyon's API and the consumer added above.
In our example we will add a user to Tachyon, which must already exist in AD, that will have the following function and the following system roles applied:
Proxy User account | Function | Assigned Tachyon role |
|---|---|---|
ACME\ITSMConnectUser | Tachyon user | Global 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 a custom role in Tachyon and assigning specific instruction sets and management groups to the role.
Note
Please refer to:
Design Considerations to understand more about app roles, their proxy users, Tachyon roles, instruction sets and management groups
Tachyon 8.1 - The Permissions Menu for details on how to permission roles in Tachyon.
1E ITSM Connect post-installation tasks: App Configuration Page for details on how to configure proxy users in ServiceNow
User Management for information on how to set up users in ServiceNow.
Check your Tachyon license
If you intend to utilize the Experience features of Tachyon, you need to have a suitable license with the Experience consumer added to it. Without this, you will not get the Experience features in 1E ITSM Connect.
If you have not yet installed Tachyon, then you will need to obtain a Tachyon license file, and check it as follows:
Open your Tachyon.lic license file using Notepad.
Confirm the following exist in the features section:
Feature name="Experience"
Consumer name="Experience" enable="on"
If it is not there, then you should contact SalesOps@1e.com to get an updated license file.
<Consumer name="Experience" enable="on"> </Consumer>
If you have already installed Tachyon, check your license as follows:
Login to Tachyon as a Global Administrator, using the Settings app, and navigate to Configuration→License information page.
Check that a feature with the name Experience exists there.
If it is not there, then you should contact SalesOps@1e.com to get your license enhanced.
If your Tachyon system has access to the 1E Licensing service via the Internet, then your license will be updated automatically.
Adding the ITSM Connect app Tachyon user account as a Tachyon user
To configure the Tachyon user:
Login to Settings app using a Tachyon user account that has at least the following administrator rights:
Permission Administrators role
Navigate to Permissions→Users.
Click the Add button. A popup window will open.
In the Add user popup, type in some characters from the name of the user you want to add. In our example our account has the letters ITSM in.
Tachyon will return a list of any matching users from AD.
Select the one you want from the list. In our example it is ITSMConnectUser.
Once you have selected the user click on Add button.
Now that the user has been added, click the user name then click on Edit button.
Select the Actioner role you want the user to have. In our example we want this user to be able to action all Tachyon instructions, so we select the Global Actioners role.
Select the Experience Viewers role. This role is required to get Experience data from Tachyon.
Once the roles have been selected click Save. You should see the Global Actioners, Experience Viewers roles in the role list.
