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:

📘

Note

  • See Administer JIT Access in the Tenable Cloud Exposure User Guide for more information on eligibilities.
  • You can use the ApproverLevels field 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

📘

Note

Under Permissions, if ResourceGroups are listed and ScopeIds is omitted, the scopes are taken from the listed ResourceGroups.

This might cause errors that seem related to ScopeIds but are actually from the ResourceGroups list.

If this happens, review and correct the ResourceGroups list.

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"
    }
  }
}

Did this page help you?