[[["์ดํดํ๊ธฐ ์ฌ์","easyToUnderstand","thumb-up"],["๋ฌธ์ ๊ฐ ํด๊ฒฐ๋จ","solvedMyProblem","thumb-up"],["๊ธฐํ","otherUp","thumb-up"]],[["์ดํดํ๊ธฐ ์ด๋ ค์","hardToUnderstand","thumb-down"],["์๋ชป๋ ์ ๋ณด ๋๋ ์ํ ์ฝ๋","incorrectInformationOrSampleCode","thumb-down"],["ํ์ํ ์ ๋ณด/์ํ์ด ์์","missingTheInformationSamplesINeed","thumb-down"],["๋ฒ์ญ ๋ฌธ์ ","translationIssue","thumb-down"],["๊ธฐํ","otherDown","thumb-down"]],["์ต์ข ์ ๋ฐ์ดํธ: 2024-12-22(UTC)"],[],[],null,["# Configuring the webhook deploy secret\n\nA webhook deploy endpoint prompts your Looker instance to deploy changes from a Git branch, a commit SHA, or a tag name, and then push the changes to the production version of your project. (See the [Deploying with webhooks](/looker/docs/advanced-deploy-mode#deploying_with_webhooks) section for the Looker deploy webhook formats.) For most projects, Looker handles the Git integrations and [deploys updates to production](/looker/docs/version-control-and-deploying-changes#deploying_to_production), so you don't need to set up a deploy webhook.\n\nHowever, you *do* need to use a deploy webhook to push changes to production if any of the following circumstances applies:\n\n- You push updates to the remote production branch outside of the Looker IDE, which is common in development workflows with staging environments.\n- You want to use a webhook to deploy with [advanced deploy mode](/looker/docs/advanced-deploy-mode), which lets you specify the branch, the commit SHA, or the tag name that is used for your production version of the Looker project.\n- You have configured your Looker project with Git [pull requests](/looker/docs/git-options#integrating_pull_requests_for_your_project), which means that you have to trigger a deploy webhook once you merge a pull request in order to push those changes to your Looker production environment. Most Git hosting services have ways of automating this if you [add the webhook to your Git provider's interface](/looker/docs/git-options#adding_a_webhook_to_your_git_provider).\n\nIf you are a Looker admin, you can configure the deploy webhook to require a secret so that only authorized parties can trigger it. Looker developers who are not admins can view the **Project Configuration** page but cannot change the options there.\n\nAdding a deploy secret\n----------------------\n\nLooker supports web secrets for the following Git providers: GitHub, Bitbucket Server, and GitLab.\n\nTo set a webhook deploy secret to your project:\n\n1. In [Development Mode](/looker/docs/dev-mode-prod-mode), [open your project](/looker/docs/accessing-project-files) and select the settings icon in the IDE navigation bar to open the project settings panel.\n2. Select **Configuration** in the project settings panel.\n3. Scroll to the **Webhook Deploy Secret** section, then click **Set Webhook Secret**. Looker will automatically generate a secret token. You can use this automatically generated secret, or you can type in your own secret token.\n4. Whether you are using the automatically generated secret or creating your own secret, copy the webhook deploy secret and paste it into a text file so you'll have it if you need to [add the secret to the webhook for your repository](#configuring_the_secret_for_your_git_repositorys_webhook). Be sure to copy it at this point. Once you leave or refresh the **Project Configuration** page, you lose access to the webhook deploy secret and will have to [change](#changing_a_deploy_secret) or [remove](#removing_a_deploy_secret) the webhook deploy secret to regain access to your project.\n5. Click **Save Project Configuration**.\n\nThe deploy webhook for your project now requires this secret. For projects that use a Looker staging instance, you need to include the webhook deploy secret in your HTTP header in order to deploy to production. For projects with [Git pull request integration](/looker/docs/git-options#integrating_pull_requests_for_your_project), you need to go to your Git provider's interface to [add the secret to the webhook for your repository](#configuring_the_secret_for_your_git_repositorys_webhook).\n\n### Configuring the secret for your Git repository's webhook\n\nFor projects with [Git pull request integration](/looker/docs/git-options#integrating_pull_requests_for_your_project), if you have added a deploy webhook secret to your LookML project, you need to go to your Git provider's interface to add the secret to the webhook for your repository. As an example, here is how you do that using GitHub:\n\n1. Navigate to your project's repository settings on your Git provider's website.\n\n \u003e **TIP** : If you've set up your project for Git integration, you can use the **View Project on Git** option from your project's Git menu in Looker.\n2. In your repository's settings, click **Webhooks**.\n\n3. Find the webhook for your LookML project, then click its **Edit** button.\n\n4. In the **Secret** field, paste the webhook deploy secret you copied from the **Webhook Deploy Secret** section in Looker.\n\n5. Click **Update webhook**.\n\nThe webhook secret is now required in order to deploy changes to the production version of your project. If you need, you can [change the secret](#changing_a_deploy_secret) or [remove the secret from your project](#removing_a_deploy_secret).\n\nChanging a deploy secret\n------------------------\n\nOnce a webhook deploy secret has been [added](#adding_a_deploy_secret) to your project, if you are a Looker admin, you can change the secret by doing the following:\n\n1. [From your project](/looker/docs/accessing-project-files), select the **Settings** icon from the navigation bar.\n2. Scroll to the **Webhook Deploy Secret** section and click **Reset Secret**. Looker will automatically generate a new secret token. You can use this automatically generated secret, or you can type in your own new secret token.\n3. Whether you are using the automatically generated secret or creating your own secret, copy the webhook deploy secret and paste it into a text file so you'll have it if you need to [add the secret to the webhook for your repository](#configuring_the_secret_for_your_git_repositorys_webhook). Be sure to copy it from your clipboard at this point. Once you leave or refresh the **Project Configuration** page, you will lose access to the webhook deploy secret and will have to go back and change it or [remove](#removing_a_deploy_secret) it entirely.\n4. Click **Save Project Configuration**.\n\nIf your project is configured with [Git pull request integration](/looker/docs/git-options#integrating_pull_requests_for_your_project), you also need to go to your Git provider's interface to [update the webhook secret for your repository](#configuring_the_secret_for_your_git_repositorys_webhook).\n\nRemoving a deploy secret\n------------------------\n\nOnce a webhook deploy secret has been [added](#adding_a_deploy_secret) to your project, if you are a Looker admin, you can remove the secret by doing the following:\n\n1. [From your project](/looker/docs/accessing-project-files), select the **Settings** icon from the navigation bar.\n2. Scroll to the **Webhook Deploy Secret** section and click **Remove Secret** . At this point, you can cancel the operation and keep the deploy secret by clicking **Don't Remove**.\n3. To permanently remove the webhook deploy secret from your project, click **Save Project Configuration**.\n\nYour project no longer requires a secret for the deploy webhook. If your project is configured with [Git pull request integration](/looker/docs/git-options#integrating_pull_requests_for_your_project), you can now go to your Git provider's interface to remove the webhook secret from your repository. Looker itself will no longer check for a secret on the Git provider's end, so it doesn't hurt if your Git repository webhook still has a secret configured. If you do want to remove the secret from your Git repository, see [Configuring the Secret for Your Git Repository's Webhook](#configuring_the_secret_for_your_git_repositorys_webhook) for information on editing the secret on a Git provider's interface."]]
