feat(googleworkspace): add groups service checks

[lydiavilchez]

Context

Groups service checks for the Google Workspace provider. This PR implements the 3 automatable CIS controls for Groups for Business using the Cloud Identity Policy API (groups_for_business.groups_sharing setting).

Description

Implements 3 CIS Google Workspace Groups controls covering external access, group creation restrictions, and conversation visibility:

Groups (3):

• 3.1.6.1 — Accessing groups from outside the organization: PASS if collaboration_capability is DOMAIN_USERS_ONLY or absent (secure default)
• 3.1.6.2 — Group creation restricted to admins: PASS if create_groups_access_level is ADMIN_ONLY, owners_can_allow_external_members is false, and owners_can_allow_incoming_mail_from_public is false
• 3.1.6.3 — Default permission to view conversations: PASS if view_topics_default_access_level is GROUP_MEMBERS

Default field values from the Policy API are handled explicitly: fields absent from the API response are treated according to their documented defaults (DOMAIN_USERS_ONLY is secure for 3.1.6.1; USERS_IN_DOMAIN and true for incoming mail are insecure for 3.1.6.2; DOMAIN_USERS is insecure for 3.1.6.3).

Checklist

Community Checklist

• This feature/issue is listed in here or roadmap.prowler.com
• Is it assigned to me, if not, request it via the issue/feature in here or Prowler Community Slack

• Review if the code is being covered by tests.
• Review if code is being documented following this specification https://github.com/google/styleguide/blob/gh-pages/pyguide.md#38-comments-and-docstrings
• Review if backport is needed.
• Review if is needed to change the Readme.md
• Ensure new entries are added to CHANGELOG.md, if applicable.

SDK/CLI

• Are there new checks included in this PR? Yes / No
  • If so, do we need to update permissions for the provider? Please review this carefully.

UI

• All issue/task requirements work as expected on the UI
• If this PR adds or updates npm dependencies, include package-health evidence (maintenance, popularity, known vulnerabilities, license, release age) and explain why existing/native alternatives are insufficient.
• Screenshots/Video of the functionality flow (if applicable) - Mobile (X < 640px)
• Screenshots/Video of the functionality flow (if applicable) - Table (640px > X < 1024px)
• Screenshots/Video of the functionality flow (if applicable) - Desktop (X > 1024px)
• Ensure new entries are added to CHANGELOG.md, if applicable.

API

• All issue/task requirements work as expected on the API
• Endpoint response output (if applicable)
• EXPLAIN ANALYZE output for new/modified queries or indexes (if applicable)
• Performance test results (if applicable)
• Any other relevant evidence of the implementation (if applicable)
• Verify if API specs need to be regenerated.
• Check if version updates are required (e.g., specs, uv, etc.).
• Ensure new entries are added to CHANGELOG.md, if applicable.

License

By submitting this pull request, I confirm that my contribution is made under the terms of the Apache 2.0 license.

[github-actions]

✅ Conflict Markers Resolved

All conflict markers have been successfully resolved in this pull request.

[github-actions]

✅ All necessary CHANGELOG.md files have been updated.

[github-actions]

Compliance Mapping Review

This PR adds new checks. Please verify that they have been mapped to the relevant compliance framework requirements.

New checks already mapped in this PR

• groups_creation_restricted (googleworkspace): cis_1.3_googleworkspace, cisa_scuba_0.6_googleworkspace
• groups_external_access_restricted (googleworkspace): cis_1.3_googleworkspace, cisa_scuba_0.6_googleworkspace
• groups_view_conversations_restricted (googleworkspace): cis_1.3_googleworkspace, cisa_scuba_0.6_googleworkspace

Use the no-compliance-check label to skip this check.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 95.58%. Comparing base (6eebfcf) to head (947ea8d).
⚠️ Report is 4 commits behind head on master.

Additional details and impacted files

@@            Coverage Diff             @@
##           master   #11186      +/-   ##
==========================================
+ Coverage   93.97%   95.58%   +1.60%     
==========================================
  Files         237       60     -177     
  Lines       34829     1629   -33200     
==========================================
- Hits        32729     1557   -31172     
+ Misses       2100       72    -2028     

Flag	Coverage Δ
api	?
prowler-py3.10-googleworkspace	95.58% <100.00%> (?)
prowler-py3.11-googleworkspace	95.58% <100.00%> (?)
prowler-py3.12-googleworkspace	95.58% <100.00%> (?)

Flags with carried forward coverage won't be shown. Click here to find out more.

Components	Coverage Δ
prowler	95.58% <100.00%> (∅)
api	∅ <ø> (∅)

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[github-actions]

🔒 Container Security Scan

Image: prowler:f0063e8
Last scan: 2026-05-20 10:53:15 UTC

📊 Vulnerability Summary

Severity	Count
🔴 Critical	6
Total	6

5 package(s) affected

⚠️ Action Required

Critical severity vulnerabilities detected. These should be addressed before merging:

• Review the detailed scan results
• Update affected packages to patched versions
• Consider using a different base image if updates are unavailable

---

📋 Resources:

• Download full report (see artifacts)
• View in Security tab
• Scanned with Trivy

[danibarranqueroo]

Good job! Please review this two little suggestions.

[pedrooot]

🔝

[danibarranqueroo]

Thanks for this! 💯