Skip to content

Commit cc43b98

Browse files
Merge pull request #250879 from omondiatieno/migrate-okta
migrate from Okta - UI updates
2 parents 188cb84 + 95cc41f commit cc43b98

File tree

1 file changed

+15
-9
lines changed

1 file changed

+15
-9
lines changed

articles/active-directory/manage-apps/migrate-applications-from-okta.md

Lines changed: 15 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -18,6 +18,14 @@ ms.custom: not-enterprise-apps
1818

1919
In this tutorial, you'll learn how to migrate your applications from Okta to Azure Active Directory (Azure AD).
2020

21+
## Prerequisites
22+
23+
To manage the application in Azure AD, you need:
24+
25+
- An Azure AD user account. If you don't already have one, you can [Create an account for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F).
26+
- One of the following roles: Global Administrator, Cloud Application Administrator, Application Administrator, or owner of the service principal.
27+
28+
2129
## Create an inventory of current Okta applications
2230

2331
Before migration, document the current environment and application settings. You can use the Okta API to collect this information. Use an API explorer tool such as [Postman](https://www.postman.com/).
@@ -84,11 +92,8 @@ We recommend you copy and convert this JSON list to a CSV format:
8492

8593
To migrate a SAML 2.0 application to Azure AD, configure the application in your Azure AD tenant for application access. In this example, we convert a Salesforce instance.
8694

87-
1. To configure the applications, follow the tutorial [Azure Active Directory single sign-on (SSO) integration with Salesforce](../saas-apps/salesforce-tutorial.md).
88-
89-
To complete the migration, repeat the configuration for all applications in the Okta tenant.
90-
91-
2. In the [Azure portal](https://portal.azure.com), select **Azure Active Directory** > **Enterprise applications** > **+ New application**.
95+
1. Sign in to the [Microsoft Entra admin center](https://entra.microsoft.com) as at least a [Cloud Application Administrator](../roles/permissions-reference.md#cloud-application-administrator).
96+
2. Browse to **Identity** > **Applications** > **Enterprise applications** > **All applications**, then select **New application**.
9297

9398
![Screenshot of the New Application option on All applications.](media/migrate-applications-from-okta/list-of-new-applications.png)
9499

@@ -108,7 +113,7 @@ To complete the migration, repeat the configuration for all applications in the
108113

109114
![Screenshot of the New from Metadata File option under Single Sign On Settings.](media/migrate-applications-from-okta/salesforce-admin-console.png)
110115

111-
7. Upload the XML file you downloaded from the Azure portal. Then select **Create**.
116+
7. Upload the XML file you downloaded from the Microsoft Entra admin center. Then select **Create**.
112117
8. Upload the certificate you downloaded from Azure. Select **Save**.
113118

114119
![Screenshot of the Identity Provider Certificate entry under SAML Single Sign On.](media/migrate-applications-from-okta/create-saml-provider.png)
@@ -123,7 +128,7 @@ To complete the migration, repeat the configuration for all applications in the
123128

124129
![Screenshot of the Download Metadata option, also entries for Entity ID and Your Organization.](media/migrate-applications-from-okta/record-values-for-azure.png)
125130

126-
11. To upload the file to the Azure portal, in the Azure AD **Enterprise applications** page, in the SAML SSO settings, select **Upload metadata file**.
131+
11. To upload the file to the Microsoft Entra admin center, in the Azure AD **Enterprise applications** page, in the SAML SSO settings, select **Upload metadata file**.
127132
12. Ensure the imported values match the recorded values. Select **Save**.
128133

129134
![Screenshot of entries for SAML-based sign-on, and Basic SAML Configuration.](media/migrate-applications-from-okta/upload-metadata-file.png)
@@ -170,8 +175,9 @@ To migrate an OpenID Connect (OIDC) or OAuth 2.0 application to Azure AD, in you
170175

171176
To complete the migration, repeat configuration for all applications in the Okta tenant.
172177

173-
1. Sign in to the [Azure portal](https://portal.azure.com), then select **Azure Active Directory** > **Enterprise applications**.
174-
2. Under **All applications**, select **New application**.
178+
1. Sign in to the [Microsoft Entra admin center](https://entra.microsoft.com) as at least a [Cloud Application Administrator](../roles/permissions-reference.md#cloud-application-administrator).
179+
1. Browse to **Identity** > **Applications** > **Enterprise applications** > **All applications**.
180+
2. Select **New application**.
175181
3. Select **Create your own application**.
176182
4. On the menu that appears, name the OIDC app and then select **Register an application you're working on to integrate with Azure AD**.
177183
5. Select **Create**.

0 commit comments

Comments
 (0)