> For the complete documentation index, see [llms.txt](https://docs.logilica.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.logilica.com/integration/connecting-tools/humanitec.md).

# Humanitec

The Humanitec connector imports your applications, environments, and deployments into Logilica, so deployment activity and reliability feed directly into your [DORA metrics](/configuration/dora-configuration.md).

## Authentication

Humanitec is a standalone connector authenticated with a Humanitec API token and your Humanitec organisation ID. Logilica sends the token as a Bearer credential against the Humanitec API (`https://api.humanitec.io/orgs/{orgId}`) and reads data for the organisation you supply. See [Connecting Tools](/integration/connecting-tools.md) for how to add the token and organisation ID.

## What's Imported

For the connected organisation, Logilica walks the full hierarchy and imports:

* **Applications** — name, creation time, and creator
* **Environments** — name, namespace, environment type, creation time, and creator, plus references to each environment's first and most recent deployment
* **Environment types** — the organisation's environment type definitions and their descriptions
* **Deployments** — comment, creation time, the user who deployed, the deployment status, and the time the status last changed
* **Users** — the people who created applications, environments, and deployments are recorded as contributor identities

## How the Data Feeds DORA

Logilica models Humanitec as an Applications → Environments → Deployments hierarchy. Imported deployments feed Logilica's [DORA metrics](/configuration/dora-configuration.md) — deployment frequency and time to recovery in particular.

## Good to Know

* **Kept in sync automatically.** After the initial import, Logilica refreshes this connection on a regular schedule — you don't need to re-trigger imports.
* **The whole organisation is imported.** The connector walks every application, environment, and deployment in the organisation you connect, rather than a single project. Connect the organisation whose deployment activity you want in Logilica.
* **Deployment status drives DORA.** Logilica relies on Humanitec's `failed` and `succeeded` deployment statuses. Deployments in other states still import but do not contribute to recovery timing.
* **Contributor identities come from deployment metadata.** People are discovered from the creators of applications, environments, and deployments. A user who has never created any of these will not appear.
* **It feeds DORA.** Imported deployments power Logilica's [DORA metrics](/configuration/dora-configuration.md) — deployment frequency and time to recovery in particular.