Skip to main content

​
About Lumos

Lumos is an identity governance and app management platform that helps organizations manage their app inventory, govern access requests through its AppStore, and keep user accounts and entitlements in check. Connecting Lumos to Serval enables app and directory lookups, AppStore approval-flow checks, and access automation directly from your service desk.

​
What the Lumos integration enables

CapabilityDescription
App & directory lookupsList the apps Lumos knows about, and page through users, accounts, and groups
AppStore governanceBrowse AppStore apps, inspect an app’s approvers, and review requestable permissions and their approval configuration
Automation workflowsBuild workflows that query or take action via the Lumos API
Anything defined in the Lumos API can be accessed through Serval.

​
Lumos configuration

​
Prerequisites

  • An active Lumos organization
  • Admin access in Lumos (required to create API tokens)

​
Create an API token

1

Navigate to API token settings

Sign in to Lumos and open Settings. Select the API Tokens page.
2

Create a new token

Create a new API token and give it a descriptive name (e.g., “Serval Integration”).
3

Copy your token

Copy the generated API token value. Lumos API tokens start with lsk_.
The API token is only displayed once. Store it securely before leaving the page. If lost, you must create a new token.

​
Serval configuration

  1. In Serval, go to Apps → Available → Lumos → Connect
  2. Enter the following:
    FieldDescription
    API TokenYour Lumos API token (starts with lsk_)
  3. Click Save
Serval will verify your credentials and connect to Lumos. Once saved, the integration is ready to use in workflows.

​
Installable Workflows

The Lumos integration includes pre-built installable workflows, grouped into two bundles:

​
AppStore

  • List Lumos AppStore Apps — Page through all apps available in the Lumos AppStore, optionally filtered by name
  • Get Lumos App Approvers — Fetch an app’s AppStore request-flow settings: stage-1 and stage-2 approvers, admins, and whether manager or additional approval is required
  • List Lumos App Requestable Permissions — Page through an app’s requestable permissions, including each permission’s AppStore visibility, manager-approval setting, and approvers

​
Directory & Apps

  • List Lumos Accounts — Page through accounts in Lumos, optionally filtered by app or lifecycle status (e.g. ACTIVE, SUSPENDED, DEACTIVATED)
  • List Lumos Users — Page through users in the Lumos organization, optionally filtered by a search against name and email
  • List Lumos Groups — Page through groups in Lumos, optionally filtered by group name or sourcing app
  • List Lumos Apps — Page through all apps Lumos knows about for the organization, optionally filtered by name
  • Get Lumos App — Fetch a single Lumos app by its ID
You can install these workflows from Workflows → Installable in Serval, or build your own custom Lumos workflows using the workflow builder.

​
Additional resources

Lumos API documentation

Full REST API reference for the Lumos platform

Lumos

Learn more about Lumos’s identity governance and app management platform
Need help? Contact support@serval.com for assistance with your Lumos integration.