Opsgenie Capabilities
Last updated: October 8, 2024
After this article...
You'll understand the capabilities our Opsgenie integration provides, and how Lumos interacts with the Opsgenie API.
View users
The mapping between Opsgenie user statuses and Lumos user account statuses is below.
Opsgenie User Status | Lumos Account Status |
verified | Active |
blocked | Suspended |
anything else | Staged |
deleted (Opsgenie no longer returns a user) | Deprovisioned |
Opsgenie API endpoints:
Get all users: https://docs.opsgenie.com/docs/user-api#list-user
Get user details: https://docs.opsgenie.com/docs/user-api#get-user
View a user's entitlements
Lumos can retrieve the following user entitlements from Opsgenie.
Team - The Opsgenie team(s) to which the employee is assigned.
Role - The Opsgenie role mapped to the employee.
Opsgenie API endpoints:
Team:
https://docs.opsgenie.com/docs/team-api#list-teams
https://docs.opsgenie.com/docs/team-api#get-team
Role:
https://docs.opsgenie.com/docs/user-api#get-user (we get the role.name field)
Validate on-call membership
AppStore | Offboarding | Access Reviews | License Management |
✅ | N/A | N/A | N/A |
As a condition of a pre-approval rule, Lumos can check whether a user is currently assigned to an Opsgenie on-call schedule to determine if they should be pre-approved for access to an app. see📄 Setting Up Pre-Approvals
When verifying whether a requester is part of an on-call schedule, Lumos does a real-time verification to ensure that the person receiving access is still on-call.
Opsgenie API endpoints:
https://docs.opsgenie.com/docs/schedule-api#list-schedules (we return enabled schedules only)
https://docs.opsgenie.com/docs/who-is-on-call-api#get-on-calls (we verify that the user receiving access is in the list of people on-call for a specific schedule)