---
metadata:
  - name: generator
    content: Diplodoc Platform v5.63.0
alternate:
  - en/security/embedded-objects
  - ru/security/embedded-objects
  - href: ru/security/embedded-objects.md
    type: text/markdown
    title: Markdown version
csp:
  - script-src:
      - https://mc.yandex.ru
    img-src:
      - https://mc.yandex.ru
    connect-src:
      - https://mc.yandex.ru
      - wss://mc.yandex.ru
    child-src:
      - 'blob:'
      - https://mc.yandex.ru
    frame-src:
      - 'blob:'
      - https://mc.yandex.ru
    frame-ancestors:
      - 'blob:'
      - https://mc.yandex.ru
canonical: ru/security/embedded-objects.html
vcsPath: ru/security/embedded-objects.md
---
# Встраивание на корпоративном домене

Вы можете встроить  дашборды и чарты на сайт или в приложение с помощью элемента `iframe`.



{% note info %}

* Встроить объекты можно только на страницы, размещенные на домене, который задан при [развертывании](../concepts/create-instance.md#functionality) в аргументе `--auth-cookie-domain <domain>` или в файле `values.yaml` в [параметрах](../concepts/create-instance.md#functionality-values) `.features.auth_cookie.enabled=true` и `.features.auth_cookie.domain=<domain>`.
* У DataLens и ресурса, куда он будет встроен, должен быть общий домен.
* Домен `<domain>` должен быть вида: `http://domain` или `https://domain`.

Например, если DataLens развернут по адресу `https://datalens.company-name.ru`, а сервис для встраивания объектов находится по адресу `https://another-service.company-name.ru`, при развертывании укажите имя домена одним из способов:

* в аргументе `--auth-cookie-domain https://company-name.ru`;
* в файле `values.yaml`, установив параметры `.features.auth_cookie.enabled=true` и `.features.auth_cookie.domain=https://company-name.ru`.

{% endnote %}


Функциональность и внешний вид встраиваемых объектов можно определить с помощью передаваемых параметров:

* `_autoupdate` — задает время [автообновления](../dashboard/settings.md#auto-update) для дашбордов и чартов в секундах. По умолчанию они не обновляются автоматически. Работает только на активной вкладке браузера. Если для неактивной вкладки время автообновления уже наступило, оно выполнится, когда вкладка снова станет активной. Минимальная величина:

  * для дашбордов — 30 секунд;
  * для чартов — 15 секунд.

* `_embedded` — скрывает панель навигации. Значение для включения параметра — `1`.
* `_no_controls` — у чартов скрывает меню <!-- diplodoc:svg ![image](../_assets/console-icons/ellipsis.svg) --><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="none" viewBox="0 0 16 16"><path fill="currentColor" fill-rule="evenodd" d="M3 9.5a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3M9.5 8a1.5 1.5 0 1 1-3 0 1.5 1.5 0 0 1 3 0m5 0a1.5 1.5 0 1 1-3 0 1.5 1.5 0 0 1 3 0" clip-rule="evenodd"/></svg>. Значение для включения параметра — `1`.
* `_theme` — задает оформление объекта. Возможные значения:

  * `light` — для отображения в светлой теме;
  * `dark` — для отображения в темной теме.

* `_bg_color` — задает фон чарта и дашборда в шестнадцатеричном формате, только если значение параметра `_embedded` равно `1`. Например, `_bg_color=D7F7F7&_embedded=1`
* `_widgets_bg_color` — задает фон виджетов на дашборде в шестнадцатеричном формате, только если значение параметра `_embedded` равно `1`. Например, `_widgets_bg_color=B7F7F7&_embedded=1`.
* `_no_scroll` — выключает вертикальную прокрутку у дашборда. Значение для включения параметра — `1`.
* `_lang` — у чартов определяет значение языка для меню, которое открывается при нажатии на значок <!-- diplodoc:svg ![image](../_assets/console-icons/ellipsis.svg) --><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="none" viewBox="0 0 16 16"><path fill="currentColor" fill-rule="evenodd" d="M3 9.5a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3M9.5 8a1.5 1.5 0 1 1-3 0 1.5 1.5 0 0 1 3 0m5 0a1.5 1.5 0 1 1-3 0 1.5 1.5 0 0 1 3 0" clip-rule="evenodd"/></svg>. Возможные значения: `ru` или `en`. 
* `_opened_info` — при открытии дашборда отображает его [описание](../dashboard/settings.md#message-settings), если оно заполнено. Значение для включения параметра — `1`.

Параметры передаются в формате `<имя_параметра>=<значение>`. Например, чтобы задать время автообновления 50 секунд, укажите: `_autoupdate=50`.

Параметр добавляется к адресу объекта после знака вопроса `?`. Для передачи нескольких параметров перечислите их через знак амперсанда `&`, например так:




```html
<iframe frameborder="0" src="<домен_DataLens>/preview/<id_объекта>?_embedded=1&_no_controls=1&_lang=en&_autoupdate=50" ></iframe>
```

Где:
* `<домен_DataLens>` — домен вашего корпоративного DataLens, например: `https://enterprise.datalens.net`.
* `<id_объекта>` — идентификатор встраиваемого объекта, например: `bgquq********`. Чтобы скопировать идентификатор чарта или дашборда, откройте его и нажмите <!-- diplodoc:svg ![image](../_assets/console-icons/ellipsis.svg) --><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="none" viewBox="0 0 16 16"><path fill="currentColor" fill-rule="evenodd" d="M3 9.5a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3M9.5 8a1.5 1.5 0 1 1-3 0 1.5 1.5 0 0 1 3 0m5 0a1.5 1.5 0 1 1-3 0 1.5 1.5 0 0 1 3 0" clip-rule="evenodd"/></svg> → **Копировать ID**.

