> For the complete documentation index, see [llms.txt](https://learn.heeler.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://learn.heeler.com/tenant-admin-guide.md).

# Tenant Admin Guide

This guide covers the **Administration** area of Heeler from the perspective of a **Tenant Admin** — the role responsible for configuring Heeler for your organization. Standard Users have read access to most of the product but cannot configure the items described here; see [Roles/Permissions](/getting-started/user-management/roles-permissions.md) for the full role comparison.

If you're a Tenant Admin, this is your map.

### Where to find Administration

Open the **gear icon** in the top-right of any Heeler page. You'll land on the Administration area, which is organized into top-level tabs across the page header.

The URL for the area is: <https://app.heeler.com/administration/>

### What's in Administration

| Section            | What it's for                                                                                                                                  |
| ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| Connections        | Connect Heeler to your code (SCM), cloud accounts, Kubernetes clusters, container registries, and on-prem networks.                            |
| Integrations       | Connect to communication and ticketing tools (Slack, Microsoft Teams, Jira, Linear, Shortcut, etc.).                                           |
| Access             | Manage users, API keys, SAML SSO, SCIM provisioning, and the audit log.                                                                        |
| Connection Mapping | Map your raw connections into the logical groupings Heeler uses for routing and reporting — Teams, Applications, Environments, Ticketing.      |
| Program            | Configure how Heeler runs your security program — Agent PR Template, License Policy, Remediations, SLOs — and view tickets Heeler has created. |
| Operational Health | Monitor scan health, registry connections, errors and warnings across your tenant.                                                             |
| Agent Executions   | View the history of agent-based remediation runs across your tenant.                                                                           |

### Setup and onboarding&#x20;

Please see the [Getting Started](/getting-started.md) documentaton for setup and onboarding guidance.&#x20;


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://learn.heeler.com/tenant-admin-guide.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.