From a0b9021136707ae095f3e1e0f681daf075d4734b Mon Sep 17 00:00:00 2001 From: Ayush More Date: Tue, 15 Jul 2025 05:56:03 +0530 Subject: [PATCH 1/4] docs(identity): Document behavior of linking social sign-ins #235 This PR adds documentation under `identity/` explaining the behavior of linking multiple social sign-in accounts in Layer5 Cloud. Signed-off-by: Ayush More --- .../getting-started/social-signin-behavior.md | 28 +++++++++++++++++++ 1 file changed, 28 insertions(+) create mode 100644 content/en/cloud/getting-started/social-signin-behavior.md diff --git a/content/en/cloud/getting-started/social-signin-behavior.md b/content/en/cloud/getting-started/social-signin-behavior.md new file mode 100644 index 000000000..61e0cb1a4 --- /dev/null +++ b/content/en/cloud/getting-started/social-signin-behavior.md @@ -0,0 +1,28 @@ +--- +title: Behavior of Linking Social Sign-ins +description: Explains how Layer5 Cloud handles linking multiple social sign-in accounts. +--- + +# Behavior of Linking Social Sign-ins + +Layer5 Cloud allows users to authenticate using third-party providers such as Google and GitHub. This document outlines the expected behavior when linking multiple accounts. + +## Linking Two Accounts with Existing Designs + +If both accounts have existing Meshery Designs: + +- **Designs from both accounts are retained.** +- The currently signed-in account becomes the **primary account**. +- Designs from the linked (secondary) account are **migrated** and merged into the primary account's dashboard. +- If designs have identical names, unique suffixes (e.g., timestamps) are appended to avoid name collisions. +- **No design data is lost** in the process. + +## Linking Multiple Social Accounts of the Same Type + +- Layer5 Cloud currently **does not support linking multiple accounts of the same provider type**. +- For instance, you **cannot link two different Google accounts** to the same Layer5 Cloud account. +- Attempting to link a second account of the same provider will prompt a **confirmation to replace** the existing linked account. + +--- + +For managing your linked accounts, navigate to [Account Settings](https://cloud.layer5.io/account/settings). From d7d5d9656fb2bf7e324529b48a8f73c69d051c16 Mon Sep 17 00:00:00 2001 From: Ayush More Date: Thu, 17 Jul 2025 05:48:48 +0530 Subject: [PATCH 2/4] Update _index.md Signed-off-by: Ayush More --- content/en/cloud/identity/users/_index.md | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/content/en/cloud/identity/users/_index.md b/content/en/cloud/identity/users/_index.md index 8beb706e0..316896c78 100755 --- a/content/en/cloud/identity/users/_index.md +++ b/content/en/cloud/identity/users/_index.md @@ -104,3 +104,19 @@ While account deletion is permanent for end-users, future versions of Layer5 Clo {{< /alert >}} +### Behavior When Linking Multiple Accounts + +If you link two Layer5 accounts that both have existing designs or resources: + +- You will be prompted to choose a **primary account** to retain. +- Designs from the secondary account **are not merged automatically**. +- You should manually export or migrate any designs you want to retain from the secondary account before completing the linking process. +- In future releases, Layer5 Cloud will introduce tools to assist in migrating and merging designs during linking. + +### Linking Multiple Social Sign-In Accounts of the Same Type + +Currently, Layer5 Cloud **does not support linking multiple accounts of the same provider type** (e.g., multiple Google or GitHub accounts) to a single Layer5 account. + +- Each Layer5 account can be linked to **only one account per provider type**. +- Attempting to link another account of the same provider will result in an error or prompt to replace the existing one. +- Support for multiple accounts of the same provider may be considered in future versions. From 97aae9516221aa5ccfdef0b17f9f06283ba0e0bd Mon Sep 17 00:00:00 2001 From: Ayush More Date: Thu, 17 Jul 2025 05:49:34 +0530 Subject: [PATCH 3/4] Delete content/en/cloud/getting-started/social-signin-behavior.md Signed-off-by: Ayush More --- .../getting-started/social-signin-behavior.md | 28 ------------------- 1 file changed, 28 deletions(-) delete mode 100644 content/en/cloud/getting-started/social-signin-behavior.md diff --git a/content/en/cloud/getting-started/social-signin-behavior.md b/content/en/cloud/getting-started/social-signin-behavior.md deleted file mode 100644 index 61e0cb1a4..000000000 --- a/content/en/cloud/getting-started/social-signin-behavior.md +++ /dev/null @@ -1,28 +0,0 @@ ---- -title: Behavior of Linking Social Sign-ins -description: Explains how Layer5 Cloud handles linking multiple social sign-in accounts. ---- - -# Behavior of Linking Social Sign-ins - -Layer5 Cloud allows users to authenticate using third-party providers such as Google and GitHub. This document outlines the expected behavior when linking multiple accounts. - -## Linking Two Accounts with Existing Designs - -If both accounts have existing Meshery Designs: - -- **Designs from both accounts are retained.** -- The currently signed-in account becomes the **primary account**. -- Designs from the linked (secondary) account are **migrated** and merged into the primary account's dashboard. -- If designs have identical names, unique suffixes (e.g., timestamps) are appended to avoid name collisions. -- **No design data is lost** in the process. - -## Linking Multiple Social Accounts of the Same Type - -- Layer5 Cloud currently **does not support linking multiple accounts of the same provider type**. -- For instance, you **cannot link two different Google accounts** to the same Layer5 Cloud account. -- Attempting to link a second account of the same provider will prompt a **confirmation to replace** the existing linked account. - ---- - -For managing your linked accounts, navigate to [Account Settings](https://cloud.layer5.io/account/settings). From 12aaa784452f2c61eca7f8a0c9b20ee790f1e16f Mon Sep 17 00:00:00 2001 From: Ayush More Date: Thu, 17 Jul 2025 18:38:38 +0530 Subject: [PATCH 4/4] Fix Signed-off-by: Ayush More --- content/en/cloud/identity/users/_index.md | 23 ++++++++++++----------- 1 file changed, 12 insertions(+), 11 deletions(-) diff --git a/content/en/cloud/identity/users/_index.md b/content/en/cloud/identity/users/_index.md index 316896c78..31a970868 100755 --- a/content/en/cloud/identity/users/_index.md +++ b/content/en/cloud/identity/users/_index.md @@ -104,19 +104,20 @@ While account deletion is permanent for end-users, future versions of Layer5 Clo {{< /alert >}} -### Behavior When Linking Multiple Accounts +## What Happens When You Link Two Layer5 Accounts? -If you link two Layer5 accounts that both have existing designs or resources: +If you're linking two separate Layer5 accounts that both have existing data (like designs or configurations), the platform will ask you to make a choice. -- You will be prompted to choose a **primary account** to retain. -- Designs from the secondary account **are not merged automatically**. -- You should manually export or migrate any designs you want to retain from the secondary account before completing the linking process. -- In future releases, Layer5 Cloud will introduce tools to assist in migrating and merging designs during linking. +You'll need to pick one to be your **primary account**. Think of this as the main account you want to keep everything from. The other account will be treated as the secondary one. -### Linking Multiple Social Sign-In Accounts of the Same Type +> **Heads up: Your data won't merge automatically!** +> +> Designs and other resources from the secondary account **are not** automatically moved over to your primary account. To avoid losing any work, you should manually export anything you want to save from the secondary account **before** you finish linking them. -Currently, Layer5 Cloud **does not support linking multiple accounts of the same provider type** (e.g., multiple Google or GitHub accounts) to a single Layer5 account. +We're working on tools to make this process smoother in a future release, including ways to help migrate and merge your designs. -- Each Layer5 account can be linked to **only one account per provider type**. -- Attempting to link another account of the same provider will result in an error or prompt to replace the existing one. -- Support for multiple accounts of the same provider may be considered in future versions. +## A Quick Note on Social Logins + +Keep in mind that you can currently link **only one account from each social provider**. + +For example, you can connect one Google account and one GitHub account to your Layer5 profile. However, you **cannot** link two different Google accounts to that same Layer5 profile. Attempting to do so will cause an error. We may add support for multiple accounts from the same provider down the road.