title | intro | permissions | redirect_from | versions | topics | shortTitle | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Viewing people in your enterprise |
To audit access to enterprise-owned resources or user license usage, enterprise owners can view every administrator and member of the enterprise. |
Enterprise owners can view the people in an enterprise. |
|
|
|
View people in your enterprise |
{% data reusables.enterprise-managed.repo-collaborators-note %}
To audit access to your enterprise's resources and manage license usage, you can see a list of all the people who have access to your enterprise.
You can see all current enterprise members and enterprise administrators{% ifversion ghec %}, as well as pending invitations to become members and administrators{% endif %}. To make it easier to consume this information, you can search and filter the lists. You can also view an overview of the number of members in your enterprise, grouped by role{% ifversion ghec %}, type of license, or type of deployment{% endif %}.
{% ifversion ghec %}
If {% data variables.product.prodname_github_connect %} is configured for your enterprise, when you filter a list of people in your enterprise, the following limitations apply.
- The filter for two-factor authentication (2FA) status does not show people who only have an account on a {% data variables.product.prodname_ghe_server %} instance.
- If you combine the filter for accounts on {% data variables.product.prodname_ghe_server %} instances with either the filter for organizations or 2FA status, you will not see any results.
For more information about {% data variables.product.prodname_github_connect %}, see "AUTOTITLE" in the {% data variables.product.prodname_ghe_server %} documentation.
{% endif %}
{% ifversion enterprise-member-csv %} You can also export membership information for your enterprise. For more information, see "AUTOTITLE." {% endif %}
You can view all the current enterprise owners{% ifversion ghec %} and billing managers{% endif %} for your enterprise.{% ifversion enterprise-membership-view-improvements %} You can see useful information about each administrator{% ifversion ghec %} and filter the list by role{% endif %}.{% endif %} You can find a specific person by searching for their username or display name.
{% ifversion ghes %} Enterprise owners whose accounts are suspended are included in the list of enterprise administrators, and are identified as suspended. You should consider demoting any suspended owners you see. For more information, see "AUTOTITLE." {% endif %}
You can also remove an administrator. For more information. see "AUTOTITLE."
{% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.people-tab %} {% data reusables.enterprise-accounts.administrators-tab %}
Viewing members {% ifversion enterprise-membership-view-improvements %}{% else %}and outside collaborators{% endif %}
You can see all the current members {% ifversion enterprise-membership-view-improvements %}{% else %}or outside collaborators{% endif %} for your enterprise. You can see useful information about each account and filter the list in useful ways, such as by role. In addition to the list of members, you will see an overview of the number of members in your enterprise, grouped by role{% ifversion ghec %}, type of license, and type of deployment{% endif %}.
You can find a specific person by searching for the person's username or display name. To view more information about the person's access to your enterprise, such as the organizations the person belongs to, you can click the person's name.
{% ifversion remove-enterprise-members %} You can also remove any enterprise member from all organizations owned by the enterprise. For more information, see "AUTOTITLE." {% endif %}
{% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.people-tab %}{% ifversion enterprise-membership-view-improvements %} {% else %}
- Optionally, to view a list of outside collaborators rather than the list of members, under "Members", click Outside collaborators.{% endif %} {% ifversion enterprise-member-csv %}
- Optionally, to export the list of members as a CSV report, click CSV report. For more information about the information included in the report, see "AUTOTITLE."{% endif %}
{% ifversion enterprise-members-breakdown %}
On the "Members" page, you will find an overview of the number of members in your enterprise, grouped by role{% ifversion ghec %}, type of license consumed, and the type of deployment the member is on. The following sections explain how the numbers in this overview are calculated.
If your enterprise uses both {% data variables.product.prodname_ghe_cloud %} and {% data variables.product.prodname_ghe_server %}, to get accurate data about your members and licenses across your deployments, you will need to enable {% data variables.product.prodname_github_connect %} and synchronize license usage. For more information, see "AUTOTITLE" in the {% data variables.product.prodname_ghe_server %} documentation.
The "Roles" column groups members by their role in the enterprise{% endif %}. For more information, see "AUTOTITLE."
If a user has multiple roles in an enterprise, the user is counted once for each role. For example, if the same user is a member of three organizations and an owner of two organizations, the user counts once towards "Organization member" and once towards "Organization owner."
An "outside collaborator" is a user who has access to a repository in an organization, but is not a member of the organization. The user might be an outside collaborator in one organization in your enterprise and a member of another organization. In this case, the user counts towards each total. For more information, see "AUTOTITLE."
If your enterprise uses {% ifversion ghec %}{% data variables.enterprise.prodname_managed_users %}{% else %}SCIM provisioning{% endif %}, an "unaffiliated" user is someone who been provisioned with a user account, but is not a member of any of your organizations.
{% ifversion ghec %}
The "User licenses consumed" column shows you how licenses are consumed in your enterprise. For more information, see "AUTOTITLE."
If there are outside collaborators in your enterprise, the "total consumed" number of licenses may be larger than the number of people listed for your enterprise. An outside collaborator consumes a license, but is not counted in the total member count displayed next to "people in YOUR-ENTERPRISE". A pending invitation to an outside collaborator also consumes a license, but is not counted in the "By invitations" count in the overview.
For more information about how license usage is calculated across deployments, see "AUTOTITLE."
The "Deployment" column groups users by the type of deployment they are using. For more information, see "AUTOTITLE."
"Cloud members" are a member or owner of any organization in your enterprise on {% data variables.product.prodname_ghe_cloud %}. "Server members" have an account on a {% data variables.product.prodname_ghe_server %} instance owned by your enterprise. "Members on cloud and server" are users who match both these criteria. {% endif %}
{% endif %}
{% ifversion ghec %}
You may be able to view the email addresses for members of your enterprise on either {% data variables.product.github %} or an external identity system. The visibility of the email addresses depends on your enterprise's authentication method, domains, and potentially the member's user profile configuration.
-
If you use {% data variables.product.prodname_emus %} and the
NameID
for your SAML configuration is an email address, you can view theNameID
for each of your enterprise members. -
If you verify a domain for your enterprise, you can view members' email addresses for the verified domain. For more information, see "AUTOTITLE."
-
If you don't use {% data variables.product.prodname_emus %}, and you also don't configure SAML single sign-on (SSO), members access your enterprise's resources on {% data variables.product.github %} solely using a personal account. {% data reusables.saml.personal-accounts-determine-email-visibility %}
If you use {% data variables.product.prodname_emus %}, verify a domain, or configure SAML SSO for your enterprise, you may be able to view the email addresses in one or more of the following ways.
-
On your SAML Identity Provider (IdP), review the email addresses of users with access to {% data variables.product.product_name %}. For more information, see "AUTOTITLE."
-
Export the membership report for your enterprise on {% data variables.product.prodname_dotcom %}. The report may contain the user's email address, stored as the following values.
GitHub com saml name
: TheNameID
from the user's linked SAML identity, which is typically the user's email address (for more information, see "AUTOTITLE")GitHub com verified domain emails
: Email addresses for any verified domains (for more information, see "AUTOTITLE")
For more information, see "AUTOTITLE." {% data reusables.saml.use-api-to-get-externalidentity %}
{% endif %}
{% ifversion enterprise-membership-view-improvements %}
You can see all the current outside collaborators for your enterprise. You can see useful information about each collaborator and filter the list in useful ways, such as by organization. You can find a specific collaborator by searching for their username or display name.
You can view more information about the person's access to your enterprise, such as a list of all the repositories the collaborator has access to, by clicking on the person's name.
{% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.people-tab %}
- Under "People", click Outside collaborators. {% endif %}
{% ifversion ghec %}
You can see all the pending invitations to become members, administrators, or outside collaborators in your enterprise. You can filter the list in useful ways, such as by license, by organization, or by source. You can find a specific person by searching for their username or display name.
In the list of pending members, for any individual account, you can cancel all invitations to join organizations owned by your enterprise. This does not cancel any invitations for that same person to become an enterprise administrator or outside collaborator.
Note
If an invitation was provisioned via SCIM, you must cancel the invitation via your identity provider (IdP) instead of on {% data variables.product.prodname_dotcom %}.
If you use {% data variables.visual_studio.prodname_vss_ghe %}, the list of pending invitations includes all {% data variables.product.prodname_vs %} subscribers that haven't joined any of your organizations on {% data variables.product.prodname_dotcom %}, even if the subscriber does not have a pending invitation to join an organization. For more information about how to get {% data variables.product.prodname_vs %} subscribers access to {% data variables.product.prodname_enterprise %}, see "AUTOTITLE."
{% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.people-tab %}
-
Under "People", click Invitations.
-
Optionally, you can cancel all invitations for an account to join organizations owned by your enterprise. To the right of the account, click {% octicon "kebab-horizontal" aria-label="Show actions" %}, then click Cancel invitation.
-
Optionally, you can view pending invitations for enterprise administrators or outside collaborators. Under "Invitations", click Administrators or Outside collaborators.
-
Optionally, to filter the list of pending invitations by license, by organization, or by source, use the dropdown menus at the top of the list.
{% endif %}
If your enterprise uses {% ifversion ghec %}{% data variables.product.prodname_emus %}{% else %}SCIM provisioning{% endif %}, you can view suspended users. Suspended users are members who have been deprovisioned after being unassigned from the application or deleted on the identity provider.
{% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.people-tab %}
- Under "People", click Suspended.
You can view a list of all dormant users {% ifversion ghes %} who have not been suspended and {% endif %}who are not site administrators. {% data reusables.enterprise-accounts.dormant-user-activity-threshold %} For more information, see "AUTOTITLE."
{% ifversion filter-by-enterprise-member-type %}
Filtering by member type{% ifversion ghec %} in an {% data variables.enterprise.prodname_emu_enterprise %}{% endif %}
{% ifversion ghec %}If your enterprise uses {% data variables.product.prodname_emus %}, you{% elsif ghes %}You{% endif %} can filter the member list of an organization by type to determine if memberships are managed through an IdP or managed directly. Memberships managed through an IdP were added through an IdP group, and the IdP group was connected to a team within the organization. Memberships managed directly were added to the organization manually. The way a membership is managed in an organization determines how it must be removed. You can use this filter to determine how members were added to an organization, so you know how to remove them.{% ifversion ghec %} For more information, see "AUTOTITLE."{% endif %}
{% data reusables.enterprise-accounts.access-enterprise %}
-
Under "Organizations", in the search bar, begin typing the organization's name until it appears in the search results.
-
Click the name of the organization.
-
Above the organization name, click {% octicon "person" aria-hidden="true" %} People.
-
Above the list of members, click Type, then select the type of members you want to view.
{% endif %}
{% ifversion scim-for-ghes-public-beta %}
If you use SAML authentication and SCIM provisioning, you can filter members based on how they authenticate and how their account was created.
{% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.people-tab %}
-
Select Account Type, then choose from the following options.
- Built-in: Users with local accounts on {% data variables.location.product_location %} who authenticate with a username and password.
- SAML linked: Users who authenticate with SAML via an identity provider, but were not provisioned by SCIM.
- SAML and SCIM linked: Users who authenticate with SAML via an identity provider, and were provisioned by SCIM.
{% endif %}
{% ifversion ghec or ghes %}
You can view a list of members in your enterprise who don't have an email address from a verified domain associated with their user account.
{% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.settings-tab %} {% data reusables.enterprise-accounts.verified-domains-tab %}
- Under "Notification preferences", click the {% octicon "eye" aria-hidden="true" %} View enterprise members without an approved or verified domain email link. {% endif %}
{% ifversion fpt or ghec %}
You can see which people in your enterprise have enabled two-factor authentication.
{% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.people-tab %}
-
To view the two-factor authentication security levels of enterprise members, on the right, select Two-factor authentication, then click Secure, Insecure, or Disabled.
{% else %}
You can see which people in your enterprise have enabled two-factor authentication{% ifversion mandatory-2fa-required-overview %} or are required to do so{% endif %}.
{% ifversion mandatory-2fa-required-overview %} {% data reusables.two_fa.mandatory-2fa-contributors-2023 %} {% endif %}
{% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.people-tab %}
-
To view enterprise members who have enabled or disabled two-factor authentication, on the right, select 2FA, then click Enabled or Disabled.
{% endif %}