Skip to content

Latest commit

 

History

History
131 lines (91 loc) · 11.8 KB

managing-access-for-copilot-in-your-organization.md

File metadata and controls

131 lines (91 loc) · 11.8 KB
title intro permissions versions redirect_from topics shortTitle
Managing access for Copilot in your organization
Learn how to manage access to {% ifversion ghec %}{% data variables.product.prodname_copilot_enterprise_short %} and{% endif %} {% data variables.product.prodname_copilot_business_short %} in your organization, and review usage data to inform your decisions.
{% ifversion ghec %} Enterprise owners can administer access to {% data variables.product.prodname_copilot %} for organizations within the enterprise.{% endif %} Organization owners can configure access to {% data variables.product.prodname_copilot %} for members of their organization. Organization owners can also access usage data relating to {% data variables.product.prodname_copilot %} in their organization and use that data to make informed decisions about seat assignment.
feature
copilot
/copilot/managing-github-copilot-in-your-organization/managing-access-for-copilot-business-in-your-organization
/copilot/managing-copilot-for-business/managing-access-for-copilot-for-business-in-your-organization
/copilot/managing-copilot-business/managing-access-for-copilot-business-in-your-organization
Copilot
Managing access

About managing access to {% data variables.product.prodname_copilot %} in your organization

{% ifversion ghec %}{% data variables.product.prodname_copilot_enterprise %} and {% endif %}{% data variables.product.prodname_copilot_for_business %} {% ifversion ghec %}are{% else %}is a{% endif %} {% data variables.product.prodname_copilot %} subscription{% ifversion ghec %}s{% endif %}, billed and administered at the organization {% ifversion ghec %}or enterprise {% endif %}level. {% ifversion ghec %}

Enterprise owners can enable or disable {% data variables.product.prodname_copilot %} for organizations within their enterprise. For more information, see "AUTOTITLE."

{% endif %}Organization owners can administer access to {% data variables.product.prodname_copilot_short %} for teams and individuals within the organization. Organization owners can also access usage data relating to {% data variables.product.prodname_copilot %} in their organization, and use that data to make informed decisions about seat assignment.

Organization{% ifversion ghec %} and enterprise{% endif %} owners can manage various policies for {% data variables.product.prodname_copilot_short %}, such as whether to allow or block suggestions that match public code. For more information{% ifversion ghec %} about managing policies at the organization level{% endif %}, see "AUTOTITLE."{% ifversion ghec %} For more information about managing policies at the enterprise level, see "AUTOTITLE" {% endif %}

Configuring access to {% data variables.product.prodname_copilot %} in your organization

{% ifversion ghec %}After a {% data variables.product.prodname_dotcom %} enterprise owner has enabled a {% data variables.product.prodname_copilot_enterprise_short %} or {% data variables.product.prodname_copilot_business_short %} subscription for an organization, an owner of that organization can assign {% data variables.product.prodname_copilot %} seats to individuals and teams in the organization.{% else %}After setting up a {% data variables.product.prodname_copilot_business_short %} subscription, an organization owner can manage their organization members' access to {% data variables.product.prodname_copilot %}.{% endif %} Granting access to {% data variables.product.prodname_copilot %} requires a seat for each organization member you want to include.

Enabling access to {% data variables.product.prodname_copilot %} for all current and future users in your organization

{% data reusables.profile.access_org %} {% data reusables.profile.org_settings %} {% data reusables.copilot.access-settings %}

  1. If the Allow this organization to assign seats button is displayed, click this button.
  2. If you see the message "Configure code policies to start adding seats":
    1. Click Go to policies.
    2. Set any policies that are currently set to "Unconfigured".
    3. In the left sidebar, click Access.
  3. Under {% ifversion ghec %}"{% data variables.product.prodname_copilot_enterprise_short %} is active in your organization" or {% endif %}"{% data variables.product.prodname_copilot_business_short %} is active in your organization," to enable {% data variables.product.prodname_copilot %} for all current and future users in your organization, select Enabled For: All members of the organization.
  4. In the "Confirm seats purchase" dialog, to confirm that you want to enable {% data variables.product.prodname_copilot %} for all current and future users in your organization, click Purchase seats.

Enabling access to {% data variables.product.prodname_copilot %} for specific users in your organization

{% ifversion ghec %} {% note %}

Note: You can automatically enable access for every member of a group in your identity provider (IdP) by synchronizing that group with a {% data variables.product.prodname_dotcom %} team, then giving that team access to {% data variables.product.prodname_copilot %}. For more information, see "AUTOTITLE."

{% endnote %} {% endif %}

