Skip to content

Commit 32c873d

Browse files
authored
Merge pull request #249621 from omondiatieno/app-properties
Added more information on user requirement property
2 parents ff1fb06 + 90c37e4 commit 32c873d

File tree

1 file changed

+33
-30
lines changed

1 file changed

+33
-30
lines changed

articles/active-directory/manage-apps/application-properties.md

Lines changed: 33 additions & 30 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ ms.service: active-directory
88
ms.subservice: app-mgmt
99
ms.topic: conceptual
1010
ms.workload: identity
11-
ms.date: 09/06/2022
11+
ms.date: 08/29/2023
1212
ms.author: jomondi
1313
ms.reviewer: ergreenl
1414
ms.custom: enterprise-apps
@@ -20,71 +20,74 @@ ms.custom: enterprise-apps
2020

2121
This article describes the properties that you can configure for an enterprise application in your Azure Active Directory (Azure AD) tenant. To configure the properties, see [Configure enterprise application properties](add-application-portal-configure.md).
2222

23-
## Enabled for users to sign in?
23+
## Enabled for users to sign in?
2424

25-
If this option is set to **Yes**, then assigned users are able to sign in to the application from the My Apps portal, the User access URL, or by navigating to the application URL directly. If assignment is required, then only users who are assigned to the application are able to sign-in. If assignment is required, applications must be assigned to be granted a token.
25+
If this option is set to **Yes**, then assigned users are able to sign in to the application from the My Apps portal, the User access URL, or by navigating to the application URL directly. If assignment is required, then only users who are assigned to the application are able to sign-in. If assignment is required, applications must be assigned to get a token.
2626

2727
If this option is set to **No**, then no users are able to sign in to the application, even if they're assigned to it. Tokens aren't issued for the application.
2828

29-
## Name
29+
## Name
3030

31-
This property is the name of the application that users see on the My Apps portal. Administrators see the name when they manage access to the application. Other tenants see the name when integrating the application into their directory.
31+
This property is the name of the application that users see on the My Apps portal. Administrators see the name when they manage access to the application. Other tenants see the name when integrating the application into their directory.
3232

33-
It's recommended that you choose a name that users can understand. This is important because this name is visible in the various portals, such as My Apps and O365 Launcher.
33+
It's recommended that you choose a name that users can understand. This is important because this name is visible in the various portals, such as My Apps and Microsoft 365 Launcher.
3434

35-
## Homepage URL
35+
## Homepage URL
3636

37-
If the application is custom-developed, the homepage URL is the URL that a user can use to sign in to the application. For example, it's the URL that is launched when the application is selected in the My Apps portal. If this application is from the Azure AD Gallery, this URL is where you can go to learn more about the application or its vendor.
37+
If the application is custom-developed, the homepage URL is the URL that a user can use to sign in to the application. For example, it's the URL that is launched when the application is selected in the My Apps portal. If this application is from the Azure AD Gallery, this URL is where you can go to learn more about the application or its vendor.
3838

39-
The homepage URL can't be edited within enterprise applications. The homepage URL must be edited on the application object.
39+
The homepage URL can't be edited within enterprise applications. The homepage URL must be edited on the application object.
4040

41-
## Logo
41+
## Logo
4242

4343
This is the application logo that users see on the My Apps portal and the Office 365 application launcher. Administrators also see the logo in the Azure AD gallery.
4444

4545
Custom logos must be exactly 215x215 pixels in size and be in the PNG format. You should use a solid color background with no transparency in your application logo. The logo file size can't be over 100 KB.
4646

47-
## Application ID
47+
## Application ID
4848

4949
This property is the unique identifier for the application in your directory. You can use this application ID if you ever need help from Microsoft Support. You can also use the identifier to perform operations using the Microsoft Graph APIs or the Microsoft Graph PowerShell SDK.
5050

51-
## Object ID
51+
## Object ID
5252

