> ## Documentation Index
> Fetch the complete documentation index at: https://docs-xcor.paloaltonetworks.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Accounts and teams

> Palo Alto Networks Cortex XCOR lets you manage user accounts, roles, and team permissions for streamlined access and collaboration.

Palo Alto Networks Cortex XCOR identifies users and services by their
*accounts*. As an administrator, you can organize accounts into *teams* and define
those teams' permissions.

* A [*user account*](https://docs-xcor.paloaltonetworks.com/administer/accounts-teams/user-accounts.md)
  represents a user's identity in Cortex XCOR.
* A [*service account*](https://docs-xcor.paloaltonetworks.com/administer/accounts-teams/service-accounts.md)
  represents a service's identity in Cortex XCOR.
* A [*team*](https://docs-xcor.paloaltonetworks.com/administer/accounts-teams/teams.md) organizes accounts into
  groups and defines permissions for sensitive management and administrative
  operations.

Add accounts to teams based on the permissions you want grant to those accounts. For
example, to make a user or service account an *administrator*, assign it to a team
that has the SysAdmin role. This grants the account access to special Cortex XCOR
features, including team and account management and assignment.

## View accounts and teams

> [tab] Web - accounts
>
> In the navigation menu, click \*\* Go to admin view\*\* and then select
> **Platform > Users**.
>
> The left-hand column lists all accounts. The list includes icons for
> additional context about each entry type:
>
> | Icon | Description |
> | :-: | - |
> | | An active user account. |
> | | A service account. |
> | | An invited user who's yet to confirm their account. |
> | | A deactivated user account. |
>
> A  **System Administrator** icon to the right of an entry
> indicates either a team that has the System Administrator (SysAdmin) role, or
> a user or service account that's a member of a team with that role.
>
> To view details about an account, select its name from the list. To filter by
> account name, enter part or all of the account's name in the **Search** field.
> To filter by account type or status, click the filter icon.
>
> When you select an account, Cortex XCOR displays the account's team
> **Memberships** and **Recent User Actions**.
>
> If your user account belongs to a team with the SysAdmin role, this view also
> provides options to add or remove the account from teams.

> [tab] Web - teams
>
> In the navigation menu, click \*\* Go to admin view\*\* and then select
> **Platform > Teams**.
>
> The table lists all teams by name and other details about their configuration:
>
> * **Role**: The role granted to all accounts in the team. The SysAdmin role
>   grants administrative privileges.
> * **Source**: The source of this team's configuration. **UI** teams are
>   configured in Cortex XCOR and can be edited in the app by users with
>   the SysAdmin role. **Terraform** teams are configured exclusively through
>   Terraform.
> * **Description**: A description of the team.
>
> To view a team's [home page](https://docs-xcor.paloaltonetworks.com/administer/collections/home.md), click
> its name in the list. If your user account is part of a team with the SysAdmin
> role, you can edit the team's name, role, description, links, and membership
> from its home page.

> [tab] Chronoctl
>
> You can use [Chronoctl](https://docs-xcor.paloaltonetworks.com/tooling/chronoctl) to list teams and their member accounts.
> This output includes the email address associated with each account. If an account's
> email address is an alphanumeric Cortex XCOR
> slug at the `serviceaccount.chronosphere.io` domain, that
> member is a [service account](https://docs-xcor.paloaltonetworks.com/administer/accounts-teams/service-accounts.md). Other
> email addresses represent user accounts.
>
> > [!NOTE]
> >
> > To view accounts and teams with Chronoctl, you must authenticate as a user
> > that belongs to a team with the SysAdmin role, or as an unrestricted
> > [service account](https://docs-xcor.paloaltonetworks.com/administer/accounts-teams/service-accounts.md).
>
> To list each team and its member accounts in separate YAML documents with
> [Chronoctl](https://docs-xcor.paloaltonetworks.com/tooling/chronoctl), use the `teams list` command. You can also use
> this output as a template for updating each team separately using Chronoctl.
>
> ```shell theme={null}
> chronoctl teams list
> ```
>
> The output contains YAML documents separated by three dashes (`---`). Each document
> contains one team and any of its member accounts.
>
> For example, this output lists a team named *Control team* with one user account
> and one service account as members, and a second team named *DBAs* with two
> user account members:
>
> ```yaml Chronoctl example icon="square-terminal" theme={null}
> api_version: v1/config
> kind: Team
> spec:
>   slug: control-team
>   name: Control team
>   user_emails:
>     - adam@example.com
>     - 4a5842df-4179-47c7-bcc0-d1e6589caaf0@serviceaccount.chronosphere.io
> ---
> api_version: v1/config
> kind: Team
> spec:
>   slug: dbas
>   name: DBAs
>   user_emails:
>     - adam@example.com
>     - betty@example.com
> ```

> [tab] API
>
> To list all teams with the Cortex XCOR API, use the
> [`ListTeams`](https://docs-xcor.paloaltonetworks.com/tooling/api-info/definition/operations/ListTeams) endpoint.
>
> To view a single team, use the
> [`ReadTeams`](https://docs-xcor.paloaltonetworks.com/tooling/api-info/definition/operations/ReadTeam) endpoint.
>
> Because the Cortex XCOR API requires authentication, include an API token with your
> `curl` request, as shown in the following example. For more details, see
> [Create an API token](https://docs-xcor.paloaltonetworks.com/tooling/api-info.md#create-an-api-token).
>
> ```shell /"TOKEN"/ /INSTANCE/ /METHOD/ /ENDPOINT_PATH/ theme={null}
> export CHRONOSPHERE_API_TOKEN="TOKEN"
> export CHRONOSPHERE_DOMAIN="INSTANCE.chronosphere.io"
>
> curl -H "API-Token: ${CHRONOSPHERE_API_TOKEN}" \
>      -X METHOD "https://${CHRONOSPHERE_DOMAIN}/ENDPOINT_PATH"
> ```
>
> Replace the following:
>
> * *`TOKEN`*: Your API token.
> * *`INSTANCE`*: The subdomain name for your organization's Cortex XCOR instance.
> * *`METHOD`*: The HTTP method to use with the request, such as `GET` or `POST`.
> * *`ENDPOINT_PATH`*: The specific endpoint you want to access.

## Grant System Administrator (SysAdmin) privileges to a team

A user account that's a member of a [team](https://docs-xcor.paloaltonetworks.com/administer/accounts-teams/teams.md) with
the `SysAdmin` role has administrative access to Cortex XCOR features,
including the abilities to create teams and user accounts, assign users to teams,
and define team permissions.

For instructions about assigning roles to a team, see
[Add a role to a team](https://docs-xcor.paloaltonetworks.com/administer/accounts-teams/teams.md#add-a-role-to-a-team).


## Related topics

- [Teams](https://docs-xcor.paloaltonetworks.com/administer/accounts-teams/teams.md)
- [User accounts](https://docs-xcor.paloaltonetworks.com/administer/accounts-teams/user-accounts.md)
- [Service accounts](https://docs-xcor.paloaltonetworks.com/administer/accounts-teams/service-accounts.md)
- [Personal access tokens](https://docs-xcor.paloaltonetworks.com/administer/accounts-teams/personal-access-tokens.md)
- [Metrics dictionary](https://docs-xcor.paloaltonetworks.com/overview/concepts/dictionary.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.