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

# 身份映射

> 将一个人使用的多个身份归并为单条人员记录。

同一个人在你的机群中会以多个身份出现——某台主机上的 Linux 登录名、另一台主机上不同的登录名、SSH 会话、Teleport 会话、一台笔记本电脑。身份映射页面让你为这个人命名一次，并把这些身份归属到他名下，从而将跨端点和主机的活动关联到同一个人，而不是散落在一堆原始登录名中。

入口在 **设置 → 团队 → 身份映射**。本页面需要 **manage users** 权限，且仅在使用 PostgreSQL 认证时可用（静态管理员模式下隐藏）。

> [!NOTE]
>
> 无需配置身份目录。此页面的早期版本只能给观察到的身份附加 Okta 资料字段，这意味着在未配置 Okta 同步时它完全不起作用。现在，映射本身就是人员记录。

***

## 工作原理

你提供已知信息，Hilt 推导其余部分。

1. 你创建一个人员，并归属一两个你确定的身份——通常是他的笔记本电脑或主要登录名。
2. 当该端点通过 SSH 连接到某台主机时，Hilt 会自动把目标主机**以及**他在那里使用的登录名归属到同一个人。
3. 这些推导出的关联标记为 **auto**，并会持续自动产生。无需手工维护任何列表。

通用登录名（`root`、`ec2-user`、`ubuntu` 等）永远不会被自动归属，因为它们无法说明操作者是谁。

***

## 页面结构

左栏列出你创建的所有人员，以及归属给每个人的身份数量。可按姓名、邮箱，或任何已归属的登录名进行搜索——人们往往记住的是用户名而非姓名。选中某人后，右侧会显示其详情。

***

## 添加人员

点击 **添加人员**。

| 字段 | 是否必填 | 说明 |
| - | - | - |
| **姓名** | 是 | 该人员的姓名，将在整个产品中显示 |
| **邮箱** | 否 | 记录上的可选信息；它不是登录名，也不会用于匹配 |
| **其身份** | 否 | 可现在归属，也可以之后随时归属 |

***

## 归属身份

在人员详情面板中点击 **归属身份**。选择器会列出流水线实际观察到的身份，按活跃度从高到低排列，并展示足够的上下文，让你在确认之前能区分不同的 `alice`：

| 展示内容 | 意义 |
| - | - |
| **来源** | 该名称出现过的所有来源——Linux 用户、SSH 会话、macOS 设备、Teleport 等 |
| **主机数与事件数** | 该身份的使用范围和使用强度 |
| **最近可见** | 判断这是仍在活跃的身份，还是已经沉寂的身份 |
| **主机名** | 它接触过的机器 |

搜索针对全部观察到的身份，而不仅是屏幕上显示的那几行。

归属一个在多个来源下被观察到的身份时，会为**每个**来源分别创建关联，从而捕获完整的人，而不是他的某一个登录名。

已归属给他人的身份仍会留在列表中，以灰显方式展示并标注当前归属者，而不是悄然消失。

> [!NOTE]
>
> 选择器覆盖**最近 7 天**内观察到的身份。沉寂时间超过该范围的身份不会出现。

***

## 编辑与移除

* **编辑** 可修改姓名或邮箱。关联是绑定到人员记录的，因此重命名不会影响已归属的内容。
* 已归属身份旁的垃圾桶图标可移除该条关联。如果该关联是自动推导出来的，下次出现相同的 SSH 证据时它可能会重新出现——若希望它不再出现，请改为移除种子关联。
* 删除人员会使其身份恢复为未归属状态。不会删除任何活动或事件数据。

***

## 合并两个人员

有时同一个人被创建了两次——某台主机上是 `alex.g`，另一台上是 `alex`，而数据中没有任何信号能把这两个字符串关联起来。使用详情面板底部的 **将〈人员〉并入…**，选择要保留的人员。

所有身份都会转移到目标人员，被清空的记录随即删除，因此一个身份永远不会同时归属于两个人。合并会被记录为人工断言：它的优先级高于所有推导出的关联，重新运行被动关联器也无法撤销它。


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