Overview

This article teaches how to create a report in Okta Workflows. For a given application, the report lists all associated groups and the owner of each group, if one has been assigned.

Solution

The report uses two flows:

1. A flow to list all app groups
2. A helper flow to list the owner for each group

A flow to list all app groups

The List app groups flow lists the group assigned to an app:

 
List application groups flow.

How the flow works

1. The Helper Flow card has an input to enter an app name. This is the app for which you need to list groups and owners.
2. The group information and owners are saved in a table. The flow clears the table before each run with the Tables-Clear Table card.
3. The Okta Search Applications card provides additional information about the application.
4. The Text-Compose card creates an API endpoint URL for the next card.
5. The Okta-Custom API Action card invokes the /api/v1/apps/ID/groups endpoint.
   • The call includes the expand=group parameter. This parameter adds a group name for each group in the list.
   • The parameter _embedded.group.profile.name holds the group name.
   • The flow utilizes the Custom API Action cards, as the Okta-Search Groups card does not include group name information.
6. The flow passes the group list to the List-For Each card to process each group and list the group owner.

A helper flow to list the owner for each group

List group owner helper flow:

 
List group owner helper flow.

How the flow works

1. The main flow passes three fields to the helper flow:
   • Group ID
   • Group name
   • App name
2. The Text-Compose card creates an API endpoint to list the group owner.
3. The Okta-Custom API Action card invokes the /api/v1/apps/ID/groups endpoint to list the group owner.
4. The Object-Get card retrieves the group name.
5. The Tables-Create Row saves information. It creates a table row with App name, Group name, and Group owner (if set).

The table looks like this:

 
Table showing groups assigned to an app and group owners.

Related References

• How to List User’s Direct Reports in Workflows
• Getting Started with Okta Workflows - Create a Report