You are viewing an earlier version of the admin guide. For the latest version, please visit EmpowerID Admin Guide v7.211.0.0.
Create Azure Applications
EmpowerID provides a comprehensive wizard workflow called "Create Azure Application" to simplify and streamline the onboarding of Azure applications. This workflow offers various configurable parameters that allow you to modify the fields displayed during the onboarding process. Additionally, it includes settings to determine whether human approval is necessary before EmpowerID fulfills the request and provisions the application in Azure.
This article guides you through the process of creating an Azure application, encompassing the following steps:
Configuring the parameters of the CreateAzureApplication workflow
Defining the roles and ownership assigned by EmpowerID to application owners and deputies
Specifying the approval process (human or automatic)
Executing the workflow
Confirming the results
By following these steps, you can successfully create an Azure application tailored to your organization's specific requirements and preferences.
Step 1: Configure workflow parameters
The Create Azure Application wizard workflow incorporates numerous customizable parameters, allowing you to modify the fields displayed to users running the workflow. These parameters are listed in the below table. By customizing these parameters, you can tailor the workflow to best suit your organization's needs and preferences.
To configure workflow parameters, do the following:
On the navbar, expand Low Code/No Code Workflow and select Low Code Workflows.
Select the Workflow tab and search for Create Azure Application.
Click the Display Name for the workflow.
Β
On the View One page for the workflow, expand the Request Workflow Parameters accordion and search for the parameter you need to configure. In this example, we set the DefaultAzureTenantID parameter to the Azure tenant where applications are to be created.
Β
Click the edit button for the parameter, enter the appropriate Azure Tenant ID in the Value field and click Save.
Β
Configure any other settings as needed.
Step 2: Configure approval
The CreateAzureApplication workflow enables EmpowerID to either automatically provision Azure applications or require approval. This is determined by the Do not generate a business request (no approval) setting. If enabled, the application is provisioned instantly. If not, a business request for the application creation is generated and sent for approval. Upon approval, EmpowerID provisions the application in Azure.
To configure whether approval is needed or not, do the following:
Navigate to the View One page for the workflow (as shown in Step 1 above) and click the Edit link to put the workflow in Edit mode.
Β
On the Edit One page, toggle Do not generate a business request (no approval) as needed and save your changes.
Step 3: Configure owner and deputy roles
The Application Configuration settings of Azure RBAC Manager determine owner and deputy settings for Azure applications created in EmpowerID. These settings are listed in the below table.
Owner Settings | Description |
---|---|
AzureAppSingleOwnerCustomRole | AzLocalRole Name. This value determines the Custom Role assignment for the application owner in Azure. If value is empty, the user will be added as an Owner of the app registration in Azure. This user can view and edit the application registration. |
AzureAppSingleOwnerAccessLevelID | Specifies the ID of the Access Level (ResourceTypeRole) that application owners should be granted. The default value is the Access Manager Access Level for the Azure application. The owner can assign or unassign any Access Levels for the resource directly by EmpowerID Location. |
ProtectedAppSingleOwnerAccessLevelID | Specifies the ID of the Access Level (ResourceTypeRole) that protected application owners should be granted. The default value is the Access Manager for the protected application resource. The Access Manager is the owner of the resource and can manage/approve permissions assignments. |
Deputy Settings | Description |
AzureAppCustomRole1Name | This specifies the AzLocalRole name. This value determines the Custom Role assignment for ALL the deputies in Azure. If the value is empty, the deputies will be added as Owner(s) of the app registration in Azure. These user(s) can view and edit the application registration. |
ProtectedAppMultiOwnerAccessLevelID | Specifies the ID of the Access Level (ResourceTypeRole) that deputies should be granted for the protected application resource in EmpowerID. Defaults to the ACT-Application-Object-Administration Access Level for the protected application resource. Deputies can perform create, update and delete operations on the protected application. |
AzureAppMultiOwnerAccessLevelID | Specifies the ID of the Access Level (ResourceTypeRole) that deputies should be granted for the Azure application. Defaults to the ACT-Azure-Application-Administration Access Level for the Azure Application. Deputies can perform create, update and delete operations on the Azure application. |
Β
To configure custom owner and deputy role settings, do the following:
On the navbar, expand Apps and Authentication and select Applications.
From the Applications tab, search for RBAC and click the Display Name link for Azure RBAC Manager.
This directs you to the View One page for the application. From this page, you can manage the application as needed.Β
On the View One page, select the App Resources tab and then expand the Application Configuration Settings accordion.
Click the Edit button for any setting you need to configure with a custom value.
Β
Save your changes.
Step 4: Run the workflow
Navigate to the portal for the Resource Admin app in your environment.
In Resource Admin, select Applications and then select the Workflows tab.
Click Onboard Azure Application.
This opens the Create Azure Application wizard workflow. Follow the wizard and fill in the fields of each section of the workflow with the appropriate information for your application.
Which Type of Azure Application Do You Wish to Onboard? β Select the type of application you wish to integrate with Azure. Types include:
Non-gallery Enterprise Applications (SAML)
Gallery Enterprise Applications (SAML)
Application Registration (OIDC)
In Which Environment Will It Be Deployed? β Select the appropriate environment for the application. Depending on the value of the AzureAppApplicationLine list data set, the choices displayed may differ from those below. The option selected has no effect on where the application is created; it is metadata that EmpowerID stores in an extension attribute on the application.
Β
Select a Tenant β Search for and select the Azure tenant in which the application is to be created.
Select a Location β Select a location in EmpowerID for the application. This location is for RBAC delegation only.
If there is a location selected by default and you wish to change it, click the link for the location and then search for and select the desired location from the Location tree.
Β
Azure Application Name β Enter a name for the application
Azure Description β Enter a description for the application
Β
Select the scope for selecting which accounts can use the application. Default options include the following:
Personal Microsoft accounts only
Accounts in this organizational directory only (Single tenant)
Accounts in any organizational directory (Any Azure AD directory - Multitenant) and personal Microsoft accounts (e.g., Skype, Xbox)
Accounts in any organizational directory (Any Azure AD directory - Multitenant)
Β
Application Owner β Search for and select the application owner. This field only returns people with an account in the Azure tenant.
Select Deputies β Search for and select one or more application deputies. This field only returns people with an account in the Azure tenant.
Β
Select A Platform β Select a platform the application is targeting. Options include:
Web β Build, host, and deploy web server applications
Single-page application β Configure browser client applications and progressive web applications
Mobile and desktop applications β iOS/macOS, Android applications
Front-Channel Logout URL β Enter URL as needed
Issue Access token (used for implicit flows) β Select as needed
Issue ID tokens (used for implicit and hybrid flows) β Select as needed
Allow Public Client Flows β Specifies whether the application is a public client. Appropriate for apps using token grant flows that donβt use a redirect URI.
User Access Settings
Enabled for users to sign-in? β Enabled by default
Assignment required? β Enabled by default
Β
Set Requestable Setting β Specifies whether the application is requestable in the IAM Shop. When selected, the settings below are relevant.
Select Access Request Policy β Select the Access Request policy that specifies how requests for the application are processed.
Select Assignees β Search for and select users who are eligible for the application. Users must have one of the below eligibility assignments to view the application in the IAM Shop.
Eligible Assignees β Choose the type (Person, Group, SetGroup, Management Role, Business Role and Location), and then search for and select the specific assignees eligible for the application.
Preapproved Assignees β Choose the type (Person, Group, SetGroup, Management Role, Business Role and Location), and then search for and select the specific assignees pre-approved for the application.
Suggested Assignees β Choose the type (Person, Group, SetGroup, Management Role, Business Role and Location), and then search for and select the specific assignees suggested for the application.
Review the summary information for the application and then click Submit.
If you configured the workflow to require approval, you should see that a business request for the Azure application was successfully created. Each designated approver must approve the business request before EmpowerID fulfills the request and creates the application.Β
Click Submit to exit the wizard.
Step 5: If configured: Approve the Business Request
If the workflow was configured to require approval, do the following to approve the business request; otherwise, move to Step 6 below and verify the application in Azure.
Navigate to the portal for the My Tasks application and log in as a user who can approve the request.
In My Tasks, select To Do and locate the Business Request for creating the application.
Click the Pending button.
Β
Click Run Workflow.
Β
Review the information in the Running Approval Workflow dialog and click Approve.
You should see the request is completed and pending fulfillment, which occurs when the system creates the application in Azure.
Results
After the request to create an Azure application has been approved and EmpowerID has fulfilled the request, you should be able to confirm the application has been created in Azure with the owner and deputies specified when the application was created.
Log in to your Azure portal and navigate to Azure AD > Enterprise applications.
Select All Applications as the Application type and then search for the application you just created.
You should see the application.
Click the Name link for the application to navigate to the Overview blade for the app.
Under Manage, click Owners.
You should see the Application owner and any deputies you specified for the application when you created it in EmpowerID.
Β