Skip to navigation

Access Moveworks from ServiceNow EmployeeWorks

View as Markdown

ServiceNow EmployeeWorks supports automatic sign-in to Moveworks. Users who are already signed in to ServiceNow can access Moveworks through Admin Tools → Moveworks Tools without a separate Moveworks login.

This login method uses the existing EmployeeWorks integration and does not require a separate SSO setup on the Moveworks side.

Watch the Walkthrough

Video: Sign in to Moveworks from ServiceNow EmployeeWorks

Current Limitations

  • Supported entry point: Automatic sign-in is currently available only through EmployeeWorks → Admin Tools → Moveworks Tools. Other entry points, including the Moveworks Setup link on the EmployeeWorks configuration page, continue to use the existing Moveworks login flow. Support for additional entry points is planned for future releases.
  • Supported users: This capability is currently available to ServiceNow system administrators and other authorized users with the role combination listed below. Being present in the Moveworks user directory alone does not provide access to this entry point.

Before You Begin

Application and integration

Before using automatic sign-in, confirm that:

  • The EmployeeWorks integration with Moveworks is configured.
  • ServiceNow EmployeeWorks Web App v1.5.2 or later (app-ex-employee-hub-moveworks) is installed.
  • The Content Delivery plugin (com.sn_content_delivery) is active.
  • The user has been imported into Moveworks through the configured integration, so their ServiceNow identity resolves to their Moveworks account.

User roles

Users must have one of the following ServiceNow role configurations:

User typeRequired ServiceNow roles
System administratorSystem Administrator (admin)
Other authorized usersEmployee Center Admin (sn_hr_sp.esc_admin) and either Content Manager (sn_cd.content_manager) or Content Admin (sn_cd.content_admin)

Users must also have the appropriate Moveworks roles for the tools they need to access. ServiceNow roles do not grant additional permissions in Moveworks.

Procedure

  1. Sign in to ServiceNow.
  2. Open EmployeeWorks.
  3. Select Admin Tools → Moveworks Tools.

Moveworks opens and automatically signs you in using your ServiceNow identity. The tools available to you depend on your Moveworks permissions.

If automatic sign-in can’t be completed, Moveworks shows its sign-in page. See What happens if automatic sign-in fails?

After automatic sign-in, your Moveworks session expires after 24 hours. To sign in again, return to EmployeeWorks and select Admin Tools → Moveworks Tools.

Use Automatic Sign-In Across ServiceNow Instances

How Moveworks Matches a ServiceNow Instance

When a user selects Admin Tools → Moveworks Tools, EmployeeWorks opens the Moveworks org URL configured on that ServiceNow instance. Moveworks then:

  1. Checks that the instance is listed as a Trusted Issuer in Moveworks Setup → Chat Platforms → EmployeeWorks → Connector and Trusted Issuer.
  2. Looks up the user’s ServiceNow user ID among the users imported through the connector paired with that trusted issuer.

Each ServiceNow instance needs its own Connector and Trusted Issuer entry, with that instance’s URL as the trusted issuer. Several entries can use the same connector.

Common Setups

Each ServiceNow instance connects to one Moveworks org.

StageWithout a Moveworks sandboxWith a Moveworks sandbox
During implementationServiceNow Dev → Moveworks ¹ServiceNow Dev → Moveworks ¹
After go-liveServiceNow Prod → Moveworks ¹ServiceNow Prod → Moveworks ¹
ServiceNow Dev → Moveworks sandbox ²
  1. Moveworks: your company’s production Moveworks org, where employees use Moveworks after go-live. During implementation, it isn’t live for employees yet.
  2. Moveworks sandbox: an optional, separate Moveworks org used only for testing. Ask your Moveworks representative if you’re not sure whether you have one.

