Skip to main content

Teams

The Team Management page provides a centralized view to organize your organizational structure: business units, teams, users, and applications. Business units group related teams, and each team holds members and the applications they work on. Assigning an application to a team scopes access to that application: each team member holds View or Edit permission.

Use the Team Management page to:

  • Identify unassigned or misconfigured resources
  • Maintain clear team ownership
  • Manage business units and teams

Team Management page

Overview​

The Team Management page reports four metrics:

  • Applications with no team — Number of applications not assigned to any team
  • Applications in multiple teams — Number of applications assigned to more than one team
  • Users not in any team — Number of users not assigned to any team
  • Teams active — Total number of active teams

The page organizes its content into four tabs:

  • Business Units — Displays all business units and their assigned leads
  • Teams — Displays teams and their associated members and applications
  • Users — Displays users and their team assignments. Add users, update user roles and display names, and remove users from this tab to keep access controlled and user information current.
  • Applications — Displays all applications and their associated environments, teams, and scan status. Create applications, download application data, assign applications to teams, and remove team associations from this tab.

Open the Team Management page​

Every task on this page starts from the Team Management page:

  1. Open your browser and visit: https://<your-tenant>.apisecapps.com

  2. Click Teams in the side navigation.

    Teams option in the side navigation

Create a business unit​

  1. On the Team Management page, click Create Business Unit.

    Create Business Unit button

  2. In the New Business Unit form, complete the fields:

    • Business Name — Enter a name for the business unit.
    • Business Unit Lead — Enter the email address of the business unit lead.
  3. Click Submit.

    New Business Unit form with the Submit button

  4. The new business unit appears in the list.

    Business unit list showing the new business unit

Edit a business unit​

  1. Click the edit icon (pencil) for the business unit.

    Edit icon for a business unit

  2. In the Edit Business Unit form, update the fields and click Save.

    Edit Business Unit form with the Save button

  3. The updated business unit appears in the list.

    Business unit list after the update

Delete a business unit​

  1. Click the delete icon for the business unit.

    Delete icon for a business unit

  2. Click Delete to confirm.

    Delete confirmation dialog

  3. The deleted business unit no longer appears in the list.

    Business unit list after deletion

Create a team​

Create a team from the Business Units tab or the Teams tab.

From the Business Units tab​

  1. The Business Units tab lists your existing business units.

    Business units list

  2. Expand the business unit where you want to create the team.

    Expanded business unit

  3. Click Create team.

    Create team button in an expanded business unit

  4. The New Team form appears.

    New Team form

  5. Complete the form:

    • Team Name — Enter a name for your team.
    • Team Owner — Enter the email address of the team owner. The owner must be a member of the tenant.
    • Select Business Unit — Select a business unit.
    • Team Members — Enter and select valid email addresses of team members. Each member must be a member of the tenant. Assign each member View or Edit permission.
  6. Click Create Team.

    Completed New Team form with the Create Team button

    note

    For SSO users, the system displays an SSO tag beside the email address in the auto-complete options.

  7. The new team appears in the business unit.

    New team listed in the business unit

From the Teams tab​

  1. Select the Teams tab in Team Management.

    Teams tab in Team Management

  2. The tab lists your existing teams.

    Existing teams list

  3. Click Create Team.

    Create Team button

  4. The New Team form appears.

    New Team form

  5. Complete the form:

    • Team Name — Enter a name for your team.
    • Team Owner — Enter the email address of the team owner. The owner must be a member of the tenant.
    • Select Business Unit — Select a business unit.
    • Team Members — Enter and select valid email addresses of team members. Each member must be a member of the tenant. Assign each member View or Edit permission.
  6. Click Create Team.

    Completed New Team form with the Create Team button

    note

    For SSO users, the system displays an SSO tag beside the email address in the auto-complete options.

  7. The new team appears in the list.

    Teams list showing the new team

Change the team owner​

  1. Click the edit icon (pencil) for the team.

    Edit icon for a team

  2. The team details appear.

    Team details view

  3. Click the edit icon (pencil) next to Team Owner.

    Edit icon next to Team Owner

  4. Enter and select the new owner's email address.

    Email field for the new team owner

  5. The team owner is updated.

    Team details showing the updated owner

Add team members​

New members must be members of the tenant.

To add a member from the team edit view:

  1. Click the edit icon (pencil) for the team to open the team details.

  2. Enter the email address in the Add Member input and click Invite.

    Add Member input with the Invite button

  3. To change a member's permissions, select View or Edit for that member.

    Permission selector for a team member