{% data reusables.profile.access_org %} {% data reusables.profile.org_settings %} {% data reusables.copilot.access-settings %}

  1. If the Allow this organization to assign seats button is displayed, click this button.

  2. If you see the message "Configure code policies to start adding seats":

    1. Click Go to policies.
    2. Set any policies that are currently set to "Unconfigured".
    3. In the left sidebar, click Access.
  3. Under {% ifversion ghec %}"{% data variables.product.prodname_copilot_enterprise_short %} is active in your organization" or {% endif %}"{% data variables.product.prodname_copilot_business_short %} is active in your organization," to enable {% data variables.product.prodname_copilot %} for selected teams or users in your organization, select Enabled For: Selected members.

  4. If you are updating user access from the Enabled For: All members of the organization setting, in the "Confirm policy update" dialog, select how you want to start assigning access.

    • To unassign all members and then select those who should have access, select Start from scratch.
    • To keep all members who currently have access and then select those who should not have access, select Renew seats.
  5. Click Assign {% data variables.product.prodname_copilot_short %} seats.

  6. In the "Enable Copilot access for users and teams" dialog, click one of the two tabs.

    Screenshot of the "enable access for selected members" dialog.

    • Click Users and teams to search for and add individual users or teams.

      To search for a user, type their username or full name in the search bar. If you select a user who is not currently a member of your organization, they will be invited to join your organization when you click Continue to purchase followed by Purchase seats.

    • Click Upload CSV to add users in bulk by uploading a CSV file.

      To add members in bulk, click Choose CSV to upload, and then upload a CSV file including either the username or email address for each member you want to add, separated by a comma. The file can contain a mixture of usernames and email addresses.

      {% warning %}

      Warning: When you upload a CSV file, unless you're using {% data variables.product.prodname_emus %}, {% data variables.product.prodname_copilot %} will search all users on {% data variables.product.prodname_dotcom_the_website %} for matches. If the CSV includes users who are not members of your organization, they will be invited to join your organization when you click Continue to purchase followed by Purchase seats. This warning does not apply to accounts using {% data variables.product.prodname_emus %}.

      {% endwarning %}

      Review the list of users generated from your CSV file. Clear the selection of any users you do not want to add.

  7. Click Continue to purchase, then click Purchase seats.

Revoking access to {% data variables.product.prodname_copilot %} for your whole organization

{% data reusables.copilot.disable-copilot-organization %}

Revoking access to {% data variables.product.prodname_copilot %} for specific users in your organization

Removing a user from the organization(s) that had assigned them a {% data variables.product.prodname_copilot %} seat will automatically unassign the seat from them. Alternatively, you can unassign a member's {% data variables.product.prodname_copilot %} seat while preserving their membership. These changes will take effect at the beginning of the next billing cycle.

{% data reusables.profile.access_org %} {% data reusables.profile.org_settings %} {% data reusables.copilot.access-settings %}

  1. Under {% ifversion ghec %}"{% data variables.product.prodname_copilot_enterprise_short %} is active in your organization" or {% endif %}"{% data variables.product.prodname_copilot_business_short %} is active in your organization," select Enabled For: selected members.

    • In the "Confirm policy update" dialog, click Renew seats.
  2. Under "Access management," in the search bar, type the member's username or full name.

  3. To remove the member from the list of users who have access to {% data variables.product.prodname_copilot %}, select the checkbox to the left of their username, then click Cancel seat.

    Screenshot of the Access management section, with a user selected and the 'Cancel seat' button highlighted.

  4. In the "Confirm seat removal" dialog, click Remove seats.

Reviewing usage data for {% data variables.product.prodname_copilot %} in your organization

You can review usage data for {% data variables.product.prodname_copilot %} in your organization to help you make informed decisions about seat assignment.

{% data reusables.profile.access_org %} {% data reusables.profile.org_settings %} {% data reusables.copilot.access-settings %}

  1. At the top of the page, under "{% data variables.product.prodname_copilot %}," you can see an overview of your organization's {% data variables.product.prodname_copilot %} usage. You can see the number seats assigned through your {% ifversion ghec %}{% data variables.product.prodname_copilot_enterprise_short %} or {% endif %}{% data variables.product.prodname_copilot_business_short %} subscription, and the estimated monthly cost.

    {% ifversion ghec %} Screenshot of the {% data variables.product.prodname_copilot %} usage overview. {% else %} Screenshot of the {% data variables.product.prodname_copilot %} usage overview. {% endif %}

  2. For more detailed information, next to "Access management," click Get report.

    • {% data variables.product.prodname_dotcom %} will generate a report for you, which you can download as a CSV file.
  3. Alternatively, under "Access management," you can use the Sort options to sort the list of users by when they last used {% data variables.product.prodname_copilot %}.

Further reading