Connect a ServiceNow Instance

  1. In Moveworks Setup → Chat Platforms → EmployeeWorks, add a Connector and Trusted Issuer entry:
    • Connector: an existing ServiceNow connector, or a new one with the instance’s users imported. To set up a connector for another environment, see Deploy to Multiple ServiceNow Environments.
    • Trusted Issuer: the instance URL, without a trailing slash (for example, https://acmeprod.service-now.com).
  2. In the ServiceNow instance, configure EmployeeWorks with the Moveworks org URL. For detailed steps, refer to the EmployeeWorks Web App configuration guide.
  3. Test automatic sign-in from that instance with a non-admin user who has the required ServiceNow roles (for example, Employee Center Admin plus Content Manager) and was imported into Moveworks. Users without these roles can’t see Admin Tools.

Don’t test with the built-in ServiceNow admin account. It has the same user ID on every instance, so it can sign in even when the instance’s users haven’t been imported.

Move from ServiceNow Dev to ServiceNow Prod

  1. Connect ServiceNow Prod to Moveworks using the steps above. Keep the ServiceNow Dev entry while you test.
  2. Test from ServiceNow Prod with a regular user who has the required roles.
  3. Decide what to do with ServiceNow Dev:
    • To keep using it with Moveworks, leave its entry in place.
    • To move it to your Moveworks sandbox, connect it to the sandbox, update the Moveworks org URL in its EmployeeWorks configuration, and then remove its entry from Moveworks.

Instances can share a connector only if the users signing in exist with the same ServiceNow user IDs in the connector’s source instance, which is typical when Dev is cloned from Prod. Otherwise, give the instance its own connector and import its users.

Troubleshooting

IssueWhat to check
Admin Tools is not visibleVerify the user’s ServiceNow roles and confirm that the Content Delivery plugin is active.
Moveworks prompts for a separate loginVerify the installed app version, the required ServiceNow roles, and that the user has been imported into Moveworks through the integration. Users can sign in on that page only if another Moveworks login method, such as SSO, is set up.
A tool is unavailable after sign-inVerify the user’s roles and permissions in Moveworks.
Sign-in fails from a newly connected instanceThe instance has a Connector and Trusted Issuer entry, the trusted issuer exactly matches the instance URL with no trailing slash, and EmployeeWorks points to the correct Moveworks org URL.
admin can sign in, but other users can’tThe users exist in the source instance of the connector paired with that instance’s trusted issuer.

FAQs

Does this require a separate Moveworks SSO configuration?

No, not for this entry point. Moveworks uses your ServiceNow session and the EmployeeWorks integration to sign you in.

If you also want users to sign in to Moveworks directly, without going through EmployeeWorks, set up a separate login method such as SSO.

Who can open Moveworks Tools from EmployeeWorks?

Only users with the required ServiceNow roles who have also been imported into Moveworks. Other EmployeeWorks users don’t see Admin Tools.

Does being a ServiceNow administrator grant administrator access in Moveworks?

No. Moveworks roles and permissions continue to control access to Moveworks tools.

How long does the Moveworks session last?

The session expires after 24 hours. To sign in again, return to EmployeeWorks and select Admin Tools → Moveworks Tools.

Does automatic sign-in also work for other Moveworks apps?

Yes, for most apps. After you sign in, you can open apps linked from Moveworks Home, such as Tool Studio, Agent Studio, and Academy, without signing in again. Moveworks Community requires a separate sign-in.

Does signing out of ServiceNow sign me out of Moveworks?

No. Moveworks checks your ServiceNow session only when you sign in. After that, your Moveworks session stays active for 24 hours, or until you sign out of Moveworks.

What happens if automatic sign-in fails?

Moveworks shows its sign-in page. You can sign in there only if your organization has set up another Moveworks login method, such as SSO. Otherwise, check Troubleshooting, and then try again from Admin Tools → Moveworks Tools.

Can I use automatic sign-in from more than one ServiceNow instance?

Yes. Add a Connector and Trusted Issuer entry for each instance in the Moveworks org it connects to. See Use automatic sign-in across ServiceNow instances.