53-
This is the unique identifier of the service principal object associated with the application. This identifier can be useful when performing management operations against this application using PowerShell or other programmatic interfaces. This identifier is different than the identifier for the application object.
53+
This is the unique identifier of the service principal object associated with the application. This identifier can be useful when performing management operations against this application using PowerShell or other programmatic interfaces. This identifier is different than the identifier for the application object.
5454

55-
The identifier is used to update information for the local instance of the application, such as assigning users and groups to the application. The identifier can also be used to update the properties of the enterprise application or to configure single-sign on.
55+
The identifier is used to update information for the local instance of the application, such as assigning users and groups to the application. The identifier can also be used to update the properties of the enterprise application or to configure single-sign on.
5656

57-
## Assignment required
57+
## Assignment required
5858

59-
This option doesn't affect whether or not an application appears on the My Apps portal. To show the application there, assign an appropriate user or group to the application. This option has no effect on users' access to the application when it's configured for any of the other single sign-on modes.
59+
This setting controls who or what in the directory can obtain an access token for the application. You can use this setting to further lock down access to the application and let only specified users and applications obtain access tokens.
60+
61+
This option determines whether or not an application appears on the My Apps portal. To show the application there, assign an appropriate user or group to the application. This option has no effect on users' access to the application when it's configured for any of the other single sign-on modes.
62+
63+
If this option is set to **Yes**, then users and other applications or services must first be assigned this application before being able to access it.
64+
65+
If this option is set to **No**, then all users are able to sign in, and other applications and services are able to obtain an access token to the application. This option also allows any external users that may have been invited into your organization to sign in.
66+
67+
This option only applies to the following types of applications and services:
6068

61-
If this option is set to **Yes**, then users and other applications or services must first be assigned this application before being able to access it.
62-
63-
If this option is set to **No**, then all users are able to sign in, and other applications and services are able to obtain an access token to the application.
64-
65-
This option only applies to the following types of applications and services:
6669
- Applications using SAML
6770
- OpenID Connect
6871
- OAuth 2.0
6972
- WS-Federation for user sign
70-
- Application Proxy applications with Azure AD pre-authentication enabled
71-
- Applications or services for which other applications or service are requesting access tokens
73+
- Application Proxy applications with Azure AD preauthentication enabled
74+
- Applications or services for which other applications or service are requesting access tokens
7275

73-
## Visible to users
76+
## Visible to users
7477

75-
Makes the application visible in My Apps and the O365 Launcher
78+
Makes the application visible in My Apps and the Microsoft 365 Launcher
7679

77-
If this option is set to **Yes**, then assigned users see the application on the My Apps portal and O365 app launcher.
80+
If this option is set to **Yes**, then assigned users see the application on the My Apps portal and Microsoft 365 app launcher.
7881

79-
If this option is set to **No**, then no users see this application on their My Apps portal and O365 launcher.
82+
If this option is set to **No**, then no users see this application on their My Apps portal and Microsoft 365 launcher.
8083

8184
Make sure that a homepage URL is included or else the application can't be launched from the My Apps portal.
8285

83-
Regardless of whether assignment is required or not, only assigned users are able to see this application in the My Apps portal. If you want certain users to see the application in the My Apps portal, but everyone to be able to access it, assign the users in the **Users and Groups** tab, and set assignment required to **No**.
86+
Regardless of whether assignment is required or not, only assigned users are able to see this application in the My Apps portal. If you want certain users to see the application in the My Apps portal, but everyone to be able to access it, assign the users in the **Users and Groups** tab, and set assignment required to **No**.
8487

85-
## Notes
88+
## Notes
8689

87-
You can use this field to add any information that is relevant for the management of the application. The field is a free text field with a maximum size of 1024 characters.
90+
You can use this field to add any information that is relevant for the management of the application. The field is a free text field with a maximum size of 1024 characters.
8891

8992
## Next steps
9093

0 commit comments

Comments
 (0)