Multi-account support for GitHub.com - [GA] (#45118)

Co-authored-by: github-actions <[email protected]>
Co-authored-by: Ben Ahmady <[email protected]>

Author: 3 people

assets/images/help/profile/switch-accounts.png

@@ -16,6 +16,12 @@ In some cases, you may need to use multiple accounts on {% data variables.locati
 
 You cannot use your {% data variables.enterprise.prodname_managed_user %} to contribute to public projects on {% data variables.location.product_location %}, so you must contribute to those resources using your personal account. For more information, see "[About  {% data variables.product.prodname_emus %}]({% ifversion fpt %}/enterprise-cloud@latest{% endif %}/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/about-enterprise-managed-users#abilities-and-restrictions-of-managed-user-accounts){% ifversion fpt %}" in the {% data variables.product.prodname_ghe_cloud %} documentation.{% elsif ghec %}."{% endif %}
 
+{% ifversion account-switcher %}
+
+If you need to use multiple accounts on {% data variables.location.product_location %}, you can stay signed in to your accounts and switch between them. For example, switching between a personal account and a service account. For more information, see "[AUTOTITLE](/authentication/keeping-your-account-and-data-secure/switching-between-accounts)."
+
+{% endif %}
+
 If you want to use one workstation to contribute from both accounts, you can simplify contribution with Git by using a mixture of protocols to access repository data, or by using credentials on a per-repository basis.
 
 {% warning %}

content/account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-your-personal-account/managing-multiple-accounts.md

@@ -150,3 +150,9 @@ The profile name and email address of a {% data variables.enterprise.prodname_ma
 People on your team may need to contribute to resources on {% data variables.location.product_location %} that are outside of your {% data variables.enterprise.prodname_emu_enterprise %}. For example, you may wish to maintain a separate enterprise for your company's open source projects. Because a {% data variables.enterprise.prodname_managed_user %} cannot contribute to public resources, users will need to maintain a separate, personal account for this work.
 
 People who must contribute from two user accounts on {% data variables.location.product_location %} using one workstation can configure Git to simplify the process. For more information, see "[AUTOTITLE](/account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-your-personal-account/managing-multiple-accounts)."
+
+{% ifversion account-switcher %}
+
+If there are people on your team who do need to regularly switch between accounts on {% data variables.location.product_location %}, such as their personal accounts and one or more {% data variables.enterprise.prodname_managed_users %}, it's possible to sign in to multiple accounts and quickly switch between them without always needing to reauthenticate. For more information, see "[AUTOTITLE](/authentication/keeping-your-account-and-data-secure/switching-between-accounts)."
+
+{% endif %}

content/admin/identity-and-access-management/understanding-iam-for-enterprises/about-enterprise-managed-users.md

@@ -49,6 +49,12 @@ You can authenticate to {% data variables.product.product_name %} in your browse
 {% data reusables.two_fa.mandatory-2fa-contributors-2023 %}
 {% endif %}
 
+{% ifversion account-switcher %}
+
+If you need to use multiple accounts on {% data variables.location.product_location %}, such as a personal account and a service account, you can quickly switch between your accounts without always needing to reauthenticate each time. For more information, see "[AUTOTITLE](/authentication/keeping-your-account-and-data-secure/switching-between-accounts)."
+
+{% endif %}
+
 - **Username and password only**
   - You'll create a password when you create your account on {% data variables.product.product_name %}. We recommend that you use a password manager to generate a random and unique password. For more information, see "[AUTOTITLE](/authentication/keeping-your-account-and-data-secure/creating-a-strong-password)."{% ifversion fpt or ghec %}
   - If you have not enabled 2FA, {% data variables.product.product_name %} will ask for additional verification when you first sign in from an unrecognized device, such as a new browser profile, a browser where the cookies have been deleted, or a new computer.

content/authentication/keeping-your-account-and-data-secure/about-authentication-to-github.md

@@ -15,6 +15,7 @@ topics:
 children:
   - /about-authentication-to-github
   - /creating-a-strong-password
+  - /switching-between-accounts
   - /updating-your-github-access-credentials
   - /managing-your-personal-access-tokens
   - /reviewing-your-ssh-keys
@@ -31,4 +32,3 @@ children:
   - /viewing-and-managing-your-sessions
 shortTitle: Account security
 ---
-

content/authentication/keeping-your-account-and-data-secure/index.md

@@ -0,0 +1,57 @@
+---
+title: 'Switching between accounts'
+intro: 'You can stay signed in to multiple {% data variables.product.prodname_dotcom_the_website %} accounts and {% data variables.enterprise.prodname_managed_users %} and quickly jump between sessions.'
+allowTitleToDifferFromFilename: true
+versions:
+  feature: account-switcher
+type: overview
+topics:
+  - Identity
+  - Access management
+---
+
+## About switching between your accounts
+
+If you need to use multiple accounts on {% data variables.product.prodname_dotcom_the_website %}, you can sign in to your accounts and switch between them  without always being required to reauthenticate. You can use the account switcher if you have a personal account and service accounts (sometimes called machine users) or if you need to switch between your personal account and {% data variables.enterprise.prodname_managed_users %} in an enterprise that uses {% data variables.product.prodname_emus %}.
+
+When you are signed in to multiple accounts and using the account switcher, those sessions remain on your computer or browser. If you access {% data variables.product.prodname_dotcom_the_website %} on another computer or browser, the same accounts will not be available until you add them.
+
+If you are signed in to multiple accounts and follow a link to {% data variables.product.product_name %} from an external source, such as a request to install or approve a {% data variables.product.prodname_github_app %}, you will first be prompted to choose which account you want to use.
+
+Your SSO sessions will persist when you switch away from an account and return, this means you will not always need to authenticate with your identity provider (IdP) each time you want to use your SSO-linked account. If you're a member of an enterprise that uses {% data variables.product.prodname_emus %} and add your {% data variables.enterprise.prodname_managed_user %} to the account switcher, the {% data variables.enterprise.prodname_managed_user %} will appear grayed out if your session has expired. Selecting the expired account will send you to reauthenticate with your IdP.
+
+## Adding an account to the account switcher
+
+When you add a new account to the account switcher, both the account you are currently signed in to and the account you have added will become available in the account switcher. You will be signed in to the new account immediately.
+
+1. In the upper-right corner of any page, click your profile photo to open the menu.
+1. If you have previously added an account to the account switcher, click {% octicon "arrow-switch" aria-hidden="true" %} **Switch account** to open the menu.
+1. In the menu, click {% octicon "person-add" aria-hidden="true" %} **Add account**.
+1. Sign in to the account you want to add to the account switcher.
+
+## Switching between accounts
+
+When you have added accounts to the account switcher, you can quickly change between them without always needing to reauthenticate.
+
+{% note %}
+
+**Note:** The "{% octicon "arrow-switch" aria-hidden="true" %} Switch account" option will not be available if all sessions have expired. You can instead click on {% octicon "arrow-switch" aria-hidden="true" %} **See all accounts** in the menu to reauthenticate.
+
+{% endnote %}
+
+1. In the upper-right corner of any page, click your profile photo to open the menu.
+1. In the menu, click {% octicon "arrow-switch" aria-hidden="true" %} **Switch account**.
+1. In the submenu, click on the account that you want to switch to.
+
+      ![Screenshot of the "Switch account" menu with three options, "octocat", "hubot", and "Add account".](/assets/images/help/profile/switch-accounts.png)
+
+## Removing accounts from the account switcher
+
+You can either remove individual accounts or all accounts from the account switcher.
+
+1. In the upper-right corner of any page, click your profile photo to open the menu.
+1. In the menu, click **Sign out**.
+1. Choose which accounts to sign out of and remove from the account switcher.
+    - To remove the account you are currently signed in to from the account switcher and sign out, click **Sign out** next to your username.
+    - To sign out from and remove an account from the account switcher, click **Remove** next to the username you want to remove.
+    - To sign out from all accounts, and remove all accounts from the account switcher, click **Sign out from all accounts**.

content/authentication/keeping-your-account-and-data-secure/switching-between-accounts.md

@@ -0,0 +1,5 @@
+# Issue 10904
+# Ability to switch between accounts
+versions:
+  fpt: '*'
+  ghec: '*'