To add a member from the team details in the teams list:

  1. Expand the team.

    Expanded team in the teams list

  2. Click Add member.

    Add member button

  3. Enter the email address in the Add Member input and click Invite.

    Add Member input with the Invite button

  4. The new member appears in the team details.

    Team details showing the new member

Remove team members​

To remove a member from the team edit view:

  1. Click the delete icon next to the team member.

    Delete icon next to a team member

  2. Click Remove to confirm.

    Remove confirmation dialog

To remove a member from the team details in the teams list:

  1. Click the delete icon next to the team member in the team details.

    Delete icon next to a team member in team details

  2. Click Remove to confirm.

    Remove confirmation dialog

Assign applications to a team​

  1. Select the Teams tab in Team Management.

    Teams tab in Team Management

  2. The tab lists your existing teams.

    Existing teams list

  3. Expand the team you want to assign applications to.

    Expanded team

  4. Click Assign Applications.

    Assign Applications button

  5. Select the application(s) and click Assign.

    Application selection with the Assign button

  6. The application appears in the Assigned Applications section.

    Assigned Applications section showing the application

Remove applications from a team​

  1. On the Teams tab, expand the required team.

  2. In the Assigned Applications section, click the delete icon for the application.

    Delete icon for an assigned application

  3. Click Confirm to remove the application.

    Confirm dialog for removing the application

  4. The Assigned Applications section displays "No applications assigned to this team yet".

    Assigned Applications section with no applications

Delete a team​

  1. In the Teams tab, click the delete icon for the team.

    Delete icon for a team

  2. Click Delete to confirm.

    Delete confirmation dialog

  3. The deleted team no longer appears in the list.

    Teams list after deletion

Add users​

  1. Select the Users tab in Team Management.

    Users tab in Team Management

  2. Click Invite User.

    Invite User button

  3. The New User form appears. Add a single user or multiple users, or create users in bulk from a CSV file (steps 6-7).

    New User form

  4. Enter the user's Email and Display Name, and select a Role (User, Admin, Viewer, or Global Viewer).

    • The User role provides visibility into applications, scans, vulnerabilities, and reports for applications shared with the user, and also allows the user to create applications, run scans, and perform configuration or operational actions on applications they own.
    • The Viewer role is view-only: visibility into applications, scans, vulnerabilities, and reports, without the ability to make changes or run operations. The Global Viewer role is the same, but across every application in the tenant.

    User details in the New User form

  5. To add another user, click the + icon and enter the Email, Display Name, and Role. Repeat to add as many users as you need.

    Plus icon for adding another user

  6. To add multiple users from a CSV file, click Upload CSV and select the file. If you need a template, click Download Sample CSV to download and review the sample file. Review the list the form shows before you submit.

    Upload CSV button

  7. The form lists the users uploaded from the CSV file. Edit, update, or delete users as needed. The form highlights duplicate users and validation errors, and the submit action stays disabled until you correct them. After you submit, track progress in the activity logs.

    List of users uploaded from the CSV file

  8. Click Add User(s).

    Add User(s) button

  9. The new users appear in the users list.

    Users list showing the new users

Edit a user​

  1. Click the edit icon (pencil) for the user.

    Edit icon for a user

  2. The user form appears with the user's details.

    User form with existing details

  3. Change the Display Name and Role as needed, then click Update User.

    User form with the Update User button

Assign a user to a team​

  1. In the Users tab, click Assign to team for the user.

    Assign to team option for a user

  2. Select the team.

    Team selection for the user

  3. Select the permission and click Assign.

    Permission selection with the Assign button

  4. Verify the user details.

    Users list showing the team assignment

Remove a user from a team​

  1. In the Users tab, click the remove icon (×) in the Teams column for the user.

    Remove icon in the Teams column

  2. Click Remove to confirm.

    Remove confirmation dialog

  3. Verify that the user is no longer associated with the team.

    Users list after the removal

Delete a user​

  1. In the Users tab, click the delete icon for the user.

    Delete icon for a user

  2. Click Delete to confirm.

    Delete confirmation dialog

  3. After deletion, the user no longer appears in the Users tab.

    Users list after deletion

Assign a team to an application​

  1. In the Applications tab, click Assign team for the application.

    Assign team option for an application

  2. Click Browse all teams.

    Browse all teams button

  3. Select the team and click Add selected teams to this application.

    Team selection with the Add selected teams to this application button

  4. The assigned team appears in the Teams column for the application.

    Teams column showing the assigned team

Remove a team from an application​

  1. In the Applications tab, click Review team for the application.

    Review team option for an application

  2. Select the team and click Remove teams from this application.

    Team selection with the Remove teams from this application button

  3. After removal, the Teams column displays "No team assigned".

    Teams column showing No team assigned