Reviewing and modifying installed Apps

You can review the permissions and change the repository access for Apps that you have installed. You can also temporarily or permanently prevent a App from accessing resources owned by your account or organization.

In this article

About installed Apps

users can install Apps on their personal account or organizations. When you install a App, you grant the app the organization-level and repository-level permissions that it requested. You also specify which repositories the App can access.

You should periodically review the Apps that you have installed. You can review the permissions that you granted and change the repositories that the App can access. If you no longer use an app, consider suspending or deleting the App to block its access to resources owned by the account where it is installed.

In addition to reviewing Apps that you have installed, you can review Apps that you have authorized to act on your behalf. For more information, see Reviewing and revoking authorization of Apps.

  • For a App installed on an organization:

    1. In the top right corner of , click your profile photo, then click Your organizations.
    2. Next to your organization name, click Settings.
    3. In the side bar, under "Third-party Access," click Apps. A list of the Apps installed on your organization will be displayed.
    4. Next to the App you want to review or modify, click Configure.

  • For a App installed on your personal account:

    1. In the upper-right corner of any page, click your profile photo, then click Settings.
    2. Under "Integrations," click Applications.
    3. Click Installed Apps. A list of the Apps installed on your personal account will be displayed.
    4. Next to the App you want to review or modify, click Configure.

  • For a repository where a App was granted access:

    Note

    In the following steps, you will be taken to the account settings for the organization or personal account where the App is installed. The settings will affect all repositories where the app is installed under that account, not just the repository where you navigated from.

    1. Navigate to the main page of the organization or repository.

    2. Click Settings.

    3. Under "Integrations," click Apps. A list of the Apps that have been granted access to your repository will be displayed.

    4. Next to the App you want to review or modify, click Configure.

Reviewing permissions

  1. Navigate to the App you want to modify. For more information, see Navigating to the App you want to review or modify.
  2. Under "Permissions," review the permissions that the App has. For more information about what different permissions enable a App to do, see Choosing permissions for a App.

Modifying repository access

  1. Navigate to the App you want to modify. For more information, see Navigating to the App you want to review or modify.

  2. Under "Repository access," select All repositories or Only select repositories.

  3. If you selected Only select repositories in the previous step, under the Select repositories dropdown, select the repositories that you want the App to access.

    If the App creates any repositories later, the app will automatically be granted access to those repositories as well.

  4. Click Save.

Blocking access

  1. Navigate to the App you want to modify. For more information, see Navigating to the App you want to review or modify.

  2. To keep the App installed for future use but temporarily block it from accessing resources owned by your account, click Suspend.

    When you suspend a App, your authorization of the app (if the app is installed on your personal account) or the authorization of the app by members of your organization (if the app is installed on an organization) will not be affected. For more information, see Authorizing Apps.

    If the App was previously suspended, you can unsuspend the app by clicking Unsuspend. If the App was suspended by the App owner, then you cannot unsuspend the app.

  3. To uninstall a App and block it from accessing resources owned by your account, click Uninstall.

    When you uninstall a App from an account, the app will lose access to the resources in that account. The app might still be authorized to access organizations on your behalf, if it has installations in those organizations.

    If you want to stop an app from acting on your behalf anywhere on , also de-authorize the app in the "Authorized Apps" tab of your user account. This will fully deactivate any tokens issued to the app on your behalf. For more information, see Authorizing Apps.

Further reading