Requirements

Information that will help you design and plan the implementation of the 1E Service Catalog Connect app in your organization. This includes all the prerequisites and dependencies that are necessary to install the 1E Service Catalog Connect app.

This page is part of the design phase of implementation.

1E requirements

Category

Requirement

More details

1Esystem

(Basic Authentication)

  • A complete infrastructure of 1E (on-premises) is required, either in a local network or hosted over the internet. This includes the 1E Client, deployed to all devices that you need to manage.

  • The Basic Authentication feature (if applicable) must be installed on the 1E Platform Server (Master Stack), and enabled in the Consumer web application.

1E Platform on-premises (9.x)

1E system

(Modern Authentication)

  • A complete infrastructure of 1E (SaaS) is required, either in a local network or hosted over the internet. This includes the 1E Client, deployed to all devices that you need to manage.

  • The Modern Authentication is to be setup either using Microsoft Entra ID or Okta for external IdP.

1E Platform SaaS

1E consumer

  • A consumer with the name 1EServiceNowCore must be registered in the 1E Settings application, Configuration, Consumers page.

  • When you add the consumer name, it will create an entry in the dbo.Consumer table of the Tachyon Master database. You must follow the instructions given in the link opposite to change the consumer's Workflow setting in the database to the following value:

    Copy
    [{"ReferenceType":0,"InstructionWorkflow":[{"InstructionType":1,"Workflow":{"StateMachine":"State"}}]}]

Adding the ServiceNow consumer

1E administrator

  • One or more 1E users are assigned the following role(s) for the following purposes. Users must be AD domain accounts.

Purpose

Roles in 1E 9.0/23.7

Roles in 1E 8.1

Register the 1EServiceNowCore consumer

1E ITSM Connect Actioner

Full Administrator

Upload instruction definitions and create instruction sets

1E ITSM Connect Actioner

Full Administrator

Create 1E users and assign them to roles, create custom roles, and assign them to some instruction sets and management groups

1E ITSM Connect Actioner

Full Administrator or Group Administrator

Create Management groups if desired

1E ITSM Connect Actioner

Full Administrator or Group Administrator

  • Additional 1E Platform roles are required by other 1E ServiceNow apps.

Permissions

1E license

  • Your 1E Platform license must include the 1EServiceNowCore consumer in the ServiceNow Integration feature tag as following:

    Copy
    <Feature name="ServiceNow-Integration">
    <Consumer name="1EServiceNowCore" enable="on">
    </Consumer>
    </Feature>

You can also verify this information in the 1E Settings app by navigating to Configuration → License Information. Scroll down to Products section and check whether 1EServiceNowCore is present as a feature item.

1E Platform on-premises (9.x)

ServiceNow requirements

Category

Requirement

More details

ServiceNow

  • A working ServiceNow instance must be set up. This can be a demo instance or a production/vendor instance.

  • The application supports the latest ServiceNow releases. For more details on the supported releases, refer to Compatibility matrix for 1E and ServiceNow integration applications.

  • If you are using this application in multi-tenant mode (domain separation), please enable the Domain Support plugin on your ServiceNow instance.

App Installation

1E Core

Install the latest version of 1E Core application into your ServiceNow instance. Request the latest version of 1E Core from the ServiceNow Store.

 

MID Server

(Basic Authentication)

  • If the 1E instance is not hosted over the internet, then a MID Server must be installed on the same network domain where the 1E server is installed.

Refer to your ServiceNow documentation for details on installing a MID Server.

MID Server

ServiceNow users

  • At least one ServiceNow user for each of the roles in the following table:

Role name

Additional ServiceNow roles required

Description

x_1e_service_catal.shopping_admin

n/a

This role allows its users to configure the 1E Service Catalog Connect app, in addition to having the same rights as the x_1e_service_catal.shopping_user role.

ServiceNow admin users must change their application scope to 1E Service Catalog Connect in order to configure the app.

x_1e_service_catal.shopping_user

n/a

This role grants its users to select catalog items tied with 1E instructions.

 

Users and roles

 

Post-Installation Tasks

 

User Management

 

ServiceNow admin

This role allows its users to install and configure the 1E Service Catalog Connect app.

App Installation

ServiceNow certificate (Modern Authentication)

  • The input certificate for Modern Authentication is a standard .pfx file containing a private key, hence it requires conversion from .pfx to .PEM and .JKS.

  • App ID is required and is provided by your 1E instance.

  • Client certificates (in .PEM and .JKS format) and App ID are required, in case the application's authentication mechanism is set to Modern Auth. Also create a JWT key and associate it with the JKS certificate. Similarly, create JWT provider and associate it with the JWT key.

Preparation of Modern Authentication