공개 삽입 외에도 Look, Explore, 대시보드를 비공개로 삽입할 수 있습니다. 비공개 삽입을 사용하면 사용자가 Looker 로그인, Google OAuth, OpenID Connect를 사용하여 인증하도록 요구할 수 있습니다. 사용자가 인증되지 않은 경우 오류 메시지를 표시하거나 로그인 화면을 표시하는 옵션이 있습니다.
로그인한 상태에서 비공개로 삽입된 콘텐츠에 액세스하는 사용자에게는 로그인 상태를 유지할 수 있는 시간과 여러 브라우저에서 로그인할 수 있는지와 세션에서 일정 기간 활동이 없으면 로그아웃되는지 여부를 결정하는 Admin(관리) 패널의 설정이 적용됩니다.
고급 또는 맞춤설정 가능한 임베디드 솔루션이 필요하다면 서명된 삽입 문서 페이지를 확인하십시오.
삽입 URL 생성
대시보드, Look 또는 Explore 시각화에 대한 비공개 삽입 URL을 생성하고 복사하려면 대시보드 점 3개 메뉴에서 삽입 URL 가져오기를 선택하거나 Look 또는 Explore의 Explore 작업 톱니바퀴 메뉴에서 검색할 수 있습니다.
비공개 삽입 화면에는 다음 요소가 포함되어 있습니다.
콘텐츠 URL 필드에는 전체 비공개 삽입 URL이 표시됩니다.
대시보드 URL에 테마 적용 필드를 사용하면 대시보드 또는 Explore 삽입 URL을 생성 중이고 인스턴스에 커스텀 테마가 활성화된 경우 삽입 URL에 추가할 테마를 선택할 수 있습니다. 삽입된 대시보드 또는 Explore가 표시되면 테마가 적용됩니다.
URL에 현재 매개변수 포함 스위치를 사용하면 필터 값과 같은 현재 매개변수를 삽입 URL에 적용할지 여부를 선택할 수 있습니다. 사용 설정하면 삽입된 콘텐츠를 볼 때 해당 매개변수가 적용됩니다.
링크 복사 버튼을 선택하여 전체 삽입 URL을 클립보드에 복사합니다.
삽입 URL을 생성하고 복사한 후에는 새 브라우저 창이나 탭에 URL을 붙여넣어 삽입된 콘텐츠를 미리 볼 수 있습니다. 이 URL을 사용하여 iframe에 콘텐츠를 삽입할 수도 있습니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["이해하기 어려움","hardToUnderstand","thumb-down"],["잘못된 정보 또는 샘플 코드","incorrectInformationOrSampleCode","thumb-down"],["필요한 정보/샘플이 없음","missingTheInformationSamplesINeed","thumb-down"],["번역 문제","translationIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-07-31(UTC)"],[],[],null,["# Private embedding\n\nIn addition to [public embedding](/looker/docs/publishing-looks-with-public-urls#embed), you can also embed Looks, Explores, and dashboards privately. With private embedding, you can require a user to authenticate using a Looker login, [Google OAuth](/looker/docs/admin-panel-authentication-google), or [OpenID Connect](/looker/docs/admin-panel-authentication-openid-connect). If a user is not authenticated, you have the option to show an error message or [display a login screen](#enable_login_screen_for_private_embeds).\n\nUsers who are logged in and accessing privately embedded content are subject to the settings in the [**Sessions**](/looker/docs/admin-panel-authentication-sessions) **Admin** panel, which determine how long they can stay logged in, if they can log in from multiple browsers, and if they will be logged out after a period of inactivity.\n\nIf you require a more advanced or customizable embedded solution, check out our [Signed embedding](/looker/docs/single-sign-on-embedding) documentation page.\n| **Note:** Embedded content always reflects the production version of the content. Any changes made while in [Development Mode](/looker/docs/dev-mode-prod-mode) that affect content and that have not been deployed to production won't appear in an embed.\n\nGenerating an embed URL\n-----------------------\n\nTo generate and copy a [private embed URL](/looker/docs/private-embedding) for a dashboard, a Look, or an Explore visualization, select **Get embed URL** from a dashboard [three-dot menu](/looker/docs/viewing-dashboards#three-dot_dashboard_menu), or from the Explore action gear menu on an [Explore](/looker/docs/viewing-and-interacting-with-explores#the_explore_actions_gear_menu) or a [Look](/looker/docs/viewing-looks#the_look_explore_actions_gear_menu).\n\nThe **Private Embed** screen includes the following elements:\n\n1. The **Content URL** field shows the full private embed URL.\n2. The **Apply theme to dashboard URL** field lets you select a theme to be added to the embed URL if you are generating a dashboard or an Explore embed URL and your instance has [custom themes](/looker/docs/themes-for-embedded-dashboards-and-explores) enabled. The theme will be applied when the embedded dashboard or Explore is viewed.\n3. The **Include current params in URL** switch lets you choose whether to apply current parameters, such as filter values, to the embed URL. If enabled, those parameters will be applied when the embedded content is viewed.\n4. Select the **Copy Link** button to copy the full embed URL to your clipboard.\n\nOnce you've generated and copied the embed URL, you can paste the URL into a new browser window or tab to preview the embedded content. You can also use this URL to [embed the content in an iframe](#viewing_the_embedded_content_in_an_iframe).\n\nPreviewing the embedded content\n-------------------------------\n\nPaste your embed URL in your browser to preview your embed content's behavior and appearance.\n\nViewing the embedded content in an iframe\n-----------------------------------------\n\nPlace the embed URL into an iframe. For example: \n\n \u003ciframe\n src=\"https://instance_name.cloud.looker.com/embed/dashboards/1\"\n width=\"1000\"\n height=\"2000\"\n frameborder=\"0\"\u003e\n \u003c/iframe\u003e\n\nAnd then embed the iframe as desired.\n\n### Changing the embedded appearance of a dashboard\n\nViewing a dashboard with `/embed` in the URL shows you how the dashboard will appear when it's embedded.\n\nBy default, an embedded dashboard is displayed using the [default theme](/looker/docs/themes-for-embedded-dashboards-and-explores#default_theme) for your Looker instance. You can change the appearance of your embedded dashboard in several ways, depending on the type of dashboard you are using:\n\n- For any type of dashboard, you can specify a different theme name [in the embed URL](/looker/docs/themes-for-embedded-dashboards-and-explores#specify_theme) to change the theme used to display the dashboard.\n- For any type of dashboard, you can use the [`_theme` URL argument](/looker/docs/themes-for-embedded-dashboards-and-explores#using_the__theme_url_argument_to_apply_individual_dashboard_theme_elements) to change individual dashboard theme elements.\n- For a [LookML dashboard](/looker/docs/building-lookml-dashboards), you can also modify the embedded appearance of a dashboard through the [`embed_style`](/looker/docs/reference/param-lookml-dashboard#embed_style) parameter.\n\nUsing the `theme` URL argument, the **Edit Embed Settings** option, or the `embed_style` parameter makes changes only to the dashboard the argument, option, or parameter is applied to. If you want to customize the appearance of multiple embedded dashboards, use a [theme](/looker/docs/themes-for-embedded-dashboards-and-explores) instead.\n\nSome display settings override others. For more information, see the [Creating and applying themes for embedded dashboards and Explores](/looker/docs/themes-for-embedded-dashboards-and-explores#themes_precedence) documentation page.\n\nEnable login screen for private embeds\n--------------------------------------\n\nYou can add the parameter `allow_login_screen=true` to your embed URL if you want to display a login screen to users who haven't logged in already. For example: \n\n \u003ciframe src=\"https://instance_name.cloud.looker.com/embed/looks/4?allow_login_screen=true\"\u003e\u003c/iframe\u003e\n ^^^^^^^^^^^^^^^^^^^^^^^\n\nIf you do not add this parameter, a 401 error will be displayed to users who are not already logged in.\n| **Note:** Using [same-origin protections for your Looker login pages](/looker/docs/admin-panel-platform-embed#same-origin_protections_for_looker_login_pages) might prevent you from enabling a login screen for private embeds."]]