Servicenow 1Kosmos Identity Verification Integration

1Kosmos-Verify enables organizations to securely confirm a user’s identity before performing critical actions such as account recovery, password reset, or new user onboarding. By validating identity using government-issued documents—such as a driver’s license, passport, or national ID—1Kosmos-Verify helps reduce the risk of impersonation and unauthorized access within the ServiceNow environment. All data exchanged between ServiceNow and 1Kosmos services is encrypted end-to-end using public key encryption algorithms.

Prerequisites and Application Dependencies

Before installing or configuring the 1Kosmos-Verify app, ensure the following prerequisites are met:

• 1Kosmos Tenant

  • Each organization must have its own 1Kosmos Tenant.
  • To obtain tenant details, contact 1Kosmos Support.

• ServiceNow App Installation Permission

  • The latest version of 1Kosmos-Verify must be downloaded and installed from the ServiceNow Marketplace.
  • The app is free to install.

• Administrator Access

  • The user performing the setup must have Admin or equivalent permissions in the ServiceNow instance.

• User Data Requirements

  • Each user record must include the following mandatory fields for document verification:
    • First Name
    • Last Name
    • Date of Birth
    • Email – used for sending document verification links via email
    • Mobile Phone – used for sending document verification links via SMS

• Plugins Required

  None. The 1Kosmos-Verify app works natively with out-of-the-box ServiceNow components.

• System Table Permissions Required

  The following tables require Read/Write access:

  • sys_properties
  • incident
  • sys_user

• Roles Required

  • Admin or delegated admin roles are required for installation and configuration.
  • Agents require the x_onk_1kosmos.admin role along with the ITIL role to perform identity verification tasks.

Installing 1Kosmos-Verify App

To install the 1Kosmos-Verify app in your ServiceNow instance, follow these steps:

1. Log in to the ServiceNow Store (store.servicenow.com) with your 1Kosmos credentials so the app can be entitled to your organization.
2. In the store search bar, search for “1Kosmos-Verify” and open the app listing.
3. Click Get/Request App/ Request Trial (depending on the app availability) and follow the prompts to entitle the app to your organization’s ServiceNow instances.
4. Log in to the target ServiceNow instance as an admin.
5. From the left navigation pane, open System Applications > My Company Applications (or System Applications > All Available Applications > All) and use filters to show apps Not Installed.
6. Locate 1Kosmos-Verify in the list.
7. Select the latest version of the app and click Install.
8. Wait for the installation to complete; ServiceNow will automatically create the necessary application artifacts and properties during install.

Configuring 1Kosmos-Verify App

Once the installation is complete, follow these steps to configure the 1Kosmos-Verify app:

1. The app automatically generates the system properties required to communicate with 1Kosmos services.

2. Navigate to <your-servicenow-url>/sys_properties_list.do.

3. In the System Properties list, filter by Application and enter 1Kosmos-Verify. The filtered list will display all system properties related to the 1Kosmos-Verify app.

4. Update each property with the corresponding tenant-specific details provided by 1Kosmos Support. Tenant Details include:

   • Tenant DNS
   • Community Name
   • License Key
   • DVC ID
   • ECDSA Public/Private Key Pair
   important

   All property values must be entered accurately for the app to function properly.

5. After updating each property, click Save to apply the changes.

6. Once configuration is complete, the app is ready to be used by Helpdesk Admins for:

   • User Account Recovery
   • Password Reset
   • New User Onboarding

Integrating 1Kosmos-Verify for Identity Verification Workflows

The 1Kosmos-Verify app can be integrated into existing workflows or used to create new identity verification flows based on your organization’s requirements.

During installation, the app provides two sample workflows for reference:

• Password Reset Workflow
• Account Recovery Workflow

To test a sample workflow:

1. Create two Incident Subcategories under the appropriate Incident Category:

   • Account Recovery
   • Password Reset

2. Navigate to All → Process Automation → Flow Designer.

3. Locate and open the flow named Incident Identity Verification.

4. Click Activate to enable the workflow.

5. Navigate to All → Service Desk → Incidents and create a new incident.

6. Select the Caller (the user whose identity needs to be verified).

7. In the Subcategory field, select either Account Recovery or Password Reset.

8. Submit the incident to trigger the identity verification process through 1Kosmos-Verify.

9. Once the user completes verification, the incident will be automatically updated.

   A successful test indicates that the configuration is correct and the integration is functioning as expected.

External Systems Connection

The 1Kosmos-Verify application integrates directly with the 1Kosmos Identity Proofing Platform.

Integration Components Required:

• REST API calls to 1Kosmos Verify endpoints
• Web-based document verification links sent via email or SMS
• Identity proofing workflows (e.g., Driver’s License, Passport, National ID)

Steps to Create a Dedicated Integration User:

1. In your 1Kosmos tenant, request integration credentials through 1Kosmos Support.

2. 1Kosmos will provide the following credentials:

   • Tenant DNS
   • Community Name
   • License Key
   • DVC ID
   • ECDSA Public/Private Key Pair

3. Store these credentials in ServiceNow system properties.

4. Assign secure access permissions to authorized administrators only.

Demo Data

The application does not require demo data. However, to test identity verification, ensure the test user record contains:

• First Name
• Last Name
• Date of Birth
• Email Address
• ISD Code
• Mobile Number

These are required for sending verification links.

Next Steps and Support

For assistance with the following, reach out to your 1Kosmos representative.

• Tenant setup
• Property configuration
• API credentials
• Troubleshooting

Troubleshooting

Issue	Cause	Resolution
Verification link not received	Incorrect email/phone in user profile	Validate user’s contact information
API request failures	Incorrect system property values	Re-check Tenant Details, License Key
Workflow not triggering	Workflow not activated or misconfigured	Activate workflow in Flow Designer
Application not functioning after install	Missing permissions or incomplete configuration	Ensure admin access and correct property values
HTTP errors	Network or firewall restrictions	Allow outbound HTTPS to 1Kosmos endpoints