> For the complete documentation index, see [llms.txt](https://cortex-docs.paloaltonetworks.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cortex-docs.paloaltonetworks.com/cortex-xsiam/reference-and-developer-docs/role-based-access-control/configuration-permissions/credentials-permissions.md).

# Credentials permissions

Manage access to Cortex XSIAM credentials and secure connection settings.

Controls access to stored credential sets (reusable authentication objects that integrations and systems reference for connecting to external services). Credential sets centralize sensitive authentication data (such as, usernames, passwords, certificates, and API tokens) so they can be managed in one place rather than being embedded in each integration configuration.

Users can access Credentials on the **Credentials** page by going to **Settings** → **Configurations** → **Integrations** → **Credentials**.

To view the **Credentials** page, users require the following **View** permissions:

* Integrations
* Data Sources
* External Issue Mapping

Without these permissions, users can't view the Credentials page.

For more information, see [Manage credentials](/cortex-xsiam/configure-cortex-xsiam/cortex-xsiam-data-sources/administration-and-troubleshooting/integrations/manage-credentials.md).

| Permission | Description                                                                                                                                                                                                                                                                         | Role Example                                                                                                                                                               |
| ---------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| None       | Completely revokes access to stored secrets. The **Credentials** page is hidden from the UI, all related Public API endpoints are blocked, and users cannot view or reference stored credentials in integrations, scripts, or playbooks.                                            | CLI Role, CLI Read Only Role                                                                                                                                               |
| View       | <p>Enables backend API read access to credential sets (e.g., for automation or API-based workflows).</p><p>If users have access to the Credentials page, they can view a list of stored credential sets and their names. Users can't create, modify, or delete credential sets.</p> | <ul><li>SOC Tier-1, 2, and 3 Analysts: May need to verify credential status/credential configurations.</li><li>Threat Hunter: Verify integration authentication.</li></ul> |
| View/Edit  | If users have access to the Credentials page, they can manage credential sets, including creating, deleting, and editing credentials.                                                                                                                                               | Security Engineer: Manage integration credentials.                                                                                                                         |

#### Required and recommended permissions

Credentials often serve as dependencies for other automation and integration tasks. Consider adding these permissions:

| Permission             | Permission Level  | Reason                                                                                                                                                                                                                                         |
| ---------------------- | ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Integrations           | View or View/Edit | <ul><li>View: Core permission to access the Credentials page. Required.</li><li>View/Edit: Highly Recommended. Users who manage credentials typically also need to configure integration instances that reference those credentials.</li></ul> |
| Data Sources           | View              | View: Core permission to access the Credentials page. Required.                                                                                                                                                                                |
| External Issue Mapping | View              | View: Core permission to access the Credentials page. Required.                                                                                                                                                                                |
| Playbooks              | Enabled           | Strongly recommended to view integrations that use the stored credentials.                                                                                                                                                                     |
| Scripts                | Enabled           | Strongly recommended to view scripts that may use credentials for external API calls.                                                                                                                                                          |
| Marketplace            | View              | Recommended. Allows browsing and installing integration content packs from the Marketplace, which may include integrations that use credential sets.                                                                                           |
| Audit                  | View              | Recommended to track credential creation, modification, and usage for security compliance.                                                                                                                                                     |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://cortex-docs.paloaltonetworks.com/cortex-xsiam/reference-and-developer-docs/role-based-access-control/configuration-permissions/credentials-permissions.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.