---
title: Передать session cookie
description: Добавьте готовое значение cookie через Identity.
sources:
  - eazy_sdk.auth.CookieScheme
api_fingerprint: "sha256:8c30742714ec92e41f68d080feddc65e5570997389f3fd1dfa82947a71c3bed4"
---

`CookieScheme` подходит, когда значение session cookie уже известно. Имя cookie задаётся в
схеме, а значение хранится в `Identity`.

:::::{grid} 1 1 2 2
:class-container: http-exchange
:gutter: 2

::::{grid-item}
:class: http-panel http-panel--request

**→ Запрос** · ``GET /auth/cookie``

```json
{"headers": {"Cookie": "mail_session=session-1"}}
```
::::

::::{grid-item}
:class: http-panel http-panel--response

**← Ответ** · ``200 OK``

```json
{"credential": "session-1"}
```
::::
:::::

```{literalinclude} ../../../../../../examples/docs/auth_cookie.py
:language: python
:start-after: "# region docs: auth-cookie"
:end-before: "# endregion docs: auth-cookie"
```

`CookieScheme("mail_session")` управляет только объявленным значением. Обычные cookies клиента
могут существовать рядом, но не удовлетворяют `security=MAIL_SESSION` без источника в `Identity`.

Если cookie выдаёт браузер после интерактивного входа, используйте мост браузерной сессии из
{doc}`главы о сборке SDK </tutorial/assembly>`, а не копируйте заголовок вручную.

:::{dropdown} Файл целиком
```{literalinclude} ../../../../../../examples/docs/auth_cookie.py
:language: python
```
:::

<!-- example-output: examples.docs.auth_cookie -->
```text
session: session-1
```

`CookieScheme` подходит, когда значение куки приносит вызывающий: ключ API, готовый
идентификатор сессии из другого места. Сессию, которую сайт ставит и меняет сам, ведёт
объявление `Cookies(...)`; на одном сервисе они не сочетаются.

## Дальше

- {doc}`Вести сессию сайта на куках </guide/auth/cookies-session>`
- {doc}`Войти и получить сессию </guide/auth/login>`
- {doc}`Повторно использовать сессию </guide/auth/session>`