JIT
The Just-in-Time (JIT) API manages both eligibilities and access requests for secure, temporary access to cloud resources. It supports AWS, Azure, GCP, Microsoft Entra ID, Google Workspace, Okta, OneLogin, and Ping Identity.
Eligibilities define who can request what and for how long.
Requests activate access based on an existing eligibility.
Using the JIT API, Administrators and JIT Administrators can automate eligibility workflows, generate multiple eligibilities with minor variations, and programmatically submit access requests—removing manual steps and supporting advanced, large-scale integrations. For example:
- Create multiple JIT eligibilities with minor changes using the API.
- Automatically create the requester of a pre-approved eligibility to match the on-call assignee.
Eligibilities
Use these operations to create, list, update, and delete JIT eligibilities across supported providers, and to list the JIT principals you can reference as requesters or approvers.
Create Eligibilities
You can create eligibilities for:
- AWS accounts
- AWS applications
- Azure
- GCP
- Microsoft Entra ID, Okta, Google Workspace, or Ping Identity
- OneLogin
Note
- See Administer JIT Access in the Tenable Cloud Exposure User Guide for more information on eligibilities.
- You can use the
ApproverLevelsfield to create a multi-level approval workflow, requiring an additional stage of approval before granting access. You can add a maximum of three approval levels. See Multi-Level Approval Workflow in the Tenable Cloud Exposure User Guide for more information.
Create eligibilities for AWS accounts
mutation {
CreateAwsPermissionSetEligibility(input: {
Approval: {
Required: false
}
Description:"1 hour permissions"
Duration: "PT1H"
JustificationRequired: false
Name: "S3 read access"
Permissions: {
ScopeIds: [ "123456789012" ]
InlinePolicyDocument: "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Effect\":\"Allow\",\"Action\":\"s3:GetObject\",\"Resource\":\"arn:aws:s3:::example-bucket/*\"}]}"
}
PermissionSetNamePrefix: "example-760a85"
RequesterIds: [ "example-2aaa53" ]
ScopeId: "awsRoot"
}) {
AwsPermissionSetEligibility {
Id
}
}
}Sample response
{
"data": {
"CreateAwsPermissionSetEligibility": {
"AwsPermissionSetEligibility": {
"Id": "c96d1cef-7b46-4a6b-ba60-93f3ce7cfea5"
}
}
}
}Create eligibilities for AWS applications
mutation {
CreateAwsApplicationEligibility(
input: {
ScopeId: "aws"
Name: "Example"
RequesterIds: ["5c5763ce-d1a1-4630-8e98-294dc55f0471"]
Permissions: {
ApplicationIds: [ "example-d7ea55","arn:aws:iam::111122223333:role/LambdaAdmin", "arn:aws:sso::444455556666", "arn:aws:sso::111122223333:application/ssoins-2850d53cca853326/apl-e5063a820a8ade9c"]
}
Approval: {
Required: false
}
Description: "Optional description"
Duration: "PT1H"
JustificationRequired: true
Recurrence: {
Enabled: true
MaxTimeFrameDays: 30
}
}
) {
AwsApplicationEligibility {
Name
Id
}
}
}Sample response
{
"data": {
"CreateAwsApplicationEligibility": {
"AwsApplicationEligibility": {
"Name": "test",
"Id": "934a0e39-0020-4134-8ea7-03a60196f423"
}
}
}
}Create eligibilities for Azure
NoteUnder
Permissions, ifResourceGroupsare listed andScopeIdsis omitted, the scopes are taken from the listedResourceGroups.This might cause errors that seem related to
ScopeIdsbut are actually from theResourceGroupslist.If this happens, review and correct the
ResourceGroupslist.
mutation {
CreateAzureRoleDefinitionEligibility(input: {
Approval: {
Required: false
}
Description:"12 hour permissions"
Duration: "PT12H"
JustificationRequired: true
Name: "example-1ddd39"
Permissions: {
ResourceGroupIds: [
"/subscriptions/8f4a2b19-6c3d-4e5f-9a7b-1c2d3e4f5a6b/resourceGroups/example-resources"
],
RoleDefinitionIds: [
"/providers/Microsoft.Authorization/roleDefinitions/ec0cba08-755f-43b3-a01d-0a4ca523c9d3",
"/subscriptions/8f4a2b19-6c3d-4e5f-9a7b-1c2d3e4f5a6b/providers/Microsoft.Authorization/roleDefinitions/4d97b98b-1d4f-4787-a291-c67834d212e7"
]
RequestScopesLimit: 5
}
RequesterIds: [ "example-656090" ]
ScopeId: "azureRoot"
}) {
AzureRoleDefinitionEligibility {
Id
}
}
}Sample response
{
"data": {
"CreateAzureRoleDefinitionEligibility": {
"AzureRoleDefinitionEligibility": {
"Id": "0a69dc04-ed6f-4f45-8a78-fabcfe4523e5"
}
}
}
}Create eligibilities for GCP
mutation {
CreateGcpRoleEligibility(input: {
Approval: {
ApproverLevels: [
[ "Group/00e3678704" ],
[ "User/72169215a7" ],
[ "User/400776109c" ]
]
}
Description:"5 hour permissions"
Duration: "PT5H"
JustificationRequired: true
Name: "example-1a2320"
Permissions: {
ScopeIds: [ "gcpRoot" ]
RoleIds: [
"roles/viewer",
"roles/editor"
]
}
RequesterIds: [ "example-4cbaba" ]
ScopeId: "gcpRoot"
}) {
GcpRoleEligibility {
Id
}
}
}Sample response
{
"data": {
"CreateGcpRoleEligibility": {
"GcpRoleEligibility": {
"Id": "3b7ebade-6b78-4a8e-85ac-8b1fd45964e9"
}
}
}
}Create eligibilities for Microsoft Entra ID, Okta, Google Workspace, or Ping Identity
mutation {
CreateAzureAdGroupEligibility(input: {
Approval: {
Required: false
}
Description:"11 hour permissions"
Duration: "PT11H"
JustificationRequired: false
Name: "example-4de375"
Permissions: {
GroupIds: "example-67c141"
}
RequesterIds: [ "example-37692d" ]
ScopeId: "aaadt"
}) {
AzureAdGroupEligibility {
Id
}
}
}Sample response
{
"data": {
"CreateAzureAdGroupEligibility": {
"AzureAdGroupEligibility": {
"Id": "8ed5aa04-531b-43d6-8d0b-db6e983cd598"
}
}
}
}Create eligibilities for OneLogin
mutation {
CreateOneLoginGroupEligibility(input: {
Approval: {
Required: false
}
Name: "example-cd5dc7"
Permissions: {
RoleIds: [
"858666017681369",
"444455556666"
]
}
RequesterIds: [
"09631945121461324",
"677873471847873858442"
]
ScopeId: "oneLoginRoot"
}) {
OneLoginRoleEligibility {
Id
Description
Duration
JustificationRequired
}
}
}Sample response
{
"data": {
"CreateOneLoginGroupEligibility": {
"OneLoginRoleEligibility": {
"Id": "f29741a1-a3f4-4285-8dd7-7384fa5f0bb3",
"Description": null,
"Duration": "PT1H",
"JustificationRequired": true
}
}
}
}List Eligibilities
You can list and view eligibilities for:
List eligibilities for AWS
query {
AwsPermissionSetEligibilities(filter: {
ScopeId: "awsRoot2",
IncludeChildScopes: true,
Names: "111111111111-3",
RequesterId:"8a4f68ef-2a8e-4611-8530-9982f560695d"
}) {
nodes {
Approval {
ApproverLevels {
Id
AccountId
Provider
Name
Mail
Type
}
}
Description
Duration
Id
JustificationRequired
Name
Permissions {
ScopeIds
AwsManagedPolicies {
Id
Name
}
InlinePolicy
PermissionSet {
Id
Name
}
}
PrincipalAccountId
Requesters {
Id
AccountId
Provider
Name
Mail
Type
}
ScopeId
}
}
}Sample response
{
"data": {
"AwsPermissionSetEligibilities": {
"nodes": [
{
"Approval": {
"ApproverLevels": [
[
{
"Id": "3af490ba09-c55bd66a-d5ae-4aa4-a73f-6a08e77ab532",
"AccountId": "111122223333",
"Provider": "AWS",
"Name": "003",
"Mail": "[email protected]",
"Type": "AwsSsoUser"
},
{
"Id": "3af490ba09-c7ad41c7-53fb-44a4-ba59-8f89c829e5b0",
"AccountId": "123456789012",
"Provider": "AWS",
"Name": "002",
"Mail": "[email protected]",
"Type": "AwsSsoUser"
},
{
"Id": "8740bc90-f59d-48ca-85ff-a529d1bac293",
"AccountId": "111122223333",
"Provider": "AWS",
"Name": "004",
"Mail": "[email protected]",
"Type": "AwsSsoUser"
},
{
"Id": "3af490ba09-eb773128-556c-4093-ae2f-b198334b0deb",
"AccountId": "111122223333",
"Provider": "AWS",
"Name": "002",
"Mail": "[email protected]",
"Type": "AwsSsoUser"
}
]
]
},
"Description": null,
"Duration": "PT27G",
"Id": "ede5a9f0-bde1-4a88-93f4-af7607f16d7d",
"JustificationRequired": true,
"Name": "111111111111-3",
"Permissions": {
"ScopeIds": [
"72609085"
],
"AwsManagedPolicies": [],
"InlinePolicy": {
"Version": "2012-10-17",
"Statement": [
{
"Sid": "AllowAllL",
"Effect": "Allow",
"Action": "*",
"Resource": "*"
}
]
},
"PermissionSet": null
},
"PrincipalAccountId": "123456789012",
"Requesters": [
{
"Id": "3af490ba09-c8827641-ab0b-43b6-a730-cd4472edc11a",
"AccountId": "111122223333",
"Provider": "AWS",
"Name": "App Team Test",
"Mail": null,
"Type": "AwsSsoGroup"
}
],
"ScopeId": "444455556666"
}
]
}
}
}List eligibilities for Azure
query {
AzureRoleDefinitionEligibilities(filter: {
ScopeId: "azureRoot",
IncludeChildScopes: true,
Names: "Azure access reviews",
RequesterId:"f6720b45-9e3a-4b7a-bbf9-6aa017ee328d"
}) {
nodes {
Approval {
ApproverLevels {
Id
AccountId
Provider
Name
Mail
Type
}
}
Description
Duration
Id
JustificationRequired
Name
Permissions {
ScopeIds
RoleDefinitions {
Id
Name
}
}
PrincipalAccountId
Requesters {
Id
AccountId
Provider
Name
Mail
Type
}
ScopeId
}
}
}Sample response
{
"data": {
"AzureRoleDefinitionEligibilities": {
"nodes": [
{
"Approval": {
"ApproverLevels": [
[
{
"Id": "f68ed8e9-cebe-4037-8d6e-415a3d96d63f",
"AccountId": "2786a180-f64c-41b1-b74f-5fce023deb9b",
"Provider": "AzureAd",
"Name": "JIT Requester",
"Mail": "[email protected]",
"Type": "AzureAdUser"
}
],
[
{
"Id": "bcf7aaff-4611-4a63-9fd8-d1e673de7844",
"AccountId": "2786a180-f64c-41b1-b74f-5fce023deb9b",
"Provider": "AzureAd",
"Name": "DevOps Admin",
"Mail": "[email protected]",
"Type": "AzureAdUser"
}
]
]
},
"Description": null,
"Duration": "P1D",
"Id": "ac9b4f53-e81a-42dd-a3fa-47e9b968ff37",
"JustificationRequired": true,
"Name": "Azure access reviews",
"Permissions": {
"ScopeIds": [
"azureRoot"
],
"RoleDefinitions": [
{
"Id": "aad//providers/Microsoft.Authorization/roleDefinitions/e6cde21c-f8be-468c-86b0-db2f638b11d7",
"Name": "Example Custom Role"
},
{
"Id": "aad//providers/Microsoft.Authorization/roleDefinitions/fa23ad8b-c56e-40d8-ac0c-ce449e1d2c64",
"Name": "Billing Reader"
},
{
"Id": "aad//providers/Microsoft.Authorization/roleDefinitions/7f951dda-4ed3-4680-a7ca-43fe172d538d",
"Name": "AcrPull"
}
]
},
"PrincipalAccountId": "2786a180-f64c-41b1-b74f-5fce023deb9b",
"Requesters": [
{
"Id": "f8779cd4-80ce-49fc-8310-82e81a21f10a",
"AccountId": "2786a180-f64c-41b1-b74f-5fce023deb9b",
"Provider": "AzureAd",
"Name": "DevOps User",
"Mail": "[email protected]",
"Type": "AzureAdUser"
}
],
"ScopeId": "azureRoot"
}
]
}
}
}List eligibilities for GCP
query {
GcpRoleEligibilities(filter: {
ScopeId: "gcpRoot",
IncludeChildScopes: true,
Names: "GCP access approval roles",
RequesterId:"ae88af50-7ea7-4d4a-8253-785dc65a6284"
}) {
nodes {
Approval {
ApproverLevels {
Id
AccountId
Provider
Name
Mail
Type
}
}
Description
Duration
Id
JustificationRequired
Name
Permissions {
ScopeIds
Roles {
Id
Name
}
}
PrincipalAccountId
Requesters {
Id
AccountId
Provider
Name
Mail
Type
}
ScopeId
}
}
}Sample response
{
"data": {
"GcpRoleEligibilities": {
"nodes": [
{
"Approval": {
"ApproverLevels": [
[
{
"Id": "Group/066xdc5bn10aa1t",
"AccountId": "C0bwmv63q",
"Provider": "GoogleWorkspace",
"Name": "platform-team",
"Mail": "[email protected]",
"Type": "GoogleWorkspaceGroup"
}
],
[
{
"Id": "User/128188411545374046899",
"AccountId": "C0bwmv63q",
"Provider": "GoogleWorkspace",
"Name": "JIT Test User",
"Mail": "[email protected]",
"Type": "GoogleWorkspaceUser"
},
{
"Id": "User/184804595191262721117",
"AccountId": "C0bwmv63q",
"Provider": "GoogleWorkspace",
"Name": "Riley Morgan",
"Mail": "[email protected]",
"Type": "GoogleWorkspaceUser"
}
],
[
{
"Id": "Group/0ehxceekcs2q5lh",
"AccountId": "C0bwmv63q",
"Provider": "GoogleWorkspace",
"Name": "Admins",
"Mail": "[email protected]",
"Type": "GoogleWorkspaceGroup"
},
{
"Id": "Group/066xdc5bn10aa1t",
"AccountId": "C0bwmv63q",
"Provider": "GoogleWorkspace",
"Name": "platform-team",
"Mail": "[email protected]",
"Type": "GoogleWorkspaceGroup"
},
{
"Id": "Group/0vm4ei508xrgg8h",
"AccountId": "C0bwmv63q",
"Provider": "GoogleWorkspace",
"Name": "Platform Test Group",
"Mail": "[email protected]",
"Type": "GoogleWorkspaceGroup"
},
{
"Id": "Group/0esjbamjcixza3j",
"AccountId": "C0bwmv63q",
"Provider": "GoogleWorkspace",
"Name": "platform test 3",
"Mail": "[email protected]",
"Type": "GoogleWorkspaceGroup"
}
]
]
},
"Description": "w45r54",
"Duration": "PT23H",
"Id": "789ecbcc-2f14-4184-b07a-9f61480a0bfe",
"JustificationRequired": true,
"Name": "GCP access approval roles",
"Permissions": {
"ScopeIds": [
"gcpRoot"
],
"Roles": [
{
"Id": "roles/accessapproval.configEditor",
"Name": "Access Approval Config Editor"
},
{
"Id": "roles/accessapproval.invalidator",
"Name": "Access Approval Invalidator"
}
]
},
"PrincipalAccountId": "123456789012",
"Requesters": [
{
"Id": "Group/0ehxceekcs2q5lh",
"AccountId": "C0bwmv63q",
"Provider": "GoogleWorkspace",
"Name": "Admins",
"Mail": "[email protected]",
"Type": "GoogleWorkspaceGroup"
}
],
"ScopeId": "gcpRoot"
}
]
}
}
}List eligibilities for Microsoft Entra ID, Okta, Google Workspace, or Ping Identity
query {
AzureAdGroupEligibilities(filter: {
ScopeId: "aadRoot",
IncludeChildScopes: true,
Names: "JIT",
RequesterId:"68511f8e-d05a-42f6-8d42-3a32230ebdb8"
}) {
nodes {
Approval {
ApproverLevels {
Id
AccountId
Provider
Name
Mail
Type
}
}
Description
Duration
Id
JustificationRequired
Name
Permissions {
Groups {
Id,
Name
}
}
PrincipalAccountId
Requesters {
Id
AccountId
Provider
Name
Mail
Type
}
ScopeId
}
}
}Sample response
{
"data": {
"AzureAdGroupEligibilities": {
"nodes": [
{
"Approval": {
"ApproverLevels": []
},
"Description": null,
"Duration": "PT1H",
"Id": "bb341714-9b6a-49a1-bd56-912525c98c98",
"JustificationRequired": true,
"Name": "JIT REQUESTER get into group test drive",
"Permissions": {
"Groups": [
{
"Id": "41f25dd0-5d6d-474e-8b7c-7df0f2b63e73",
"Name": "GroupDrive1"
}
]
},
"PrincipalAccountId": "54881023-f659-49c3-95f9-39a7215c6589",
"Requesters": [
{
"Id": "ee61e16c-fceb-4179-95ff-8aaf03303466",
"AccountId": "54881023-f659-49c3-95f9-39a7215c6589",
"Provider": "AzureAd",
"Name": "JIT Requester",
"Mail": "[email protected]",
"Type": "AzureAdUser"
}
],
"ScopeId": "aadRoot"
}
]
}
}
}List eligibilities for OneLogin
query {
OneLoginRoleEligibilities(filter: {
ScopeId: "oneLoginRoot",
IncludeChildScopes: true,
Names: "Copy of OneLogin access-2",
RequesterId:"ae574c31-f9b5-44c2-a16e-3b4a09ed9274"
}) {
nodes {
Approval {
ApproverLevels {
Id
AccountId
Provider
Name
Mail
Type
}
}
Description
Duration
Id
JustificationRequired
Name
Permissions {
Roles {
Id,
Name
}
}
PrincipalAccountId
Requesters {
Id
AccountId
Provider
Name
Mail
Type
}
ScopeId
}
}
}Sample response
{
"data": {
"OneLoginRoleEligibilities": {
"nodes": [
{
"Approval": {
"ApproverLevels": []
},
"Description": null,
"Duration": "PT9H",
"Id": "ef7092f5-5df0-4dc6-a4a6-187daa770b30",
"JustificationRequired": false,
"Name": "Copy of OneLogin access-2",
"Permissions": {
"Roles": [
{
"Id": "513681f1-3eda-41eb-8fe4-72de9d24f2b2",
"Name": "All"
},
{
"Id": "42e03a2a-e940-41e9-82c7-dc963635523e",
"Name": "aws-1 "
}
]
},
"PrincipalAccountId": "95ecea11-37fe-4a26-8095-af780571e89e",
"Requesters": [
{
"Id": "b9061229-287b-4249-86d6-380c79d09980",
"AccountId": "481920",
"Provider": "OneLogin",
"Name": "TestingAZ",
"Mail": null,
"Type": "OneLoginUser"
},
{
"Id": "481920/User/301457962",
"AccountId": "481920",
"Provider": "OneLogin",
"Name": "Test Slack",
"Mail": "[email protected]",
"Type": "OneLoginUser"
}
],
"ScopeId": "f98918e2-dcec-403b-82fc-2828aa38754a"
}
]
}
}
}Update Eligibilities
You can update eligibilities for:
Update eligibilities for AWS
mutation {
UpdateAwsPermissionSetEligibility(input:{Id:"55d52883-b7f5-413f-8a10-cd2f31975080"
Name:"example-b55d7d"
Description: {Value: "example-9ec6b5"},
PermissionSetNamePrefix:"example-866487",
Duration: "PT15H",
Recurrence:{
Enabled:true
MaxTimeFrameDays:17
}
Permissions:{
AwsManagedPolicies:{
IDs:["example-c5d5ec"]
}
ScopeIds:["780293522",
"111122223333",
"123456789012",]
AccountsLimit:{
Value:10
}
}
Approval:{
Required:false
}
}) {
AwsPermissionSetEligibility {
Id
}
}
}Sample response
{
"data": {
"UpdateAwsPermissionSetEligibility": {
"AwsPermissionSetEligibility": {
"Id": "55d52883-b7f5-413f-8a10-cd2f31975080"
}
}
}
}Update eligibilities for Azure
mutation {
UpdateAzureRoleDefinitionEligibility(input:{ Id:"070783b0-a15d-4e48-8c54-3393104a4269"
Name:"Test EligibilityAzureRoles"
RequesterIds:[
"f672c1f5-edac-4034-8020-3c8de9bf1b6f","2afbb56f-0997-4b31-8f6a-eefa6874ae05","example-3ae15a","c8732685-a35e-4155-8a32-9a9a26fd79f7",
"example-ea3809"
]
Duration:"PT16H"
Permissions:{
RoleDefinitionIds:[
"aad//providers/Microsoft.Authorization/roleDefinitions/62ad50e4-1eb3-4ca4-948a-176509d6f538",
"42acf05d-0a2b-43f3-8b02-a05b03031eb7/a5287591e7",
"aad/a94ec34eb1",
]
ScopeIds:[
"azureRoot",
]
RequestScopesLimit:{
Value:34
}
ResourceGroups:{
IDs:["c79c2966-2758-4a7c-ad5a-7b6964b73ee8/resourceGroups/aks-rg",
"687d168e-d7e7-425f-a9b9-e98cb146143c/resourceGroups/rg-to-delete",
"687d168e-d7e7-425f-a9b9-e98cb146143c/resourceGroups/bestappever",
"687d168e-d7e7-425f-a9b9-e98cb146143c/resourceGroups/dev"]
}
}
Recurrence:{
Enabled:true
MaxTimeFrameDays:135
}
Approval:{
Required:false
}
JustificationRequired:true
}) {
AzureRoleDefinitionEligibility
{
Id
}
}
}Sample response
{
"data": {
"UpdateAzureRoleDefinitionEligibility": {
"AzureRoleDefinitionEligibility": {
"Id": "070783b0-a15d-4e48-8c54-3393104a4269"
}
}
}
}Update eligibilities for GCP
mutation {
UpdateGcpRoleEligibility(input:{Id:"2881dfe0-132d-4938-8ac6-e480063b4939"
Description: {Value: ""}
RequesterIds: ["User/123456789012", "User/f9c53f4280","example-529d7d","example-23c09e","example-23c09e","Group/f2a2b10cb6","example-3c259d", "example-c6cc26","Group/a79b72034b","example-1814f7", "User/fef39982d5"]
Permissions: {
RoleIds:["roles/axt.admin","roles/appengine.appViewer",
"organizations/123456789012/roles/CustomRole1",
"projects/example-project/roles/CustomServiceAccount1"
]
ScopeIds:["gcpRoot"]
AccountsLimit:{
Value:15
}
}
JustificationRequired:false
Duration: "PT5H",
Recurrence:{
Enabled:false
}
,
}) {
GcpRoleEligibility
{
Id
}
}
}Sample response
{
"data": {
"UpdateGcpRoleEligibility": {
"GcpRoleEligibility": {
"Id": "2881dfe0-132d-4938-8ac6-e480063b4939"
}
}
}
}Update eligibilities for Microsoft Entra ID, Okta, Google Workspace, or Ping Identity
The following example shows a Ping Identity mutation. For other providers listed in the section title, use the corresponding Update<Provider>GroupEligibility mutation.
mutation {
UpdatePingIdentityGroupEligibility(input:{Id:"dbc40f75-2b20-4994-80e5-41d88a3dda48"
Name:"example-fdec40"
Description: {Value: "example-6da4c3"},
JustificationRequired: true,
Duration: "PT5H",
RequesterIds:["c09cbb65-a70d-4525-8303-b9070be8d80c/42f287863f","bc1ebddb-81d7-4b8e-8a2f-82d32ec8eb07/de0b714389"],
Permissions: {
GroupIds: ["71994285-0123-4a9f-8313-e2e8c53fc43c/f25e8407bd"]
},
Recurrence: { Enabled: false},
Approval:{
Required:true
ApproverLevels:[
[ "207bfdf2-c9d5-47ea-8ebd-98735ff065e4/c0af50735a"]
]
}
}) {
PingIdentityGroupEligibility
{
Id
}
}
}Sample response
{
"data": {
"UpdatePingIdentityGroupEligibility": {
"PingIdentityGroupEligibility": {
"Id": "dbc40f75-2b20-4994-80e5-41d88a3dda48"
}
}
}
}Update eligibilities for OneLogin
UpdateOneLoginRoleEligibility(input:{Id:"0d14b402-e897-468b-8121-293186b48cfa"
Name:"example-a14b14"
Description: {Value: "example-8bf9ab"},
RequesterIds:["5b916651-4644-4e62-8ddd-29e9703a87d0/6b05e64bf7"]
JustificationRequired: true,
Permissions: {RoleIds: ["5b916651-4644-4e62-8ddd-29e9703a87d0/a55cb3e975"]}
Duration:"PT23H"
Recurrence: { Enabled: false},
Approval:{
Required:true
ApproverLevels:[
["5b916651-4644-4e62-8ddd-29e9703a87d0/b76570c288","example-61e012"],
["5b916651-4644-4e62-8ddd-29e9703a87d0/1000b44715","72539","example-74b951"],
["5b916651-4644-4e62-8ddd-29e9703a87d0/b74b79c426"]
]
}
}
) {
OneLoginRoleEligibility
{
Id
}
}
}Sample response
{
"data": {
"UpdateOneLoginRoleEligibility": {
"OneLoginRoleEligibility": {
"Id": "0d14b402-e897-468b-8121-293186b48cfa"
}
}
}
}Delete Eligibilities
mutation {
DeleteEligibility(input:{
Id: "cdbcf6c3-ff84-4857-bd61-d674729ff72e"
}){
Deleted
}
}Sample response
{
"data": {
"DeleteEligibility": {
"Deleted": true
}
}
}List JIT Principals
Use this to list and view the available principal values.
query {
JitPrincipals(filter: {
Names: ["Security Reviewer"]
Mails: ["[email protected]"]
Types: [AwsSsoGroup, AzureAdGroup]
}){
nodes {
AccountId
Id
Provider
Name
Mail
Type
}
}
}Sample response
{
"data": {
"JitPrincipals": {
"nodes": [
{
"AccountId": "C0bwmv63q",
"Id": "Group/0lcvrp47g2b00fe",
"Provider": "GoogleWorkspace",
"Name": "Security Reviewer",
"Mail": "[email protected]",
"Type": "GoogleWorkspaceGroup"
}
]
}
}
}Requests
List eligibility scopes
Use this operation to return the scopes you’re allowed to request for a specific eligibility.
List eligibility scopes for AWS
query{
AwsPermissionSetEligibilityAccessRequestScopes(filter:{PermissionEligibilityId:"077b7cb3-a148-48cd-840b-0480bf4bd83c",Text:"91161"})
{
totalCount
nodes{
Id
Name
__typename
}
}
}Sample response
{
"data": {
"AwsPermissionSetEligibilityAccessRequestScopes": {
"totalCount": 1,
"nodes": [
{
"Id": "0ceb85af-b144-4dcd-8813-f5637b210998",
"Name": "0098e78d-1459-4595-8b63-0bf14c3c9e90",
"__typename": "AwsPermissionSetEligibilityAccessRequestScope"
}
]
}
}
}List eligibility scopes for Azure
query{
AzureRoleDefinitionEligibilityAccessRequestScopes(filter:{PermissionEligibilityId:"28f1b213-19b0-42da-85c4-6fec51ec4810", Type:Subscription}){
totalCount
nodes{
Name
Id
__typename
}
}
}
Sample response
{
"data": {
"AzureRoleDefinitionEligibilityAccessRequestScopes": {
"totalCount": 2,
"nodes": [
{
"Name": "Org1Subscription1",
"Id": "6dda093d-7da1-4c52-8a49-a3298bb6ebb7",
"__typename": "AzureRoleDefinitionEligibilityAccessRequestScope"
},
{
"Name": "Org1Subscription2",
"Id": "2c8b2244-16e8-49f2-84a6-4a5ef2d2e234",
"__typename": "AzureRoleDefinitionEligibilityAccessRequestScope"
}
]
}
}
}List eligibility scopes for GCP
query{
GcpRoleEligibilityAccessRequestScopes(filter:{PermissionEligibilityId:"3a7d9e3d-5f6c-4f2a-8b47-1163a7dfe8f5"})
{
totalCount
nodes{
Id
Name
__typename
}
}
}Sample response
{
"data": {
"GcpRoleEligibilityAccessRequestScopes": {
"totalCount": 6,
"nodes": [
{
"Id": "7271d7c0-cb33-4938-8c69-1a21cf617fae",
"Name": "exampleProject",
"__typename": "GcpRoleEligibilityAccessRequestScope"
},
{
"Id": "7f375bdb-4100-4c63-8a99-cd5b2384471f",
"Name": "10ce6e28-4222-43b8-8203-29d06298faab",
"__typename": "GcpRoleEligibilityAccessRequestScope"
},
{
"Id": "5b2b538c-5e37-4553-802b-55b9699b88de",
"Name": "10ce6e28-4222-43b8-8203-29d06298faab",
"__typename": "GcpRoleEligibilityAccessRequestScope"
},
{
"Id": "ed912c6b-c9ef-4beb-8622-d9a3ec56e5dc",
"Name": "a82aa7d6-89b8-4329-8656-5f9e4f6950f8",
"__typename": "GcpRoleEligibilityAccessRequestScope"
},
{
"Id": "55d046b4-81ab-4724-8304-9e7dd3e2e2bc",
"Name": "c45f7ef0-9767-4b50-8ad6-3e006064af0e",
"__typename": "GcpRoleEligibilityAccessRequestScope"
},
{
"Id": "0ceb85af-b144-4dcd-8813-f5637b210998",
"Name": "561e8400-9f64-4dd0-89cf-3ef8c6331098",
"__typename": "GcpRoleEligibilityAccessRequestScope"
}
]
}
}
}Create requests
Use this operation to submit a JIT access request based on an existing eligibility.
Create requests for AWS accounts
mutation{
CreateAwsPermissionSetAccessRequest(input:{
Duration:"PT1H",
Justification:"5868",
RequesterId:"83aedda6-0ca4-4ab2-80e8-c818ac881bf5",
PermissionEligibilityId:"dfcd19f0-56a1-495c-8f35-7b97ed5c6f41",
Permissions:{
ScopeIds:[
"444455556666",
"444455556666",
"123456789012",
"123456789012",
"123456789012"
]
}
}){
AwsPermissionSetAccessRequestId
}
}Sample response
{
"data": {
"CreateAwsPermissionSetAccessRequest": {
"AwsPermissionSetAccessRequestId": "aa5000b3-5eef-449b-8650-5ba27e653e78"
}
}
}Create requests for AWS applications
mutation {
CreateAwsApplicationAccessRequest(
input: {
PermissionEligibilityId: "6586ebf8-536b-4f80-89ff-d137cdc97da5"
RequesterId: "69230b5b-3f5e-4424-86c5-8faeff7d4d36"
Justification: "Example{
"data": {
"CreateAwsApplicationAccessRequest": {
"AwsApplicationAccessRequestId": "3c3accca-168c-43b3-84c1-f0303bb0cc51",
"__typename": "CreateAwsApplicationAccessRequestOutput"
}
}
}{ "data": { "CreateAwsApplicationAccessRequest": { "AwsApplicationAccessRequestId": "0649305c-6cfd-4f1d-841f-f6383e242340", "__typename": "CreateAwsApplicationAccessRequestOutput" } } }"
Duration: "PT2H"
ScheduledTime: "2027-01-15T18:21:00.000Z"
}
) {
AwsApplicationAccessRequestId
__typename
}
}
Sample response
{
"data": {
"CreateAwsApplicationAccessRequest": {
"AwsApplicationAccessRequestId": "c3009471-c836-4adc-8a3e-62e8b4cb5112",
"__typename": "CreateAwsApplicationAccessRequestOutput"
}
}
}Create requests for Azure
mutation{
CreateAzureRoleDefinitionAccessRequest(input:{
Duration:"PT1H",
Justification:"0826",
RequesterId:"bd948d93-fceb-4d9a-86e4-e1836d7fef6c",
PermissionEligibilityId:"5e405847-2172-4dac-83ef-f67f27cbacdd",
Permissions:{
RoleDefinitionIds:[
"aad/432775aba8",
"/providers/Microsoft.Authorization/roleDefinitions/9f1b7a6c-2d84-4e31-b5c9-0a7d6e3f8b14"
]
ScopeIds:[
"28d3f7d6-908d-476f-8a75-a01b80da62c2",
"9f1b7a6c-2d84-4e31-b5c9-0a7d6e3f8b14"
]
}
}){
AzureRoleDefinitionAccessRequestId
}
}
Sample response
{
"data": {
"CreateAzureRoleDefinitionAccessRequest": {
"AzureRoleDefinitionAccessRequestId": "0995e1c2-b4bf-41d0-8482-6ed407ec5c2d"
}
}
}Create requests for GCP
mutation{
CreateGcpRoleAccessRequest(input:{
Duration:"PT10H",
Justification:"9274",
RequesterId:"User/75f86a4941",
PermissionEligibilityId:"61a1d60f-6669-4911-831b-c8e214f43a62",
ScheduledTime:"2026-11-12T16:59:39+00:00"
Permissions:{
RoleIds:[
"roles/1db3499f3a"
"roles/594d87a348"
],
ScopeIds:[
"444455556666",
"123456789012"
]
}
}){
GcpRoleAccessRequestId
}
}
Sample response
{
"data": {
"CreateGcpRoleAccessRequest": {
"GcpRoleAccessRequestId": "b6d5ccca-7236-4070-84e2-5874cd5eab46"
}
}
}Create requests for Microsoft Entra ID, Okta, OneLogin, Google Workspace, or Ping Identity
The following example shows a Microsoft Entra ID mutation. For other providers listed in the section title, use the corresponding Create<Provider>AccessRequest mutation.
mutation{
CreateAzureAdGroupAccessRequest(input:{
Duration:"PT1H",
Justification:"s",
RequesterId:"3900062f-e605-42dd-8564-69b4e82eb79f",
PermissionEligibilityId:"b87c7cab-255d-4348-8414-316e28f7389c",
ScheduledTime:"2026-11-13T16:00:00+00:00"
}){
AzureAdGroupAccessRequestId
}
}Sample response
{
"data": {
"CreateAzureAdGroupAccessRequest": {
"AzureAdGroupAccessRequestId": "3f4cdb08-fdc0-4160-89b8-deed9d04f694"
}
}
}Updated 7 days ago
