Configure App Info

Overview

In this article, you can find the how-to guide on configuring the app info. It includes configuring new app information details or updating the existing app basics on Apporetum.

info

System Admin is responsible for configuring and creating an app. Once the app is created, App Owners should be in charge of managing this app and updating the app basics and app managers.

tip

If you would like to learn the basic concept of app configuration, we recommend you to read this article, App Configuration Essentials.

Configure New App Info

1. In the Apporetum navigation Menu, click Access -> Apps
2. Click the Configure App option located on the top right of the page

3. By default, you will land on the Create App configuration page

Source

4. Choose a Data Source

info

You will be able to choose from the three main data sources, Entra ID (formerly Azure Active Directory), on-premises Active Directory, and CSV. A deep dive on setting up data sources in Apporetum can be found here.

note

If you choose on-premises Active Directory or CSV, you can continue the next configuration section About.

5. If you choose Entra Id as a data source, there will be four access types that will be available to select:
   1. Group - This setting creates a group in Entra ID
   2. App Role - This setting pulls a
   3. Entra PIM
   4. Directory Roles

Access Type - Group

When selecting Entra ID as the data source and selecting Group as the Access Type you allow the new app to be configured by creating a group in Entra ID. Access to this app is controlled by who has access to the Entra ID group.

Access Type - App Role

When selecting Entra ID as the data source and selecting the App Role as the Access Type you allow the new app to be backed by an existing app registration in your Azure tenant.

• Once App Role has been selected, a new option will be available called Data Source App. This setting allows you to select the an app registration.

Access Type - Entra PIM / Directory Roles

When selecting Entra ID as the data source and selecting either Entra PIM or Directory Roles as the Access Type you allow the new app to be configured by Entra ID PIM roles. This feature allows Apporetum to have granular information on which users are assigned PIM roles.

tip

If you are setting up Entra PIM or Directory Role access types it is recommended to follow the how-to article found here.

About

The About section is used to to distinguish this application for you and others.

1. Fill in a Friendly Name
2. Give a Description
3. (optional) Fill in a Redirect URL

tip

we recommend you to fill a secure HTTP connection (HTTPS) as the Redirect URL.

Management

The management options controls administration, membership granting, and approval within this application.

note

We do not recommend adding the same person as both access provider and access approver. By adding different people, you have security benefits from separating . However, you can add the same person to the three app manager roles.

1. Choose one or more Owners
2. Choose one or more Access Providers
3. Choose one or more Access Approvers
4. Choose one or more Access Reviewers

tip

You can view App Manager to learn more about the role entitlements.

5. Click Save Changes
6. Check System notification

Update Existing App Info

1. In the Apporetum navigation Menu, click Access -> Apps

2. Use the search bar to find the app to edit

3. Click the cogwheel icon on the app tile

   

4. By default, you will land on the Config tab

5. View the App Info which includes the Data Source, App Manifest, Type, and ID for the app

6. Under About section, update Friendly Name, Description, and (optional) Redirect Url

7. Under Management section, add or remove users from Owners, Access Provider, Access Approver, and Access Reviewers

8. Click Save changes

9. Check system notification