You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/active-directory/manage-apps/migrate-application-authentication-to-azure-active-directory.md
+21-21Lines changed: 21 additions & 21 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -53,7 +53,7 @@ Moving app authentication to Azure AD helps you manage risk and cost, increase p
53
53
54
54
### Increase your security posture
55
55
56
-
Securing your apps requires that you have a full view of all the risk factors. Migrating your apps to Azure AD consolidates your security solutions. With it you can:
56
+
Securing your apps requires that you've a full view of all the risk factors. Migrating your apps to Azure AD consolidates your security solutions. With it you can:
57
57
58
58
- Improve secure user access to applications and associated corporate data using [Conditional Access policies](../conditional-access/overview.md), [Multi-Factor Authentication](../authentication/concept-mfa-howitworks.md), and real-time risk-based [Identity Protection](../identity-protection/overview-identity-protection.md) technologies.
59
59
- Protect privileged user’s access to your environment with [Just-In-Time](../../azure-resource-manager/managed-applications/request-just-in-time-access.md) admin access.
@@ -103,7 +103,7 @@ Before we get into the tools, you should understand how to think through the mig
103
103
104
104
### Assemble the project team
105
105
106
-
Application migration is a team effort, and you need to ensure that you have all the vital positions filled. Support from senior business leaders is important. Ensure that you involve the right set of executive sponsors, business decision-makers, and subject matter experts (SMEs.)
106
+
Application migration is a team effort, and you need to ensure that you've all the vital positions filled. Support from senior business leaders is important. Ensure that you involve the right set of executive sponsors, business decision-makers, and subject matter experts (SMEs.)
107
107
108
108
During the migration project, one person may fulfill multiple roles, or multiple people fulfill each role, depending on your organization’s size and structure. You may also have a dependency on other teams that play a key role in your security landscape.
109
109
@@ -124,7 +124,7 @@ The following table includes the key roles and their contributions:
124
124
125
125
Effective business engagement and communication are the keys to success. It's important to give stakeholders and end-users an avenue to get information and keep informed of schedule updates. Educate everyone about the value of the migration, what the expected timelines are, and how to plan for any temporary business disruption. Use multiple avenues such as briefing sessions, emails, one-to-one meetings, banners, and townhalls.
126
126
127
-
Based on the communication strategy that you have chosen for the app you may want to remind users of the pending downtime. You should also verify that there are no recent changes or business impacts that would require to postpone the deployment.
127
+
Based on the communication strategy that you've chosen for the app you may want to remind users of the pending downtime. You should also verify that there are no recent changes or business impacts that would require to postpone the deployment.
128
128
129
129
In the following table, you find the minimum suggested communication to keep your stakeholders informed:
130
130
@@ -195,7 +195,7 @@ The first decision point in an application migration is which apps to migrate, w
195
195
196
196
Discover applications using ADFS:
197
197
198
-
-**Use Azure AD Connect Health for ADFS**: If you have an Azure AD Premium license, we recommend deploying [Azure AD Connect Health](../hybrid/how-to-connect-health-adfs.md) to analyze the app usage in your on-premises environment. You can use the [ADFS application report](./migrate-adfs-application-activity.md) to discover ADFS applications that can be migrated and evaluate the readiness of the application to be migrated.
198
+
-**Use Azure AD Connect Health for ADFS**: If you've an Azure AD Premium license, we recommend deploying [Azure AD Connect Health](../hybrid/how-to-connect-health-adfs.md) to analyze the app usage in your on-premises environment. You can use the [ADFS application report](./migrate-adfs-application-activity.md) to discover ADFS applications that can be migrated and evaluate the readiness of the application to be migrated.
199
199
200
200
- If you don’t have Azure AD Premium licenses, we recommend using the ADFS to Azure AD app migration tools based on [PowerShell](https://github.com/AzureAD/Deployment-Plans/tree/master/ADFS%20to%20AzureAD%20App%20Migration). Refer to [solution guide](./migrate-adfs-apps-to-azure.md):
201
201
@@ -220,12 +220,12 @@ In the cloud environment, you need rich visibility, control over data travel, an
220
220
221
221
### Manual discovery process
222
222
223
-
Once you have taken the automated approaches described in this article, you have a good handle on your applications. However, you might consider doing the following to ensure you have good coverage across all user access areas:
223
+
Once you've taken the automated approaches described in this article, you've a good handle on your applications. However, you might consider doing the following to ensure you've good coverage across all user access areas:
224
224
225
225
- Contact the various business owners in your organization to find the applications in use in your organization.
226
226
- Run an HTTP inspection tool on your proxy server, or analyze proxy logs, to see where traffic is commonly routed.
227
227
- Review weblogs from popular company portal sites to see what links users access the most.
228
-
- Reach out to executives or other key business members to ensure that you have covered the business-critical apps.
228
+
- Reach out to executives or other key business members to ensure that you've covered the business-critical apps.
229
229
230
230
### Type of apps to migrate
231
231
@@ -254,7 +254,7 @@ For certain apps using legacy authentication protocols, sometimes modernizing th
254
254
255
255
- Apps kept on-premises for compliance or control reasons.
256
256
- Apps connected to an on-premises identity or federation provider that you do not want to change.
257
-
- Apps developed using on-premises authentication standards that you have no plans to move
257
+
- Apps developed using on-premises authentication standards that you've no plans to move
258
258
259
259
Azure AD can bring great benefits to these legacy apps, as you can enable modern Azure AD security and governance features like [Multi-Factor Authentication](../authentication/concept-mfa-howitworks.md), [Conditional Access](../conditional-access/overview.md), [Identity Protection](../identity-protection/index.yml), [Delegated Application Access](./access-panel-manage-self-service-access.md), and [Access Reviews](../governance/manage-user-access-with-access-reviews.md#create-and-perform-an-access-review) against these apps without touching the app at all!
260
260
@@ -263,7 +263,7 @@ Azure AD can bring great benefits to these legacy apps, as you can enable modern
263
263
264
264
### New Line of Business (LoB) apps
265
265
266
-
You usually develop LoB apps for your organization’s in-house use. If you have new apps in the pipeline, we recommend using the [Microsoft Identity Platform](../develop/v2-overview.md) to implement OIDC.
266
+
You usually develop LoB apps for your organization’s in-house use. If you've new apps in the pipeline, we recommend using the [Microsoft Identity Platform](../develop/v2-overview.md) to implement OIDC.
267
267
268
268
### Apps to deprecate
269
269
@@ -283,7 +283,7 @@ You are successful in this phase with:
283
283
284
284
## Phase 2: Classify apps and plan pilot
285
285
286
-
Classifying the migration of your apps is an important exercise. Not every app needs to be migrated and transitioned at the same time. Once you have collected information about each of the apps, you can rationalize which apps should be migrated first and which may take added time.
286
+
Classifying the migration of your apps is an important exercise. Not every app needs to be migrated and transitioned at the same time. Once you've collected information about each of the apps, you can rationalize which apps should be migrated first and which may take added time.
287
287
288
288
### Classify in-scope apps
289
289
@@ -301,19 +301,19 @@ Applications with **high usage numbers** should receive a higher value than apps
301
301
302
302

303
303
304
-
Once you have determined values for business criticality and usage, you can then determine the **application lifespan**, and create a matrix of priority. The diagram shows the matrix.
304
+
Once you've determined values for business criticality and usage, you can then determine the **application lifespan**, and create a matrix of priority. The diagram shows the matrix.
305
305
306
306

307
307
308
308
### Prioritize apps for migration
309
309
310
310
You can choose to begin the app migration with either the lowest priority apps or the highest priority apps based on your organization’s needs.
311
311
312
-
In a scenario where you may not have experience using Azure AD and Identity services, consider moving your **lowest priority apps** to Azure AD first. This minimizes your business impact, and you can build momentum. Once you have successfully moved these apps and have gained the stakeholder’s confidence, you can continue to migrate the other apps.
312
+
In a scenario where you may not have experience using Azure AD and Identity services, consider moving your **lowest priority apps** to Azure AD first. This minimizes your business impact, and you can build momentum. Once you've successfully moved these apps and have gained the stakeholder’s confidence, you can continue to migrate the other apps.
313
313
314
314
If there is no clear priority, you should consider moving the apps that are in the [Azure AD Gallery](https://azuremarketplace.microsoft.com/marketplace/apps/category/azure-active-directory-apps) first and support multiple identity providers because they are easier to integrate. It is likely that these apps are the **highest-priority apps** in your organization. To help integrate your SaaS applications with Azure AD, we have developed a collection of [tutorials](../saas-apps/tutorial-list.md) that walk you through configuration.
315
315
316
-
When you have a deadline to migrate the apps, these highest priority apps bucket takes the major workload. You can eventually select the lower priority apps as they won't change the cost even though you have moved the deadline.
316
+
When you've a deadline to migrate the apps, these highest priority apps bucket takes the major workload. You can eventually select the lower priority apps as they won't change the cost even though you've moved the deadline.
317
317
318
318
In addition to this classification and depending on the urgency of your migration, you should publish a **migration schedule** within which app owners must engage to have their apps migrated. At the end of this process, you should have a list of all applications in prioritized buckets for migration.
319
319
@@ -345,7 +345,7 @@ Other data that helps you later, but that you do not need to make an immediate m
345
345
-**App owner** – who in the business is the main POC for the app?
346
346
-**General comments or notes** – any other general information about the app or business ownership
347
347
348
-
Once you have classified your application and documented the details, then be sure to gain business owner buy-in to your planned migration strategy.
348
+
Once you've classified your application and documented the details, then be sure to gain business owner buy-in to your planned migration strategy.
349
349
350
350
### Application users
351
351
@@ -373,7 +373,7 @@ Many SaaS app vendors may not provide a self-service means to reconfigure the ap
373
373
374
374
### App owner sign-off
375
375
376
-
Business critical and universally used applications may need a group of pilot users to test the app in the pilot stage. Once you have tested an app in the pre-production or pilot environment, ensure that app business owners sign off on performance prior to the migration of the app and all users to production use of Azure AD for authentication.
376
+
Business critical and universally used applications may need a group of pilot users to test the app in the pilot stage. Once you've tested an app in the pre-production or pilot environment, ensure that app business owners sign off on performance prior to the migration of the app and all users to production use of Azure AD for authentication.
377
377
378
378
### Plan the security posture
379
379
@@ -401,7 +401,7 @@ With these aspects of resource, user, and device in mind, you may choose to use
401
401
402
402
### Exit criteria
403
403
404
-
You are successful in this phase when you have:
404
+
You are successful in this phase when you've:
405
405
406
406
- Fully documented the apps you intend to migrate
407
407
@@ -415,7 +415,7 @@ You are successful in this phase when you have:
415
415
416
416
## Phase 3: Plan migration and testing
417
417
418
-
Once you have gained business buy-in, the next step is to start migrating these apps to Azure AD authentication.
418
+
Once you've gained business buy-in, the next step is to start migrating these apps to Azure AD authentication.
419
419
420
420
### Migration tools and guidance
421
421
@@ -432,7 +432,7 @@ After migration, you may choose to send communication informing the users of the
432
432
433
433
During the process of the migration, your app may already have a test environment used during regular deployments. You can continue to use this environment for migration testing. If a test environment is not currently available, you may be able to set one up using Azure App Service or Azure Virtual Machines, depending on the architecture of the application. You may choose to set up a separate test Azure AD tenant to use as you develop your app configurations. This tenant starts in a clean state and won't be configured to sync with any system.
434
434
435
-
Once you have migrated the apps, go to the [Azure portal](https://portal.azure.com/) to test if the migration was a success. Follow these instructions:
435
+
Once you've migrated the apps, go to the [Azure portal](https://portal.azure.com/) to test if the migration was a success. Follow these instructions:
436
436
437
437
1. Select **Enterprise Applications > All applications** and find your app from the list.
438
438
@@ -444,7 +444,7 @@ Depending on how you configure your app, verify that SSO works properly.
|**OAuth / OpenID Connect**| Select **Enterprise applications > Permissions** and ensure you have consented to the application to be used in your organization in the user settings for your app. |
447
+
|**OAuth / OpenID Connect**| Select **Enterprise applications > Permissions** and ensure you've consented to the application to be used in your organization in the user settings for your app. |
448
448
|**SAML-based SSO**| Use the [Test SAML Settings](./debug-saml-sso-issues.md) button found under **Single Sign-On.**|
449
449
|**Password-Based SSO**| Download and install the [MyApps Secure Sign-in Extension](https://support.microsoft.com/account-billing/sign-in-and-start-apps-from-the-my-apps-portal-2f3b1bae-0e5a-4a86-a33e-876fbd2a4510#download-and-install-the-my-apps-secure-sign-in-extension). This extension helps you start any of your organization's cloud apps that require you to use an SSO process. |
450
450
|**[Application Proxy](../app-proxy/application-proxy.md)**| Ensure your connector is running and assigned to your application. Visit the [Application Proxy troubleshooting guide](../app-proxy/application-proxy-troubleshoot.md) for further assistance. |
@@ -467,7 +467,7 @@ If your migration fails, the best strategy is to roll back and test. Here are th
467
467
468
468
### Exit criteria
469
469
470
-
You are successful in this phase when you have:
470
+
You are successful in this phase when you've:
471
471
472
472
- Determined how each app is migrated
473
473
- Reviewed the migration tools
@@ -485,7 +485,7 @@ We recommend taking the following actions as appropriate to your organization.
485
485
486
486
### Manage your users’ app access
487
487
488
-
Once you have migrated the apps, you can enrich your user’s experience by:
488
+
Once you've migrated the apps, you can enrich your user’s experience by:
489
489
490
490
- Make apps discoverable by publishing them to the [Microsoft MyApplications portal](https://support.microsoft.com/account-billing/sign-in-and-start-apps-from-the-my-apps-portal-2f3b1bae-0e5a-4a86-a33e-876fbd2a4510#download-and-install-the-my-apps-secure-sign-in-extension).
491
491
- Add [app collections](access-panel-collections.md) so users can locate application based on business function.
@@ -537,6 +537,6 @@ Many [deployment plans](../fundamentals/active-directory-deployment-plans.md) ar
537
537
Visit the following support links to create or track support ticket and monitor health.
538
538
539
539
-**Azure Support:** You can call [Microsoft Support](https://azure.microsoft.com/support) and open a ticket for any Azure Identity deployment issue depending on your Enterprise Agreement with Microsoft.
540
-
-**FastTrack**: If you have purchased Enterprise Mobility and Security (EMS) or Azure AD Premium licenses, you are eligible to receive deployment assistance from the [FastTrack program.](/enterprise-mobility-security/solutions/enterprise-mobility-fasttrack-program)
540
+
-**FastTrack**: If you've purchased Enterprise Mobility and Security (EMS) or Azure AD Premium licenses, you are eligible to receive deployment assistance from the [FastTrack program.](/enterprise-mobility-security/solutions/enterprise-mobility-fasttrack-program)
541
541
-**Engage the Product Engineering team:** If you are working on a major customer deployment with millions of users, you are entitled to support from the Microsoft account team or your Cloud Solutions Architect. Based on the project’s deployment complexity, you can work directly with the [Azure Identity Product Engineering team.](https://portal.azure.com/#blade/Microsoft_Azure_Marketplace/MarketplaceOffersBlade/selectedMenuItemId/solutionProviders)
542
542
-**Azure AD Identity blog:** Subscribe to the [Azure AD Identity blog](https://techcommunity.microsoft.com/t5/Azure-Active-Directory-Identity/bg-p/Identity) to stay up to date with all the latest product announcements, deep dives, and roadmap information provided directly by the Identity engineering team.
0 commit comments