From 6cb2f9c69271ed7e9468c35eff9c9177a890ae8b Mon Sep 17 00:00:00 2001 From: Giovanni Toraldo <71768+gionn@users.noreply.github.com> Date: Thu, 8 Aug 2024 09:15:45 +0200 Subject: [PATCH 1/5] Fix example for running a workflow when a pull request is approved (#34235) --- .../events-that-trigger-workflows.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/actions/writing-workflows/choosing-when-your-workflow-runs/events-that-trigger-workflows.md b/content/actions/writing-workflows/choosing-when-your-workflow-runs/events-that-trigger-workflows.md index 43aabbe28f..2f133c781a 100644 --- a/content/actions/writing-workflows/choosing-when-your-workflow-runs/events-that-trigger-workflows.md +++ b/content/actions/writing-workflows/choosing-when-your-workflow-runs/events-that-trigger-workflows.md @@ -765,7 +765,7 @@ on: jobs: approved: - if: github.event.review.state == 'APPROVED' + if: github.event.review.state == 'approved' runs-on: ubuntu-latest steps: - run: echo "This PR was approved" From 95100f67f0b15bc39f5a9d9404abc9777aeed1ed Mon Sep 17 00:00:00 2001 From: Sophie <29382425+sophietheking@users.noreply.github.com> Date: Thu, 8 Aug 2024 09:55:58 +0200 Subject: [PATCH 2/5] Adds note to the "Adding seats to your enterprise account" article (#51943) --- .../adding-seats-to-your-enterprise-account.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/content/billing/using-the-enhanced-billing-platform-for-enterprises/adding-seats-to-your-enterprise-account.md b/content/billing/using-the-enhanced-billing-platform-for-enterprises/adding-seats-to-your-enterprise-account.md index 117991396b..152f76d5f3 100644 --- a/content/billing/using-the-enhanced-billing-platform-for-enterprises/adding-seats-to-your-enterprise-account.md +++ b/content/billing/using-the-enhanced-billing-platform-for-enterprises/adding-seats-to-your-enterprise-account.md @@ -10,6 +10,8 @@ permissions: The enhanced billing platform is available to all enterprise accoun shortTitle: Add seats to your enterprise --- +>[!IMPORTANT] If you pay by invoice, you need to contact your account manager in {% data variables.contact.contact_enterprise_sales %} to add seats to your enterprise account. + If you have access to the enhanced billing platform, you can add seats to your enterprise account through the "Licensing" page. To check if you have access, see "[AUTOTITLE](/billing/using-the-enhanced-billing-platform-for-enterprises/about-the-enhanced-billing-platform-for-enterprises#how-do-i-know-if-i-can-access-the-enhanced-billing-platform)." {% data reusables.enterprise-accounts.access-enterprise %} From adbf3cac36eeb51e4deb226c663acda9bcc5509e Mon Sep 17 00:00:00 2001 From: Sophie <29382425+sophietheking@users.noreply.github.com> Date: Thu, 8 Aug 2024 10:29:08 +0200 Subject: [PATCH 3/5] [Improvement]: Update instructions to downloading the enterprise licensing csv (#51901) Co-authored-by: Isaac Brown <101839405+isaacmbrown@users.noreply.github.com> --- .../viewing-license-usage-for-github-enterprise.md | 9 +++++---- data/reusables/enterprise-accounts/license-tab.md | 6 ++---- 2 files changed, 7 insertions(+), 8 deletions(-) diff --git a/content/billing/managing-your-license-for-github-enterprise/viewing-license-usage-for-github-enterprise.md b/content/billing/managing-your-license-for-github-enterprise/viewing-license-usage-for-github-enterprise.md index 4604b204d4..104ee3acec 100644 --- a/content/billing/managing-your-license-for-github-enterprise/viewing-license-usage-for-github-enterprise.md +++ b/content/billing/managing-your-license-for-github-enterprise/viewing-license-usage-for-github-enterprise.md @@ -1,7 +1,7 @@ --- title: Viewing license usage for GitHub Enterprise intro: 'You can view license usage for your enterprise on {% ifversion ghec %}{% data variables.product.prodname_dotcom_the_website %}{% elsif ghes %}{% data variables.location.product_location %}{% endif %}.' -permissions: 'Enterprise owners can view license usage for {% data variables.product.prodname_enterprise %}.' +permissions: 'Enterprise owners{% ifversion ghec %} and billing managers{% endif %}' versions: ghec: '*' ghes: '*' @@ -44,9 +44,10 @@ You can view the license usage for your enterprise and download a file with lice {% data reusables.enterprise-accounts.settings-tab %} {% data reusables.enterprise-accounts.license-tab %} 1. Review your current {% data variables.product.prodname_enterprise %} license, as well as consumed and available user licenses. - * To download the consumed license report as a CSV file, to the right of "User licenses," click {% octicon "download" aria-hidden="true" %} **CSV report**. For more information about reviewing the data in this report, see "[AUTOTITLE](/billing/managing-your-license-for-github-enterprise/troubleshooting-license-usage-for-github-enterprise)." - * If you purchased {% data variables.product.prodname_GH_advanced_security %}, you can review your total {% ifversion ghas-billing-UI-update %}license{% else %}seat{% endif %} usage. For more information, see "[AUTOTITLE](/billing/managing-billing-for-github-advanced-security/viewing-your-github-advanced-security-usage)." - * To view an overview of the consumed licenses without downloading a report, click **View details**, then look under "User licenses consumed". For more information, see "[AUTOTITLE](/admin/managing-accounts-and-repositories/managing-users-in-your-enterprise/viewing-people-in-your-enterprise#user-licenses-consumed)." + + * If you purchased {% data variables.product.prodname_GH_advanced_security %}, you can review your total {% ifversion ghas-billing-UI-update %}license{% else %}seat{% endif %} usage. To learn about the information displayed, see "[AUTOTITLE](/billing/managing-billing-for-github-advanced-security/viewing-your-github-advanced-security-usage)." + +1. To download a CSV report of the license usage, click {% octicon "kebab-horizontal" aria-label="Licensing dropdown" %} to the right of the usage you want to download, then click {% octicon "download" aria-hidden="true" %} **CSV report**. {% elsif ghes %} diff --git a/data/reusables/enterprise-accounts/license-tab.md b/data/reusables/enterprise-accounts/license-tab.md index 4c958c7ad8..240d26d875 100644 --- a/data/reusables/enterprise-accounts/license-tab.md +++ b/data/reusables/enterprise-accounts/license-tab.md @@ -1,5 +1,3 @@ -1. Under {% octicon "gear" aria-hidden="true" %} **Settings**, click **{% ifversion ghec %}Enterprise licensing{% elsif ghes %}License{% endif %}**. {% ifversion ghec %} +1. Under {% octicon "gear" aria-hidden="true" %} **Settings**, click **{% ifversion ghec %}Licensing{% elsif ghes %}License{% endif %}**. {% ifversion enhanced-billing-platform %} - >[!NOTE] Enterprise accounts, and organizations owned by enterprise accounts, created after June 2, 2024, have access to the enhanced billing platform. Enterprises that participated in the beta program also have access to the enhanced billing platform. - > - > As part of the enhanced billing platform, the licensing page has been relocated. See "[AUTOTITLE](/billing/using-the-enhanced-billing-platform-for-enterprises/gathering-insights-on-your-spending#viewing-license-usage)."{% endif %} + >[!NOTE] If you are on the enhanced billing platform, the licensing page has been relocated. See "[AUTOTITLE](/billing/using-the-enhanced-billing-platform-for-enterprises/gathering-insights-on-your-spending#viewing-license-usage)."{% endif %} From 4875b6615ac31aafc07e9be10397656458e1689f Mon Sep 17 00:00:00 2001 From: docs-bot <77750099+docs-bot@users.noreply.github.com> Date: Thu, 8 Aug 2024 02:20:59 -0700 Subject: [PATCH 4/5] [Early access companion] PR #340 (#51856) From c6048b362c38d0a028a7088c5fed8b7acec8afb6 Mon Sep 17 00:00:00 2001 From: Isaac Brown <101839405+isaacmbrown@users.noreply.github.com> Date: Thu, 8 Aug 2024 10:51:15 +0100 Subject: [PATCH 5/5] Migrate Copilot Business without GHE docs from early access (#51754) Co-authored-by: Allison Weins <3174849+2percentsilk@users.noreply.github.com> --- .../copilot/copilot-business-manage-seats.png | Bin 0 -> 78403 bytes ...nterprise-accounts-for-copilot-business.md | 68 +++++++++++++ content/admin/copilot-business-only/index.md | 11 +++ ...rise-for-copilot-business-managed-users.md | 93 ++++++++++++++++++ ...-for-copilot-business-personal-accounts.md | 81 +++++++++++++++ content/admin/index.md | 1 + .../creating-an-enterprise-account.md | 1 + .../what-is-github-copilot.md | 2 + .../assign-licenses.md | 12 +++ .../enable-copilot.md | 7 ++ .../link-azure-subscription.md | 8 ++ .../manage-your-enterprise.md | 23 +++++ .../prerequisites.md | 2 + .../request-access.md | 1 + 14 files changed, 310 insertions(+) create mode 100644 assets/images/help/copilot/copilot-business-manage-seats.png create mode 100644 content/admin/copilot-business-only/about-enterprise-accounts-for-copilot-business.md create mode 100644 content/admin/copilot-business-only/index.md create mode 100644 content/admin/copilot-business-only/setting-up-a-dedicated-enterprise-for-copilot-business-managed-users.md create mode 100644 content/admin/copilot-business-only/setting-up-a-dedicated-enterprise-for-copilot-business-personal-accounts.md create mode 100644 data/reusables/copilot-business-for-non-ghe/assign-licenses.md create mode 100644 data/reusables/copilot-business-for-non-ghe/enable-copilot.md create mode 100644 data/reusables/copilot-business-for-non-ghe/link-azure-subscription.md create mode 100644 data/reusables/copilot-business-for-non-ghe/manage-your-enterprise.md create mode 100644 data/reusables/copilot-business-for-non-ghe/prerequisites.md create mode 100644 data/reusables/copilot-business-for-non-ghe/request-access.md diff --git a/assets/images/help/copilot/copilot-business-manage-seats.png b/assets/images/help/copilot/copilot-business-manage-seats.png new file mode 100644 index 0000000000000000000000000000000000000000..7ef4379962dcd15563fcd28f0488e69e82aa2268 GIT binary patch literal 78403 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 P;7|Fk#+{Pe=0X1haQ*&x literal 0 HcmV?d00001 diff --git a/content/admin/copilot-business-only/about-enterprise-accounts-for-copilot-business.md b/content/admin/copilot-business-only/about-enterprise-accounts-for-copilot-business.md new file mode 100644 index 0000000000..4779a8ea9d --- /dev/null +++ b/content/admin/copilot-business-only/about-enterprise-accounts-for-copilot-business.md @@ -0,0 +1,68 @@ +--- +title: About enterprise accounts for Copilot Business +intro: 'Learn about the options for creating an enterprise account to manage {% data variables.product.prodname_copilot_business_short %} licenses, without adopting {% data variables.product.prodname_enterprise %}.' +versions: + ghec: '*' +topics: + - Accounts + - Enterprise + - Fundamentals +shortTitle: About the account +redirect_from: + - /early-access/copilot/managing-copilot-business-licenses-with-an-enterprise-account +--- + +You can use an enterprise account to manage licenses for {% data variables.product.prodname_copilot_for_business %}, without adopting {% data variables.product.prodname_enterprise %}. + +>[!NOTE] Access to this feature is currently managed by {% data variables.contact.contact_enterprise_sales %}. + +## What is an enterprise account for {% data variables.product.prodname_copilot_business_short %}? + +To use {% data variables.product.prodname_copilot %}, a user must authenticate to an account on {% data variables.product.prodname_dotcom %} that has a license for {% data variables.product.prodname_copilot_short %}. Organizations and enterprises on {% data variables.product.prodname_dotcom %} can manage members' access to {% data variables.product.prodname_copilot_short %} through a {% data variables.product.prodname_copilot_business_short %} subscription. + +If you don't already manage users through an organization or enterprise, you can create an enterprise account specifically for allocating {% data variables.product.prodname_copilot_business_short %} licenses. + +* You'll only pay for the {% data variables.product.prodname_copilot_short %} licenses you assign. For pricing, see "[AUTOTITLE](/billing/managing-billing-for-github-copilot/about-billing-for-github-copilot#pricing-for-github-copilot-business)." +* You won't pay for {% data variables.product.prodname_enterprise %} seats. +* You won't be able to create organizations or repositories in the enterprise, or use features that require repositories or organizations, such as {% data variables.product.prodname_actions %}. + +When you create the account, you can choose whether your enterprise members will authenticate using their personal {% data variables.product.company_short %} accounts, or using new accounts that you will create and manage from an external identity management system. For a comparison, see "[AUTOTITLE](/admin/identity-and-access-management/understanding-iam-for-enterprises/choosing-an-enterprise-type-for-github-enterprise-cloud)." + +## How will I manage access for users? + +How you will add users to your enterprise and manage license assignment depends on whether you choose an enterprise with personal accounts or with {% data variables.product.prodname_emus %}. + +### Personal accounts + +If you request an enterprise with personal accounts: + +* You'll **add users** to the enterprise by sending an invitation to their personal {% data variables.product.prodname_dotcom %} account. +* You'll **create teams** in the enterprise to manage which users receive {% data variables.product.prodname_copilot_business_short %} licenses. You can manage membership of the teams on {% data variables.product.prodname_dotcom_the_website %} or with the REST API. +* When users receive a license, they can authenticate to {% data variables.product.prodname_dotcom %} from their development environment and **gain access** to {% data variables.product.prodname_copilot_short %}. +* Optionally, you can configure **SAML single sign-on** (SSO), so that users must authenticate to an external identity system in addition to their personal account. + +### {% data variables.product.prodname_emus %} + +If you request an {% data variables.enterprise.prodname_emu_enterprise %}: + +* You'll **add users** to the enterprise by provisioning {% data variables.enterprise.prodname_managed_users %} from an identity provider (IdP), using SCIM. +* You'll **create teams** in the enterprise to manage which users receive {% data variables.product.prodname_copilot_business_short %} licenses. You can manage membership of the teams from your IdP, on {% data variables.product.prodname_dotcom_the_website %}, or with the REST API. +* When users receive a license, they can use single sign-on to authenticate to their {% data variables.product.prodname_dotcom %} account from their development environment and **gain access** to {% data variables.product.prodname_copilot_short %}. + +## Limitations + +* You will not be able to use REST API endpoints that require an organization. In particular, these include: + * "[List enterprise consumed licenses](/rest/enterprise-admin/license#list-enterprise-consumed-licenses)" + * "[AUTOTITLE](/rest/orgs/members)" + * "[AUTOTITLE](/rest/copilot/copilot-user-management)" +* Documentation on {% data variables.product.prodname_docs %} may not apply to your enterprise. +* With an enterprise for personal accounts, you cannot use team synchronization to manage membership of enterprise teams. + +## Getting started + +To get started, you will work with {% data variables.contact.contact_enterprise_sales %} to create an enterprise account, then add users to your enterprise and assign {% data variables.product.prodname_copilot_business_short %} licenses. + +See the setup guide for your chosen type of enterprise. + +* "[AUTOTITLE](/admin/copilot-business-only/setting-up-a-dedicated-enterprise-for-copilot-business-personal-accounts) +* "[AUTOTITLE](/admin/copilot-business-only/setting-up-a-dedicated-enterprise-for-copilot-business-managed-users) diff --git a/content/admin/copilot-business-only/index.md b/content/admin/copilot-business-only/index.md new file mode 100644 index 0000000000..477a6cdfff --- /dev/null +++ b/content/admin/copilot-business-only/index.md @@ -0,0 +1,11 @@ +--- +title: Using a dedicated enterprise account for Copilot Business +intro: Get started with an enterprise account for managing {% data variables.product.prodname_copilot_business_short %} licenses. +versions: + ghec: '*' +children: + - /about-enterprise-accounts-for-copilot-business + - /setting-up-a-dedicated-enterprise-for-copilot-business-personal-accounts + - /setting-up-a-dedicated-enterprise-for-copilot-business-managed-users +shortTitle: Copilot Business only +--- diff --git a/content/admin/copilot-business-only/setting-up-a-dedicated-enterprise-for-copilot-business-managed-users.md b/content/admin/copilot-business-only/setting-up-a-dedicated-enterprise-for-copilot-business-managed-users.md new file mode 100644 index 0000000000..d13268e373 --- /dev/null +++ b/content/admin/copilot-business-only/setting-up-a-dedicated-enterprise-for-copilot-business-managed-users.md @@ -0,0 +1,93 @@ +--- +title: Setting up a dedicated enterprise for Copilot Business ({% data variables.product.prodname_emus %}) +intro: 'Set up your account, provision users, and assign licenses.' +versions: + ghec: '*' +topics: + - Accounts + - Enterprise + - Fundamentals +shortTitle: Set up with managed users +allowTitleToDifferFromFilename: true +redirect_from: + - /early-access/copilot/using-copilot-business-without-github-enterprise-managed-users + +--- + +You can use an enterprise account to manage licenses for {% data variables.product.prodname_copilot_for_business %}, without adopting {% data variables.product.prodname_enterprise %}. + +This article describes the setup for an **enterprise with managed users**. If you haven't chosen an enterprise type, see "[AUTOTITLE](/admin/copilot-business-only/about-enterprise-accounts-for-copilot-business)." + +## Prerequisites + +* To provision users, you must connect the enterprise account to an identity management system. {% data variables.product.company_short %} partners with some developers of identity management systems to provide a "paved-path" integration with {% data variables.product.prodname_emus %}. See "[AUTOTITLE](/admin/identity-and-access-management/understanding-iam-for-enterprises/about-enterprise-managed-users#identity-management-systems)." +{% data reusables.copilot-business-for-non-ghe.prerequisites %} + +## Requesting an enterprise account + +{% data reusables.copilot-business-for-non-ghe.request-access %} + +## Adding users to the enterprise + +To provision user accounts through your IdP, you'll need to **configure your IdP** by completing the following steps. + +### Step 1: Configure authentication + +To manage single sign-on (SSO) for users, you must connect your IdP to your enterprise account. You can use: +* **SAML** with Entra ID, Okta, or PingFederate. For instructions, see "[AUTOTITLE](/admin/identity-and-access-management/configuring-authentication-for-enterprise-managed-users/configuring-saml-single-sign-on-for-enterprise-managed-users)." +* **OIDC** with Entra ID. For instructions, see "[AUTOTITLE](/admin/identity-and-access-management/configuring-authentication-for-enterprise-managed-users/configuring-oidc-for-enterprise-managed-users)." + +### Step 2: Configure SCIM provisioning + +To provision accounts from your IdP, you must configure SCIM provisioning. For instructions, see "[AUTOTITLE](/admin/identity-and-access-management/provisioning-user-accounts-for-enterprise-managed-users/configuring-scim-provisioning-for-enterprise-managed-users)." + +If you want to manage membership of teams from your IdP, you must assign the relevant identity groups to the {% data variables.product.prodname_emu_idp_application %} application on your IdP. + +### Step 3: Assign an enterprise owner + +After you configure authentication and provisioning with your IdP, grant one or more users the enterprise owner role. Enterprise owners can enable {% data variables.product.prodname_copilot_short %} for the enterprise and manage which users receive licenses. For instructions, see "[AUTOTITLE](/admin/identity-and-access-management/provisioning-user-accounts-for-enterprise-managed-users/configuring-scim-provisioning-for-enterprise-managed-users#assigning-users-and-groups)." + +You can also grant the billing manager role. A billing manager can view the assigned licenses for an enterprise, but cannot assign licenses or manage enterprise teams. + +## Linking an Azure subscription + +{% data reusables.copilot-business-for-non-ghe.link-azure-subscription %} + +## Enabling {% data variables.product.prodname_copilot_short %} for the enterprise + +{% data reusables.copilot-business-for-non-ghe.enable-copilot %} + +## Assigning licenses to users + +When {% data variables.product.prodname_copilot_short %} has been enabled for the enterprise, an **enterprise owner** can create teams in the enterprise and assign licenses to a team. + +* You will grant or remove licenses for users by managing membership of the teams, either from your IdP, directly in {% data variables.product.prodname_dotcom %}, or with the REST API. +* You cannot assign licenses to individual users or to an entire enterprise. +* To manage membership from your IdP, ensure the relevant identity groups have been assigned to the {% data variables.product.prodname_emu_idp_application %} application in your IdP and pushed to {% data variables.product.prodname_dotcom %} via SCIM. + +The same user can be a member of multiple teams. You will only be charged once per user. + +### Creating a team + +> [!NOTE] You can create teams and manage membership using the REST API. For endpoint documentation, please contact your account manager. + +{% data reusables.enterprise-accounts.people-tab %} +1. Under "People", click **Enterprise teams**. +1. Click **New enterprise team**. +1. Enter a name for the team. +1. Optionally, to sync the team with an identity group and manage membership from your IdP, under "Identity Provider Group", select a group from the dropdown menu. If you leave this dropdown menu empty, you will manage membership of the team directly. +1. Click **Create team**. +1. Add users to the team: + + * If you linked the team to an IdP group, add users to the related group in your IdP. + * If you are managing team membership directly, on the team page, click **Add a member**, then search for and select the user. For information about how {% data variables.product.company_short %} generates usernames for users provisioned from an IdP, see "[AUTOTITLE](/admin/identity-and-access-management/iam-configuration-reference/username-considerations-for-external-authentication#about-usernames-for-managed-user-accounts)." + +### Assigning licenses to a team + +{% data reusables.copilot-business-for-non-ghe.assign-licenses %} + +> [!NOTE] If you manage team membership from Entra ID, addition or removal of a user from a team on {% data variables.product.prodname_dotcom %} may take up to 40 minutes. After Entra ID communicates with {% data variables.product.prodname_dotcom %}, the change will take effect after {% data variables.product.prodname_dotcom %} prompts the user to authenticate. + +## Managing your enterprise + +{% data reusables.copilot-business-for-non-ghe.manage-your-enterprise %} diff --git a/content/admin/copilot-business-only/setting-up-a-dedicated-enterprise-for-copilot-business-personal-accounts.md b/content/admin/copilot-business-only/setting-up-a-dedicated-enterprise-for-copilot-business-personal-accounts.md new file mode 100644 index 0000000000..4c93271456 --- /dev/null +++ b/content/admin/copilot-business-only/setting-up-a-dedicated-enterprise-for-copilot-business-personal-accounts.md @@ -0,0 +1,81 @@ +--- +title: Setting up a dedicated enterprise for Copilot Business (personal accounts) +intro: 'Set up your account, provision users, and assign licenses.' +versions: + ghec: '*' +topics: + - Accounts + - Enterprise + - Fundamentals +shortTitle: Set up with personal accounts +redirect_from: + - /early-access/copilot/using-copilot-business-without-github-enterprise-personal-accounts +--- + +You can use an enterprise account to manage licenses for {% data variables.product.prodname_copilot_for_business %}, without adopting {% data variables.product.prodname_enterprise %}. + +This article describes the setup for an **enterprise with personal accounts**. If you haven't chosen an enterprise type, see "[AUTOTITLE](/admin/copilot-business-only/about-enterprise-accounts-for-copilot-business)." + +## Prerequisites + +{% data reusables.copilot-business-for-non-ghe.prerequisites %} + +## Requesting an enterprise account + +{% data reusables.copilot-business-for-non-ghe.request-access %} + +## Adding users to the enterprise + +After you invite someone to join the enterprise account, they must accept the emailed invitation before they can access the enterprise account. Pending invitations will expire after 7 days. + +{% data reusables.enterprise-accounts.access-enterprise %} +{% data reusables.enterprise-accounts.people-tab %} +1. Under "People", click **Members**. +1. Click **Invite member**. +1. Search for the user you want to invite, then click **Invite**. + +### Inviting an enterprise owner + +You can also invite a user as an enterprise owner. Enterprise owners can grant access to {% data variables.product.prodname_copilot %} and set policies for the enterprise. See "[AUTOTITLE](/admin/managing-accounts-and-repositories/managing-users-in-your-enterprise/inviting-people-to-manage-your-enterprise#inviting-an-enterprise-administrator-to-your-enterprise-account)." + +You can also invite a user as a billing manager. A billing manager can view the assigned licenses for an enterprise, but cannot assign licenses or manage enterprise teams. + +### Configuring SAML authentication + +You can configure SAML single sign-on to require users to authenticate to an external identity management system in addition to their personal account. See "[AUTOTITLE](/admin/identity-and-access-management/using-saml-for-enterprise-iam/configuring-saml-single-sign-on-for-your-enterprise)." + +## Linking an Azure subscription + +{% data reusables.copilot-business-for-non-ghe.link-azure-subscription %} + +## Enabling {% data variables.product.prodname_copilot_short %} for the enterprise + +{% data reusables.copilot-business-for-non-ghe.enable-copilot %} + +## Assigning licenses to users + +When {% data variables.product.prodname_copilot_short %} has been enabled for the enterprise, an **enterprise owner** can create teams in the enterprise and assign licenses to a team. + +* You will grant or remove licenses for users by managing membership of the teams, either in {% data variables.product.prodname_dotcom %} or with the REST API. +* You cannot assign licenses to individual users or to an entire enterprise. + +The same user can be a member of multiple teams. You will only be charged once per user. + +### Creating a team + +> [!NOTE] You can create teams and manage membership using the REST API. For endpoint documentation, please contact your account manager. + +{% data reusables.enterprise-accounts.people-tab %} +1. Under "People", click **Enterprise teams**. +1. Click **New enterprise team**. +1. Enter a name for the team. +1. Click **Create team**. +1. To add users, click **Add a member**, then search for and select the user. + +### Assigning licenses to a team + +{% data reusables.copilot-business-for-non-ghe.assign-licenses %} + +## Managing your enterprise + +{% data reusables.copilot-business-for-non-ghe.manage-your-enterprise %} diff --git a/content/admin/index.md b/content/admin/index.md index 7b28d6e1b6..6e8ecb0765 100644 --- a/content/admin/index.md +++ b/content/admin/index.md @@ -113,6 +113,7 @@ children: - /managing-github-actions-for-your-enterprise - /configuring-packages - /managing-code-security + - /copilot-business-only - /guides - /release-notes - /all-releases diff --git a/content/admin/managing-your-enterprise-account/creating-an-enterprise-account.md b/content/admin/managing-your-enterprise-account/creating-an-enterprise-account.md index 1a50cc5e16..6691f41f8c 100644 --- a/content/admin/managing-your-enterprise-account/creating-an-enterprise-account.md +++ b/content/admin/managing-your-enterprise-account/creating-an-enterprise-account.md @@ -32,6 +32,7 @@ You'll **need help** creating an enterprise account for: * {% data variables.product.prodname_ghe_server %} * Invoicing +* Managing {% data variables.product.prodname_copilot_for_business %} licenses without adopting {% data variables.product.prodname_enterprise %} In these cases, contact {% data variables.contact.contact_enterprise_sales %}. diff --git a/content/copilot/about-github-copilot/what-is-github-copilot.md b/content/copilot/about-github-copilot/what-is-github-copilot.md index 7ef7717555..f0a5560476 100644 --- a/content/copilot/about-github-copilot/what-is-github-copilot.md +++ b/content/copilot/about-github-copilot/what-is-github-copilot.md @@ -60,6 +60,8 @@ For more information, see "[AUTOTITLE](/copilot/about-github-copilot/github-copi **As an enterprise owner**, you can purchase a subscription to {% data variables.product.prodname_copilot_for_business %} or {% data variables.product.prodname_copilot_enterprise %} for your enterprise, and allow organizations to grant access to members. See "[AUTOTITLE](/copilot/managing-copilot/managing-copilot-for-your-enterprise/subscribing-to-copilot-for-your-enterprise)." +If you **don't need other features**, you can request an enterprise account specifically for managing {% data variables.product.prodname_copilot_for_business %} licenses. You won't pay for {% data variables.product.prodname_enterprise %} seats, and you won't be able to create organizations or repositories. See "[AUTOTITLE](/enterprise-cloud@latest/admin/copilot-business-only/about-enterprise-accounts-for-copilot-business)." + ## Next steps * To learn more about the Copilot features, see "[AUTOTITLE](/copilot/about-github-copilot/github-copilot-features)." diff --git a/data/reusables/copilot-business-for-non-ghe/assign-licenses.md b/data/reusables/copilot-business-for-non-ghe/assign-licenses.md new file mode 100644 index 0000000000..7515c6d411 --- /dev/null +++ b/data/reusables/copilot-business-for-non-ghe/assign-licenses.md @@ -0,0 +1,12 @@ +When you have created a team in the enterprise, you can assign licenses to all members of the team. + +{% data reusables.enterprise-accounts.settings-tab %} +1. Under {% octicon "gear" aria-hidden="true" %} **Settings**, click **Enterprise licensing**. +1. In the "{% data variables.product.prodname_copilot_business_short %}" section, click **Manage seats**. + + ![Screenshot of the "{% data variables.product.prodname_copilot_business_short %}" section. A button, labeled "Manage seats", is highlighted with an orange outline.](/assets/images/help/copilot/copilot-business-manage-seats.png) + +1. Click **Add teams**. +1. In the dialog, select the teams you want to add, review how your bill will be affected, then click **Add teams**. + +You can add or remove users from a team at any time. After you remove a user from a team, the user's license and access to {% data variables.product.prodname_copilot_short %} will be removed the next time the user attempts to authenticate. This can take **up to 30 minutes**. diff --git a/data/reusables/copilot-business-for-non-ghe/enable-copilot.md b/data/reusables/copilot-business-for-non-ghe/enable-copilot.md new file mode 100644 index 0000000000..af28fff45a --- /dev/null +++ b/data/reusables/copilot-business-for-non-ghe/enable-copilot.md @@ -0,0 +1,7 @@ +Before you can assign licenses, an **enterprise owner** must enable {% data variables.product.prodname_copilot_short %} for the enterprise and select policies for certain features. + +{% data reusables.enterprise-accounts.access-enterprise %} +{% data reusables.enterprise-accounts.policies-tab %} +{% data reusables.enterprise-accounts.copilot-tab %} +1. Under "{% data variables.product.prodname_copilot %} policies", click **Allowed**, then click **Save**. +1. Review the policies for suggestions matching public code and {% data variables.product.prodname_copilot_chat_short %}, and update the dropdown menus to enable or disable the features as required. diff --git a/data/reusables/copilot-business-for-non-ghe/link-azure-subscription.md b/data/reusables/copilot-business-for-non-ghe/link-azure-subscription.md new file mode 100644 index 0000000000..cbae92091e --- /dev/null +++ b/data/reusables/copilot-business-for-non-ghe/link-azure-subscription.md @@ -0,0 +1,8 @@ +To pay for licenses, you must connect your enterprise to an Azure subscription. + +For an overview of the process, watch [Billing {% data variables.product.company_short %} consumption through an Azure subscription](https://www.youtube.com/watch?v=DAiIhJKCt8s&ab_channel=GitHub) on our YouTube channel. + +For written instructions, read the following sections in the "Connecting an Azure subscription" article: + +* "[Prerequisites](/billing/managing-the-plan-for-your-github-account/connecting-an-azure-subscription#prerequisites)" +* "[Connecting your Azure subscription to an enterprise account](/billing/managing-the-plan-for-your-github-account/connecting-an-azure-subscription#connecting-your-azure-subscription-to-your-enterprise-account)" diff --git a/data/reusables/copilot-business-for-non-ghe/manage-your-enterprise.md b/data/reusables/copilot-business-for-non-ghe/manage-your-enterprise.md new file mode 100644 index 0000000000..f57328a1a1 --- /dev/null +++ b/data/reusables/copilot-business-for-non-ghe/manage-your-enterprise.md @@ -0,0 +1,23 @@ +For next steps that apply to any enterprise using {% data variables.product.prodname_copilot_business_short %}, see "[AUTOTITLE](/copilot/setting-up-github-copilot/setting-up-github-copilot-for-your-enterprise)." The step for granting access to organizations does not apply. + +The following sections contain specific information for your enterprise. + +### Automate license management + +You can use the REST API to automate license management. For example, you can list assigned licenses and latest activity, then remove access for users who haven't been using their license. + +To do this in your enterprise, you can use the "[List all {% data variables.product.prodname_copilot_short %} seat assignments for an enterprise](/rest/copilot/copilot-user-management#list-all-copilot-seat-assignments-for-an-enterprise)" endpoint, then use the API to manage access to enterprise teams. To request documentation for the API endpoints for enterprise teams, please contact your account manager. + +### Manage billing + +Your enterprise has access to the enhanced billing platform, which allows you to estimate upcoming spending, control overspending with budgets, and track spending changes over time. + +See "[AUTOTITLE](/billing/using-the-enhanced-billing-platform-for-enterprises)." + +### Configure content exclusions + +You can prevent specified files or repositories from being used to inform code completion suggestions made by {% data variables.product.prodname_copilot %}. {% data variables.product.prodname_copilot %} will not be available in excluded files. + +{% data reusables.enterprise-accounts.policies-tab %} +1. Click the **Content exclusion** tab. +1. Use paths to specify which content to exclude. See "[AUTOTITLE](/copilot/managing-copilot/managing-github-copilot-in-your-organization/configuring-content-exclusions-for-github-copilot)." diff --git a/data/reusables/copilot-business-for-non-ghe/prerequisites.md b/data/reusables/copilot-business-for-non-ghe/prerequisites.md new file mode 100644 index 0000000000..f02e3f704e --- /dev/null +++ b/data/reusables/copilot-business-for-non-ghe/prerequisites.md @@ -0,0 +1,2 @@ +* To pay for licenses, you will need a **Microsoft Azure subscription**, which you will connect to your enterprise account. +* Before you enable {% data variables.product.prodname_copilot_short %}, ensure you have reviewed the [{% data variables.product.prodname_copilot %} Product Specific Terms](https://github.com/customer-terms/github-copilot-product-specific-terms). diff --git a/data/reusables/copilot-business-for-non-ghe/request-access.md b/data/reusables/copilot-business-for-non-ghe/request-access.md new file mode 100644 index 0000000000..9e64467b09 --- /dev/null +++ b/data/reusables/copilot-business-for-non-ghe/request-access.md @@ -0,0 +1 @@ +To create an enterprise account, request access from your account team by contacting {% data variables.contact.contact_enterprise_sales %}.