Add Asgardeo docs for enhanced organization authentication

en/asgardeo/docs/guides/organization-management/organization-discovery/organization-discovery.md

@@ -1,4 +1,4 @@
 {% set host_name = "api.asgardeo.io" %}
 {% set organization_path_param = "/t/<root_organization_name>"  %}
 
-{% include "../../../../../includes/guides/organization-management/organization-discovery/index.md" %}
+{% include "../../../../../includes/guides/organization-management/organization-discovery/organization-discovery-enhanced-flow.md" %}

en/asgardeo/docs/guides/organization-management/organization-login/legacy-approach.md

@@ -0,0 +1,4 @@
+{% set host_name = "api.asgardeo.io" %}
+{% set organization_path_param = ""  %}
+
+{% include "../../../../../includes/guides/organization-management/organization-login/legacy-approach.md" %}

en/asgardeo/docs/guides/organization-management/organization-login/migrate-to-enhanced-approach.md

@@ -0,0 +1,4 @@
+{% set host_name = "api.asgardeo.io" %}
+{% set organization_path_param = ""  %}
+
+{% include "../../../../../includes/guides/organization-management/organization-login/migrate-organization-login.md" %}

en/asgardeo/docs/guides/organization-management/organization-login/organization-login-overview.md

@@ -0,0 +1,4 @@
+{% set host_name = "api.asgardeo.io" %}
+{% set organization_path_param = ""  %}
+
+{% include "../../../../../includes/guides/organization-management/organization-login/organization-login-overview.md" %}

en/asgardeo/docs/guides/organization-management/organization-login/organization-login-with-app-native-authentication.md

@@ -0,0 +1,4 @@
+{% set host_name = "api.asgardeo.io" %}
+{% set organization_path_param = ""  %}
+
+{% include "../../../../../includes/guides/organization-management/organization-login/organization-login-with-app-native-authentication.md" %}

en/asgardeo/mkdocs.yml

@@ -546,6 +546,15 @@ nav:
             - OIDC scopes: guides/organization-management/inheritance-in-organizations/oidc-scope-inheritance.md
             - Flows: guides/organization-management/inheritance-in-organizations/flow-inheritance.md
           - Extend with service extensions: guides/organization-management/service-extensions/service-extensions.md
+        - Organization-based login:
+          - Overview: guides/organization-management/organization-login/organization-login-overview.md
+          - Organization discovery:
+            - Discover organizations during login: guides/organization-management/organization-discovery/organization-discovery.md
+            - Email domain-based organization discovery: guides/organization-management/organization-discovery/email-domain-based-organization-discovery.md
+          - Organization login with app-native authentication: guides/organization-management/organization-login/organization-login-with-app-native-authentication.md
+          - Legacy approach:
+            - Overview: guides/organization-management/organization-login/legacy-approach.md
+            - Migrate applications to enhanced approach: guides/organization-management/organization-login/migrate-to-enhanced-approach.md
         - Offboard organizations:
           - Disable or delete an organization: guides/organization-management/disable-delete-organizations.md
         - Try a B2B use case: guides/organization-management/try-a-b2b-use-case.md

en/includes/guides/organization-management/organization-discovery/organization-discovery-enhanced-flow.md

@@ -13,15 +13,29 @@
 
 After the user clicks **Sign in with SSO**, they are redirected to the organization discovery page where they identify their organization.
 
+{% if product_name == "Asgardeo" %}
+By default, users are prompted to enter the **organization name**.
+
+![Organization discovery page - org name]({{base_path}}/assets/img/guides/organization/organization-login/discovery-page-org-name.png){: width="400" style="display: block; margin: 0; border: 0.3px solid lightgrey;"}
+{% else %}
 By default, users are prompted to enter the **organization handle** — a human-readable, unique identifier for the organization.
 
 ![Organization discovery page - org handle]({{base_path}}/assets/img/guides/organization/organization-login/discovery-page-org-handle.png){: width="400" style="display: block; margin: 0; border: 0.3px solid lightgrey;"}
+{% endif %}
 
 ### Available discovery types
 
 {{ product_name }} supports the following discovery types:
 
-{% if product_name == "WSO2 Identity Server" and is_version > "7.1.0" %}
+{% if product_name == "Asgardeo" %}
+
+| Discovery Type                    | Use Case                                                  |
+|-----------------------------------|-----------------------------------------------------------|
+| **Organization Name-Based**       | Route users using the organization name. |
+| **Organization ID-Based**         | Route users using the organization ID. Suitable for server-side integrations. |
+| **Email Domain-Based**            | Automatically identify organizations from email domains. Ideal for corporate email addresses. |
+
+{% elif product_name == "WSO2 Identity Server" and is_version > "7.1.0" %}
 
 | Discovery Type                    | Use Case                                                  |
 |-----------------------------------|-----------------------------------------------------------|
@@ -35,7 +49,8 @@
 
 ---
 
+{% if product_name == "WSO2 Identity Server" %}
 ## Configure default parameter for organization discovery
 
 You can set the default discovery parameter for organization discovery across your server or for your root organization. This configuration determines which parameter users provide during SSO login. It affects the user experience.
 
@@ -98,12 +113,14 @@
 
 ![Email input for Single Sign-On (SSO) login]({{base_path}}/assets/img/guides/organization/manage-organizations/email-input-for-sso-login.png){: width="400" style="display: block; margin: 0; border: 0.3px solid lightgrey;"}
 
+{% endif %}
 ---
 
 ## Directly access the organization
 
 To route users directly to their organization's login page without showing the discovery page, include an organization discovery parameter in the initial authentication request. {{ product_name }} resolves the organization from the parameter and routes the user to that organization's login page automatically.
 
+{% if product_name != "Asgardeo" %}
 === "Organization Handle"
 
     Add `orgHandle=<organization_handle>` to the authentication request.
@@ -129,6 +146,7 @@
 
     **Example**: For an organization with handle `"abc.com"`, add `orgHandle=abc.com` to the request.
 
+{% endif %}
 === "Organization Name"
 
     Add `org=<organization_name>` to the authentication request.

en/includes/guides/organization-management/organization-login/organization-login-overview.md

@@ -43,7 +43,11 @@ Send the authentication request to the root organization's endpoint. {{ product_
     ```
 
 !!! tip
+    {% if product_name == "Asgardeo" %}
+    You can route users directly to their organization by including an organization discovery parameter in the request — such as `org` (organization name), `orgId` (organization ID), or an email domain hint. See [Organization discovery]({{base_path}}/guides/organization-management/organization-discovery/organization-discovery/).
+    {% else %}
     You can route users directly to their organization by including an organization discovery parameter in the request — such as `orgHandle`, `org` (organization name), `orgId` (organization ID), or an email domain hint. See [Organization discovery]({{base_path}}/guides/organization-management/organization-discovery/organization-discovery/).
+    {% endif %}
 
 ### Method 2: Start from the direct organization path