Merge pull request #9828 from MicrosoftDocs/main

Auto Publish – main to live - 2025-10-03 18:00 UTC

Author: learn-build-service-prod[bot]

support/azure/partner-solutions/astro/personal-email.md

@@ -0,0 +1,44 @@
+---
+title: Unable to Install Astro Using a Personal Email
+description: Discusses why installing Apache Airflow on Astro by using a personal email account isn't supported, and how to resolve the problem.
+author: ProfessorKendrick
+ms.author: jarrettr
+ms.reviewer: kkendrick, v-ryanberg
+ms.service: partner-services
+ms.topic: troubleshooting-problem-resolution
+ms.date: 09/04/2025
+ai-usage: ai-assisted
+
+#customer intent: As an Azure user, I want to understand why I can't install Astro by using a personal email account so that I can successfully deploy Apache Airflow.
+
+---
+
+# Can't install Astro using a personal email account
+
+You might experience errors if you try to install Apache Airflow on Astro from the Microsoft Azure Marketplace by using a personal email account. This article explains why the errors occur and how to resolve them.
+
+## Prerequisites
+
+- Access to the Azure portal
+- An email address that's associated with a unique domain (such as work or school)
+- Subscription owner permissions in Azure
+
+## Symptoms
+
+If you try to install Apache Airflow on Astro by using a personal email account (for example, Outlook, Gmail, or Yahoo), the installation fails. Additionally, you receive an error or warning message that states that the email domain is unsupported.
+
+## Cause
+
+Astro installation from the Azure Marketplace doesn't support personal email accounts from generic domains. The service requires an email address that has a unique domain that's typically associated with an organization, school, or business.
+
+## Solution
+
+To resolve this problem, follow these steps:
+
+1. Use an email address that has a unique domain (for example, your organization's email domain).
+2. Create a new user in Azure that has a unique domain, and assign subscription owner permissions to that user.
+3. Retry the Astro installation from the Azure Marketplace.
+
+[!INCLUDE [Third-party contact disclaimer](../../../includes/third-party-contact-disclaimer.md)]
+
+[!INCLUDE [Azure Help Support](../../../includes/azure-help-support.md)]

support/azure/partner-solutions/astro/resource-creation.md

@@ -0,0 +1,56 @@
+---
+title: Troubleshoot Astro Resource Creation in Azure
+description: Learn how to resolve issues when creating Astro resources in Azure, including permission and user profile requirements.
+author: ProfessorKendrick
+ms.author: jarrettr
+ms.reviewer: kkendrick, v-ryanberg
+ms.service: partner-services
+ms.topic: troubleshooting-problem-resolution
+ms.date: 09/04/2025
+ai-usage: ai-assisted
+
+#customer intent: As an Azure administrator or user, I want to resolve issues when I create Astro resources so that I can successfully set up Astro integration.
+---
+
+# Can't create Astro resources in Azure
+
+This article helps you resolve common issues that you might encounter when you try to create Astro resources in Microsoft Azure. These issues include permission errors and missing user profile information.
+
+## Prerequisites
+
+- You must have `Owner` access on the Azure subscription to set up Astro integration.
+- Your user profile in Azure must contain all required business information.
+
+## Symptoms
+
+- When you try to create an Astro resource, you receive an error message that states that you're not a subscription owner.
+- You can't create an Astro resource because of missing details in your user profile.
+
+## Cause 1: Not a subscription owner
+
+Only users who have `Owner` access on the Azure subscription can set up the Astro integration.
+
+### Solution 1
+
+1. Verify your access level on the Azure subscription.
+2. If you don't have `Owner` access, ask your Azure administrator to grant you the required permissions before you start the integration setup.
+
+## Cause 2: Missing details in user profile
+
+Your user profile has to be updated to include key business information for Astro resource creation.
+
+### Solution 2
+
+1. In the Azure portal, select **Users**, and complete the required details.
+2. In the user information screen, search for your username.
+3. Edit **UserInformation** to complete all required fields.
+
+## Additional troubleshooting
+
+- If the deployment process takes more than three hours to complete, contact support.
+- If the deployment fails and the Astro resource has a status of `Failed`, delete the resource. Then, try again to create the resource.
+- If you receive a "DeploymentFailed" error message, check the status of your Azure subscription. Make sure that it isn't suspended and has no billing issues.
+
+[!INCLUDE [Third-party contact disclaimer](../../../includes/third-party-contact-disclaimer.md)]
+
+[!INCLUDE [Azure Help Support](../../../includes/azure-help-support.md)]

support/azure/partner-solutions/astro/single-sign-on.md

@@ -0,0 +1,44 @@
+---
+title: Unable to use single sign-on in Astronomer portal
+description: Troubleshoot issues with single sign-on (SSO) for the Astronomer portal in Azure, including consent and email requirements.
+author: ProfessorKendrick
+ms.author: jarrettr
+ms.reviewer: kkendrick, v-ryanberg
+ms.service: partner-services
+ms.topic: troubleshooting-problem-resolution 
+ms.date: 09/04/2025
+ai-usage: ai-assisted
+
+#customer intent: As an Azure administrator, I want to resolve SSO issues in Astronomer so that users can access the portal securely.
+
+---
+
+# Can't use single sign-on in Astronomer portal
+
+This article helps you to troubleshoot and resolve issues that affect single sign-on (SSO) when you access the Astronomer portal in Microsoft Azure. If SSO isn't working, follow these steps to identify and fix common problems that are related to email, consent, and tenant settings.
+
+## Prerequisites
+
+- Access to the Azure subscription and Astronomer portal
+- Microsoft Entra account credentials
+- Administrator permissions to review tenant consent settings
+
+## Symptoms
+
+- You can't sign in to the Astronomer portal by using SSO.
+- You're prompted for both **Admin** and **User consent** during the initial sign-in process.
+- You receive error messages that are related to your email account or consent.
+
+## Cause
+
+SSO issues can occur if you use an incorrect email account, if you don't provide consent, or if your tenant settings prevent access.
+
+## Solution
+
+- Verify that you use the correct Microsoft Entra email account for SSO.
+- Make sure you consent to allow access for the Astronomer software-as-a-service (SaaS) portal.
+- If you see both **Admin** and **User consent** screens during the initial sign-in process, check your tenant consent settings.
+
+[!INCLUDE [Third-party contact disclaimer](../../../includes/third-party-contact-disclaimer.md)]
+
+[!INCLUDE [Azure Help Support](../../../includes/azure-help-support.md)]

support/azure/partner-solutions/index.yml

@@ -25,7 +25,19 @@ landingContent:
             url: marketplace-purchases-errors.md
 
 # Card
-  - title:  Informatica
+  - title: Astro 
+    linkLists:
+    - linkListType: how-to-guide
+      links:
+        - text: Can't create Astro resources in Azure  
+          url: astro/resource-creation.md
+        - text: Can't install Astro using a personal email
+          url: astro/personal-email.md
+        - text: Unable to use single sign-on in Astronomer portal
+          url: astro/single-sign-on.md
+
+# Card
+  - title: Informatica
     linkLists:
       - linkListType: how-to-guide
         links:

support/azure/partner-solutions/toc.yml

@@ -3,6 +3,14 @@ items:
   href: index.yml
 - name: Marketplace purchase errors
   href: marketplace-purchases-errors.md
+- name: Astro
+  items:
+    - name: Can't create Astro resources in Azure 
+      href: astro/resource-creation.md
+    - name: Can't install Astro using a personal email
+      href: astro/personal-email.md
+    - name: Unable to use single sign-on in Astronomer portal
+      href: astro/single-sign-on.md
 - name: Datadog
   items: 
     - name: Diagnostic settings manual update