OJ-54189 Enable using group names to pull Jira users

example.yml

@@ -127,11 +127,19 @@ jira:
   #   - jellyfish.co
 
   # it's possible for a user to have no email.  if we need to restrict users
-  # by email domain, should null-email users be included?  uncomment this 
+  # by email domain, should null-email users be included?  uncomment this
   # if they shouldn't:
   #
   # is_email_required: True
 
+  # If provided, only pull users who are members of these Jira groups instead
+  # of using the default bulk user search. If omitted, all discoverable users
+  # are pulled.
+  #
+  # user_group_names:
+  #   - jira-software-users
+  #   - engineering-team
+
   # This is a special run mode that allows you to skip saving your JIRA data
   # locally, and instead continuously submit it via S3. This run mode is good
   # if you plan to upload a VERY large amount of data (like an initial upload

jf_agent/config_file_reader.py

@@ -75,6 +75,7 @@
         'jira_exclude_project_categories',
         'jira_required_email_domains',
         'jira_is_email_required',
+        'jira_user_group_names',
         'jira_issue_jql',
         'jira_download_worklogs',
         'jira_download_sprints',
@@ -168,6 +169,7 @@
     jira_gdpr_active = jira_config.get('gdpr_active', False)
     jira_required_email_domains = set(jira_config.get('required_email_domains', []))
     jira_is_email_required = jira_config.get('is_email_required', False)
+    jira_user_group_names = list(jira_config.get('user_group_names', []))
     jira_include_projects = set(jira_config.get('include_projects', []))
     jira_exclude_projects = set(jira_config.get('exclude_projects', []))
     jira_include_project_categories = set(jira_config.get('include_project_categories', []))
@@ -284,6 +286,7 @@
         jira_exclude_project_categories,
         jira_required_email_domains,
         jira_is_email_required,
+        jira_user_group_names,
         jira_issue_jql,
         jira_download_worklogs,
         jira_download_sprints,
@@ -455,6 +458,7 @@
             # User Info
             required_email_domains=config.jira_required_email_domains,
             is_email_required=config.jira_is_email_required,
+            jira_user_group_names=config.jira_user_group_names,
             #
             # Projects Info
             include_projects=config.jira_include_projects,
@@ -507,8 +511,8 @@
             instance_creds = creds.git_instance_to_creds.get(instance_slug)
         else:
             # If there's only one git config set, the instance slug may not be provided.
             endpoint_git_instance_info = list(endpoint_git_instances_info.values())[0]
             instance_creds = list(creds.git_instance_to_creds.values())[0]
             instance_slug = endpoint_git_instance_info['slug']
 
         if agent_git_config.git_provider == GH_PROVIDER and not endpoint_git_instance_info.get(

pyproject.toml

@@ -20,7 +20,7 @@ dependencies = [
     "python-dotenv>=1.0.0",
     "structlog>=24.4.0",
     "colorama>=0.4.6",
-    "jf-ingest==0.0.285",
+    "jf-ingest==0.0.288",
 ]
 requires-python = ">=3.13,<3.14"
 readme = "README.md"