{"meta":{"title":"Modification d’une inscription d’application GitHub","intro":"Après avoir inscrit une GitHub App, vous pouvez y apporter des modifications.","product":"Applications","breadcrumbs":[{"href":"/fr/enterprise-cloud@latest/apps","title":"Applications"},{"href":"/fr/enterprise-cloud@latest/apps/maintaining-github-apps","title":"Gestion de GitHub Apps"},{"href":"/fr/enterprise-cloud@latest/apps/maintaining-github-apps/modifying-a-github-app-registration","title":"Modifier les paramètres de l'application"}],"documentType":"article"},"body":"# Modification d’une inscription d’application GitHub\n\nAprès avoir inscrit une GitHub App, vous pouvez y apporter des modifications.\n\n<!-- TRANSLATION_FALLBACK prop=markdown type=ParseError line=8 col=26 msg=\"tag 'de' not found\" -->\n## About GitHub App modifications\n\nYou can modify your GitHub App registration to change any of the settings that were selected when the app was initially registered. For more information about the settings you can select while registering a GitHub App, see [Registering a GitHub App](/en/enterprise-cloud@latest/apps/creating-github-apps/creating-github-apps/creating-a-github-app).\n\nFor example, you can change the name and description of your app, the permissions granted to your app, the webhooks your app subscribes to, or the visibility of your app.\n\nYou can also choose to test new optional features for your GitHub App. See [Activating optional features for GitHub Apps](/en/enterprise-cloud@latest/apps/maintaining-github-apps/activating-optional-features-for-github-apps).\n\n<!-- Anchor to maintain links to this heading -->\n\n<a name=\"navigating-to-your-github-app-settings\"></a>\n\n## Navigating to your GitHub App settings\n\nTo modify a GitHub App, first navigate to the app settings page.\n\n1. In the upper-right corner of any page on GitHub, click your profile picture.\n\n2. Navigate to your account settings.\n   * For an app owned by a personal account, click **Settings**.\n   * For an app owned by an organization:\n     1. Click **Your organizations**.\n     2. To the right of the organization, click **Settings**.\n   * For an app owned by an enterprise:\n     1. If you use Enterprise Managed Users, click **Your enterprise** to go directly to the enterprise account settings.\n     2. If you use personal accounts, click **Your enterprises** and then to the right of the enterprise, click **Settings**.\n\n3. Navigate to the GitHub App settings.\n   * For an app owned by a personal account or organization:\n     1. In the left sidebar, click **<svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon octicon-code\" aria-label=\"code\" role=\"img\"><path d=\"m11.28 3.22 4.25 4.25a.75.75 0 0 1 0 1.06l-4.25 4.25a.749.749 0 0 1-1.275-.326.749.749 0 0 1 .215-.734L13.94 8l-3.72-3.72a.749.749 0 0 1 .326-1.275.749.749 0 0 1 .734.215Zm-6.56 0a.751.751 0 0 1 1.042.018.751.751 0 0 1 .018 1.042L2.06 8l3.72 3.72a.749.749 0 0 1-.326 1.275.749.749 0 0 1-.734-.215L.47 8.53a.75.75 0 0 1 0-1.06Z\"></path></svg> Developer settings**, then click **GitHub Apps**.\n   * For an app owned by an enterprise:\n     1. In the left sidebar, under \"Settings\", click **GitHub Apps**.\n\n4. To the right of the GitHub App you want to modify, click **Edit**.\n\n## Changing the basic information of a GitHub App\n\nYou can change the basic information of your GitHub App, like the name of the app, the description of the app, and the homepage URL of the app.\n\n1. Navigate to the settings page for the app you'd like to modify. For more information, see [Navigating to your GitHub App settings](#navigating-to-your-github-app-settings) in this article.\n2. Under \"Basic information,\" modify the GitHub App information that you'd like to change.\n3. Click **Save changes**.\n\n## Requesting user authorization (OAuth) during installation\n\nYou can prompt users to authorize your GitHub App when they install it and generate a user access token. When you request user authorization (OAuth) during installation, you must also provide a callback URL where the user will be redirected after they authorize the installation. See [Generating a user access token for a GitHub App](/en/enterprise-cloud@latest/apps/creating-github-apps/authenticating-with-a-github-app/generating-a-user-access-token-for-a-github-app).\n\n1. Navigate to the settings page for the app you'd like to modify. For more information, see [Navigating to your GitHub App settings](#navigating-to-your-github-app-settings) in this article.\n2. Under \"Identifying and authorizing users,\" select or deselect **Request user authorization (OAuth) during installation**.\n3. Under \"Callback URL,\" enter the full URL to redirect to after a user authorizes the installation.\n\n## Enabling or disabling the device flow\n\nYou can use the device flow to authorize users for a headless app like a CLI tool or Git credential manager. For more information about using the device flow with GitHub Apps, see [Generating a user access token for a GitHub App](/en/enterprise-cloud@latest/apps/creating-github-apps/authenticating-with-a-github-app/generating-a-user-access-token-for-a-github-app#using-the-device-flow-to-generate-a-user-access-token).\n\n1. Navigate to the settings page for the app you'd like to modify. For more information, see [Navigating to your GitHub App settings](#navigating-to-your-github-app-settings) in this article.\n2. Under \"Identifying and authorizing users,\" select or deselect **Enable Device Flow**.\n\n## Adding or updating a setup URL\n\nYou can redirect people to a specific URL after they install your app. See [Registering a GitHub App](/en/enterprise-cloud@latest/apps/creating-github-apps/creating-github-apps/creating-a-github-app).\n\nIf you select **Request user authorization (OAuth) during installation**, you will not be able to enter a setup URL. Users will instead be redirected to the Callback URL as part of the authorization flow, where you can describe additional setup. See [About the user authorization callback URL](/en/enterprise-cloud@latest/apps/creating-github-apps/creating-github-apps/about-the-user-authorization-callback-url).\n\n1. Navigate to the settings page for the app you'd like to modify. For more information, see [Navigating to your GitHub App settings](#navigating-to-your-github-app-settings) in this article.\n2. Under \"Post installation,\" in the \"Setup URL\" field, enter the URL where you'd like to redirect users after they install your app.\n3. Optionally, if you want to redirect users to the setup URL after they update an installation, select **Redirect on update**. An update includes adding or removing a repository for an installation. If \"Setup URL\" is blank, this will be ignored.\n\n## Changing the permissions of a GitHub App\n\nYou can change the access permissions that are granted to your GitHub App using the following steps.\n\nWhen you add new **repository**, **organization**, or **enterprise** permissions for an app, each account where the app is installed will need to approve the new permissions. When you add **account** permissions for an app, each user that has authorized the app will need to approve the permission changes. In both cases, GitHub will send an email to each organization owner or user, notifying them of the request to update the app's permissions. Updated permissions won't take effect on an installation or user authorization until the new permissions are approved. You can use the [installation webhook](/en/enterprise-cloud@latest/webhooks-and-events/webhooks/webhook-events-and-payloads?actionType=new_permissions_accepted#installation) to find out when people accept new permissions for your app.\n\nIf you remove permissions or webhooks from your GitHub App, the changes will take effect immediately. If you remove permissions that were previously granted to your app, the app will no longer be able to access those resources.\n\nIf you change the permissions of an app owned by an enterprise, the changes will take effect immediately for all installations of the app within the enterprise if you are an enterprise owner. If you are an app manager, the changes will only be automatically accepted in organizations where you are an organization owner.\n\nUpdates cannot be automatically accepted if you add repository permissions to an app for the first time. In that case, each organization owner will need to approve the update so that they can choose which repositories the app has access to.\n\nChanging the permissions of an app may also change the webhooks that your app can subscribe to and the actions that your app can take with the API. See [Choosing permissions for a GitHub App](/en/enterprise-cloud@latest/apps/creating-github-apps/creating-github-apps/choosing-permissions-for-a-github-app).\n\n1. Navigate to the settings page for the app you'd like to modify. For more information, see [Navigating to your GitHub App settings](#navigating-to-your-github-app-settings) in this article.\n2. In the GitHub Apps settings sidebar, click **Permissions & events**.\n3. Under the sections \"Repository permissions,\" \"Organization permissions,\" and \"Account permissions,\" modify the permissions you'd like to change. For each type of permission, select either \"Read-only,\" \"Read and write,\" or \"No access\" from the dropdown. See [Choosing permissions for a GitHub App](/en/enterprise-cloud@latest/apps/creating-github-apps/creating-github-apps/choosing-permissions-for-a-github-app).\n4. Optionally, under \"Add a note to users,\" add a note telling your users why you are changing the permissions that your GitHub App requests.\n5. Click **Save changes**.\n\n## Activating or deactivating the GitHub App webhook\n\nYou can configure your GitHub App to receive webhooks for specific events on GitHub and automatically take action on them. See [Using webhooks with GitHub Apps](/en/enterprise-cloud@latest/apps/creating-github-apps/creating-github-apps/using-webhooks-with-github-apps).\n\n1. Navigate to the settings page for the app you'd like to modify. For more information, see [Navigating to your GitHub App settings](#navigating-to-your-github-app-settings) in this article.\n2. Under \"Webhook,\" to enable or disable the webhook, select or deselect **Active**.\n3. If you selected **Active** in the previous step, under \"Webhook URL,\" enter the URL that GitHub should send webhook events to.\n4. Optionally, if you selected **Active** in the previous step, under \"Webhook secret,\" enter a secret token to secure your webhooks. GitHub highly recommends that you set a webhook secret.\n\n## Changing the webhook event subscriptions of a GitHub App\n\nYou can change the webhook events that a GitHub App subscribes to using the following steps.\n\nThe specific webhook events that you can select for your GitHub App registration are determined by the type of permissions you selected for your app. You will first need to select the permissions you would like your app to have, and then you can subscribe your app to webhook events that are related to that set of permissions. See [Using webhooks with GitHub Apps](/en/enterprise-cloud@latest/apps/creating-github-apps/creating-github-apps/using-webhooks-with-github-apps).\n\n1. Navigate to the settings page for the app you'd like to modify. For more information, see [Navigating to your GitHub App settings](#navigating-to-your-github-app-settings) in this article.\n2. Activate the GitHub App webhook. See [Activating or deactivating the GitHub App webhook](/en/enterprise-cloud@latest/apps/maintaining-github-apps/modifying-a-github-app#activating-or-deactivating-the-github-app-webhook) in this article.\n3. In the GitHub Apps settings sidebar, click **Permissions & events**.\n4. Under the sections \"Repository permissions,\" \"Organization permissions,\" and \"Account permissions,\" select the permissions that are required for the events your app will subscribe to. See [Changing the permissions of a GitHub App](#changing-the-permissions-of-a-github-app).\n5. Under \"Subscribe to Events,\" select the webhook events you would like your GitHub App to receive.\n6. Click **Save changes**.\n\n## Changing the visibility of a GitHub App\n\nYou can change the visibility settings of your GitHub App to control who can install it. Public apps cannot be made private if they're installed on other accounts. See [Making a GitHub App public or private](/en/enterprise-cloud@latest/apps/creating-github-apps/creating-github-apps/making-a-github-app-public-or-private).\n\nYou can't change the visibility of an GitHub App owned by an enterprise. GitHub Apps owned by an enterprise can only be installed on organizations within the enterprise or the enterprise itself.\n\n1. Navigate to the settings page for the app you'd like to modify. For more information, see [Navigating to your GitHub App settings](#navigating-to-your-github-app-settings) in this article.\n2. In the left sidebar, click **Advanced**.\n3. Under \"Danger zone,\" depending on the current visibility of your GitHub App, click either **Make public** or **Make private**."}