Add API Support to Parent Organization Admins to Share Users with Sub Organizations

[BimsaraBodaragama]

Purpose

This PR provides API support for managing user sharing in IS/Asgardeo, enabling parent organization admins to share and manage users with sub-organizations based on resource-sharing policies. This functionality addresses the gap in supporting direct user sharing from parent organizations to their sub-organizations.

Key Functionalities

This implementation introduces the following API capabilities:

1. Selective User Share:

   • Share users selectively with specific sub-organizations, applying unique resource-sharing policies and roles for each organization.

2. General User Share:

   • Share users across all sub-organizations using a general resource-sharing policy, with or without the same set of roles.

3. Selective User Unshare:

   • Unshare users from specific organizations.

4. General User Unshare:

   • Unshare users from all organizations.

5. Retrieve Shared Organizations:

   • Retrieve the list of organizations a user has been shared with.

6. Retrieve Shared Roles:

   • Retrieve roles assigned to a shared user in a specific organization.

---

Related Issue

Allow Parent Organization Admins to Share Users with Sub Organizations Based on Resource Sharing Policies with or without Roles #22331

[jenkins-is-staging]

PR builder started
Link: https://github.com/wso2/product-is/actions/runs/12980802249

[jenkins-is-staging]

PR builder completed
Link: https://github.com/wso2/product-is/actions/runs/12980802249
Status: success

[jenkins-is-staging]

Approving the pull request based on the successful pr build https://github.com/wso2/product-is/actions/runs/12980802249