diff --git a/content/apps/maintaining-github-apps/about-github-app-managers.md b/content/apps/maintaining-github-apps/about-github-app-managers.md new file mode 100644 index 0000000000..e6649f12b1 --- /dev/null +++ b/content/apps/maintaining-github-apps/about-github-app-managers.md @@ -0,0 +1,16 @@ +--- +title: About GitHub App managers +intro: 'Organization owners can grant or revoke access for a user to manage some or all of the {% data variables.product.prodname_github_apps %} owned by the organization.' +versions: + fpt: '*' + ghes: '*' + ghae: '*' + ghec: '*' +topics: + - Organizations + - Teams + - GitHub Apps +shortTitle: GitHub App managers +--- + +{% data reusables.apps.github-app-managers %} For more information about how to designate someone as a {% data variables.product.prodname_github_app %} manager, see "[AUTOTITLE](/organizations/managing-programmatic-access-to-your-organization/adding-and-removing-github-app-managers-in-your-organization)." \ No newline at end of file diff --git a/content/apps/maintaining-github-apps/index.md b/content/apps/maintaining-github-apps/index.md index 4124c0e3ab..7daf674279 100644 --- a/content/apps/maintaining-github-apps/index.md +++ b/content/apps/maintaining-github-apps/index.md @@ -13,6 +13,7 @@ versions: topics: - GitHub Apps children: + - /about-github-app-managers - /modifying-a-github-app - /editing-a-github-apps-permissions - /managing-allowed-ip-addresses-for-a-github-app diff --git a/content/organizations/managing-peoples-access-to-your-organization-with-roles/roles-in-an-organization.md b/content/organizations/managing-peoples-access-to-your-organization-with-roles/roles-in-an-organization.md index f0a5038da0..cfb81ccb79 100644 --- a/content/organizations/managing-peoples-access-to-your-organization-with-roles/roles-in-an-organization.md +++ b/content/organizations/managing-peoples-access-to-your-organization-with-roles/roles-in-an-organization.md @@ -60,10 +60,7 @@ If your organization has a security team, you can use the security manager role ### {% data variables.product.prodname_github_app %} managers By default, only organization owners can manage the settings of {% data variables.product.prodname_github_apps %} owned by an organization. To allow additional users to manage {% data variables.product.prodname_github_apps %} owned by an organization, an owner can grant them {% data variables.product.prodname_github_app %} manager permissions. -When you designate a user as a {% data variables.product.prodname_github_app %} manager in your organization, you can grant them access to manage the settings of some or all {% data variables.product.prodname_github_apps %} owned by the organization. For more information, see: - -- "[AUTOTITLE](/organizations/managing-programmatic-access-to-your-organization/adding-github-app-managers-in-your-organization)" -- "[AUTOTITLE](/organizations/managing-programmatic-access-to-your-organization/removing-github-app-managers-from-your-organization)" +When you designate a user as a {% data variables.product.prodname_github_app %} manager in your organization, you can grant them access to manage the settings of some or all {% data variables.product.prodname_github_apps %} owned by the organization. The {% data variables.product.prodname_github_app %} manager role does not grant users access to install and uninstall {% data variables.product.prodname_github_apps %} on an organization. For more information, see "[AUTOTITLE](/organizations/managing-programmatic-access-to-your-organization/adding-and-removing-github-app-managers-in-your-organization)." ### Outside collaborators To keep your organization's data secure while allowing access to repositories, you can add *outside collaborators*. {% data reusables.organizations.outside_collaborators_description %} diff --git a/content/organizations/managing-programmatic-access-to-your-organization/adding-and-removing-github-app-managers-in-your-organization.md b/content/organizations/managing-programmatic-access-to-your-organization/adding-and-removing-github-app-managers-in-your-organization.md new file mode 100644 index 0000000000..997db8f22f --- /dev/null +++ b/content/organizations/managing-programmatic-access-to-your-organization/adding-and-removing-github-app-managers-in-your-organization.md @@ -0,0 +1,65 @@ +--- +title: Adding and removing GitHub App managers in your organization +intro: 'Organization owners can grant or revoke access for a user to manage some or all of the {% data variables.product.prodname_github_apps %} owned by the organization.' +redirect_from: + - /articles/adding-github-app-managers-in-your-organization + - /github/setting-up-and-managing-organizations-and-teams/adding-github-app-managers-in-your-organization + - /organizations/managing-access-to-your-organizations-apps/adding-github-app-managers-in-your-organization + - /articles/removing-github-app-managers-from-your-organization + - /github/setting-up-and-managing-organizations-and-teams/removing-github-app-managers-from-your-organization + - /organizations/managing-access-to-your-organizations-apps/removing-github-app-managers-from-your-organization + - /organizations/managing-programmatic-access-to-your-organization/adding-github-app-managers-in-your-organization + - /organizations/managing-programmatic-access-to-your-organization/removing-github-app-managers-from-your-organization +versions: + fpt: '*' + ghes: '*' + ghae: '*' + ghec: '*' +topics: + - Organizations + - Teams + - GitHub Apps +shortTitle: GitHub App managers +--- + +## About {% data variables.product.prodname_github_app %} managers + +{% data reusables.apps.github-app-managers %} + +## Giving someone the ability to manage all {% data variables.product.prodname_github_apps %} owned by the organization + +{% data reusables.profile.access_org %} +{% data reusables.profile.org_settings %} +{% data reusables.organizations.github-apps-settings-sidebar %} +1. At the bottom of the "Management" section, in the search field, type the username of the person you want to designate as a {% data variables.product.prodname_github_app %} manager in the organization, then click **Grant**. + +## Giving someone the ability to manage an individual {% data variables.product.prodname_github_app %} + +{% data reusables.profile.access_org %} +{% data reusables.profile.org_settings %} +{% data reusables.organizations.github-apps-settings-sidebar %} +1. Under "{% data variables.product.prodname_github_apps %}", click on the avatar of the app you'd like to add a {% data variables.product.prodname_github_app %} manager for. +{% data reusables.organizations.app-managers-settings-sidebar %} +1. At the bottom of the "App managers" section, in the search field, type the username of the person you want to designate as a GitHub App manager for the app, then click **Grant**. + +## Removing a {% data variables.product.prodname_github_app %} manager's permissions for the entire organization + +{% data reusables.profile.access_org %} +{% data reusables.profile.org_settings %} +{% data reusables.organizations.github-apps-settings-sidebar %} +1. Under "Management", next to the person you want to remove {% data variables.product.prodname_github_app %} manager permissions from, click **Revoke**. + +## Removing a {% data variables.product.prodname_github_app %} manager's permissions for an individual {% data variables.product.prodname_github_app %} + +{% data reusables.profile.access_org %} +{% data reusables.profile.org_settings %} +{% data reusables.organizations.github-apps-settings-sidebar %} +1. Under "{% data variables.product.prodname_github_apps %}", click on the avatar of the app you'd like to remove a {% data variables.product.prodname_github_app %} manager from. +{% data reusables.organizations.app-managers-settings-sidebar %} +1. Under "App managers", next to the person you want to remove {% data variables.product.prodname_github_app %} manager permissions from, click **Revoke**. + +{% ifversion fpt or ghec %} +## Further reading + +- "[AUTOTITLE](/get-started/exploring-integrations/about-github-marketplace)" +{% endif %} diff --git a/content/organizations/managing-programmatic-access-to-your-organization/adding-github-app-managers-in-your-organization.md b/content/organizations/managing-programmatic-access-to-your-organization/adding-github-app-managers-in-your-organization.md deleted file mode 100644 index 6fb629f805..0000000000 --- a/content/organizations/managing-programmatic-access-to-your-organization/adding-github-app-managers-in-your-organization.md +++ /dev/null @@ -1,41 +0,0 @@ ---- -title: Adding GitHub App managers in your organization -intro: 'Organization owners can grant users the ability to manage some or all {% data variables.product.prodname_github_apps %} owned by the organization.' -redirect_from: - - /articles/adding-github-app-managers-in-your-organization - - /github/setting-up-and-managing-organizations-and-teams/adding-github-app-managers-in-your-organization - - /organizations/managing-access-to-your-organizations-apps/adding-github-app-managers-in-your-organization -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' -topics: - - Organizations - - Teams -shortTitle: Add GitHub App managers ---- - -For more information about {% data variables.product.prodname_github_app %} manager permissions, see "[AUTOTITLE](/organizations/managing-peoples-access-to-your-organization-with-roles/roles-in-an-organization#github-app-managers)." - -## Giving someone the ability to manage all {% data variables.product.prodname_github_apps %} owned by the organization - -{% data reusables.profile.access_org %} -{% data reusables.profile.org_settings %} -{% data reusables.organizations.github-apps-settings-sidebar %} -1. At the bottom of the "Management" section, in the search field, type the username of the person you want to designate as a {% data variables.product.prodname_github_app %} manager in the organization, then click **Grant**. - -## Giving someone the ability to manage an individual {% data variables.product.prodname_github_app %} - -{% data reusables.profile.access_org %} -{% data reusables.profile.org_settings %} -{% data reusables.organizations.github-apps-settings-sidebar %} -1. Under "{% data variables.product.prodname_github_apps %}", click on the avatar of the app you'd like to add a {% data variables.product.prodname_github_app %} manager for. -{% data reusables.organizations.app-managers-settings-sidebar %} -1. At the bottom of the "App managers" section, in the search field, type the username of the person you want to designate as a GitHub App manager for the app, then click **Grant**. - -{% ifversion fpt or ghec %} -## Further reading - -- "[AUTOTITLE](/get-started/exploring-integrations/about-github-marketplace)" -{% endif %} diff --git a/content/organizations/managing-programmatic-access-to-your-organization/index.md b/content/organizations/managing-programmatic-access-to-your-organization/index.md index c456014f31..6476e9ccd6 100644 --- a/content/organizations/managing-programmatic-access-to-your-organization/index.md +++ b/content/organizations/managing-programmatic-access-to-your-organization/index.md @@ -15,8 +15,7 @@ topics: - Organizations - Teams children: - - /adding-github-app-managers-in-your-organization - - /removing-github-app-managers-from-your-organization + - /adding-and-removing-github-app-managers-in-your-organization - /reviewing-github-apps-installed-in-your-organization - /setting-a-personal-access-token-policy-for-your-organization - /managing-requests-for-personal-access-tokens-in-your-organization @@ -24,4 +23,3 @@ children: - /limiting-oauth-app-and-github-app-access-requests shortTitle: Manage programmatic access --- - diff --git a/content/organizations/managing-programmatic-access-to-your-organization/removing-github-app-managers-from-your-organization.md b/content/organizations/managing-programmatic-access-to-your-organization/removing-github-app-managers-from-your-organization.md deleted file mode 100644 index da4df468f2..0000000000 --- a/content/organizations/managing-programmatic-access-to-your-organization/removing-github-app-managers-from-your-organization.md +++ /dev/null @@ -1,41 +0,0 @@ ---- -title: Removing GitHub App managers from your organization -intro: 'Organization owners can revoke {% data variables.product.prodname_github_app %} manager permissions that were granted to a member of the organization.' -redirect_from: - - /articles/removing-github-app-managers-from-your-organization - - /github/setting-up-and-managing-organizations-and-teams/removing-github-app-managers-from-your-organization - - /organizations/managing-access-to-your-organizations-apps/removing-github-app-managers-from-your-organization -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' -topics: - - Organizations - - Teams -shortTitle: Remove GitHub App managers ---- - -For more information about {% data variables.product.prodname_github_app %} manager permissions, see "[AUTOTITLE](/organizations/managing-peoples-access-to-your-organization-with-roles/roles-in-an-organization#github-app-managers)." - -## Removing a {% data variables.product.prodname_github_app %} manager's permissions for the entire organization - -{% data reusables.profile.access_org %} -{% data reusables.profile.org_settings %} -{% data reusables.organizations.github-apps-settings-sidebar %} -1. Under "Management", next to the person you want to remove {% data variables.product.prodname_github_app %} manager permissions from, click **Revoke**. - -## Removing a {% data variables.product.prodname_github_app %} manager's permissions for an individual {% data variables.product.prodname_github_app %} - -{% data reusables.profile.access_org %} -{% data reusables.profile.org_settings %} -{% data reusables.organizations.github-apps-settings-sidebar %} -1. Under "{% data variables.product.prodname_github_apps %}", click on the avatar of the app you'd like to remove a {% data variables.product.prodname_github_app %} manager from. -{% data reusables.organizations.app-managers-settings-sidebar %} -1. Under "App managers", next to the person you want to remove {% data variables.product.prodname_github_app %} manager permissions from, click **Revoke**. - -{% ifversion fpt or ghec %} -## Further reading - -- "[AUTOTITLE](/get-started/exploring-integrations/about-github-marketplace)" -{% endif %} diff --git a/data/reusables/apps/github-app-managers.md b/data/reusables/apps/github-app-managers.md new file mode 100644 index 0000000000..2b0655024f --- /dev/null +++ b/data/reusables/apps/github-app-managers.md @@ -0,0 +1,3 @@ +Organization owners can designate other users in their organization as {% data variables.product.prodname_github_app %} managers. {% data variables.product.prodname_github_app %} managers can manage the settings of some or all of the {% data variables.product.prodname_github_apps %} that are owned by the organization. The {% data variables.product.prodname_github_app %} manager role does not grant users access to install and uninstall {% data variables.product.prodname_github_apps %} on an organization. For more information about the specific app settings that a {% data variables.product.prodname_github_app %} manager can control, see "[AUTOTITLE](/apps/maintaining-github-apps/modifying-a-github-app)." + +For more information about {% data variables.product.prodname_github_app %} manager permissions, see "[AUTOTITLE](/organizations/managing-peoples-access-to-your-organization-with-roles/roles-in-an-organization#github-app-managers)." \ No newline at end of file