> For the complete documentation index, see [llms.txt](https://docs.decentraland.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.decentraland.org/contributor/contributor-zh/tong-xin/chuan-shu-lei-xing/signed-login.md).

# 签名登录

Signed Login 传输可供那些希望定制将客户端分配到各个岛屿的方式的服务器使用，可在其架构中替代或包裹 Archipelago。

Signed Login 不会直接连接到实时后端，而是会生成一个 [签名请求](https://github.com/decentraland/docs/blob/main/contributor/auth/signed_fetch/README.md) 以获取连接字符串。这个中间步骤允许服务器采用他们想要的任何分配策略。

Signed Login URI 具有如下形式：

```
signed-login:https://comms.example.com/auth&param=value
```

在 `signed-login:` 前缀之后的部分可以是任何有效的 URL。

### 用法

Signed Login 请求是使用 [签名请求](https://github.com/decentraland/docs/blob/main/contributor/auth/signed_fetch/README.md) 机制。

如果成功，响应将具有状态 `200` 以及一个 JSON 正文，其中包含 *至少* 以下字段：

| 字段             | 类型    | 值                                     |
| -------------- | ----- | ------------------------------------- |
| `fixedAdapter` | `字符串` | 分配的传输 URI（例如 `livekit:` 或 `ws-room:`) |

例如：

```
{ 
  fixedAdapter: "ws-room:wss://comms.example.com/rooms/17"
}
```

如果失败，响应可以具有任何适当的状态码以及一个 JSON 正文，其中包含 *至少* 以下字段：

| 字段        | 类型    | 值                |
| --------- | ----- | ---------------- |
| `message` | `字符串` | （可选）对失败的说明或错误代码。 |

JSON 正文中包含额外字段的响应也是有效的，而错误的内容 `message` 则未作规定。实现可以利用这种灵活性，将 `signed-login:` 按其认为合适的方式集成到应用程序中。


---

# 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, and the optional `goal` query parameter:

```
GET https://docs.decentraland.org/contributor/contributor-zh/tong-xin/chuan-shu-lei-xing/signed-login.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.