Access Moveworks from ServiceNow EmployeeWorks
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:
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
- Sign in to ServiceNow.
- Open EmployeeWorks.
- 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:
- Checks that the instance is listed as a Trusted Issuer in Moveworks Setup → Chat Platforms → EmployeeWorks → Connector and Trusted Issuer.
- 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.
- Moveworks: your company’s production Moveworks org, where employees use Moveworks after go-live. During implementation, it isn’t live for employees yet.
- 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
- 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).
- In the ServiceNow instance, configure EmployeeWorks with the Moveworks org URL. For detailed steps, refer to the EmployeeWorks Web App configuration guide.
- Test automatic sign-in from that instance with a non-
adminuser 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
- Connect ServiceNow Prod to Moveworks using the steps above. Keep the ServiceNow Dev entry while you test.
- Test from ServiceNow Prod with a regular user who has the required roles.
- 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
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.