Managing External Applications and OAuth Client Configuration

1. Overview

Fedena provides an option to integrate external applications with the system through the Manage Apps feature. This allows institutions to add and access external applications directly from their Fedena account.

Depending on the application URL and configuration, an application can open either:

• Within the Fedena interface .

• In a separate browser tab.

For applications that require secure authentication or integration with the Fedena, OAuth client configuration may also be required.

This documentation explains how to add applications in Fedena, understand the application access options, and identify the purpose of OAuth client configuration.

2. Purpose of Managing Applications in Fedena

The Manage Apps feature helps institutions:

• Integrate external applications with Fedena.

• Provide users with access to third-party applications from a single platform.

• Simplify navigation between Fedena and connected applications.

• Control how integrated applications are opened.

• Make frequently used external tools accessible through the Fedena dashboard.

3. How to Add an Application in Fedena

Follow the steps below to add an external application.

1. Log in to your Fedena account using administrator credentials.

2. Navigate to the Module Access icon.

3. Select Administartion > Settings > Manage Clients.

4. Click New.

5. Click New to add a new application.

6. Enter the required application details, such as the application name and URL.

7. Select the check box.

8. Save the configuration.

4. Application Opening Options

Fedena supports different application-opening behaviours depending on whether the application URL uses HTTPS or HTTP.

4.1 Secure Application (HTTPS)

When adding an application with a secure HTTPS URL, you can choose how the application should open:

• Within Fedena: The application opens inside the Fedena interface using an embedded frame, provided the external application permits embedding.

• In a New Tab: The application opens separately in a new browser tab.

4.2 Insecure Application (HTTP)

When adding an application using an HTTP URL:

• Fedena displays a notification indicating that the application is not using a secure connection.

• The application opens in a new browser tab by default.

• It does not open within the Fedena embedded frame.

5. Identifying Applications That Open in a New Tab

Applications configured to open in a separate browser tab can be identified by the icon displayed beside the application name.

6. OAuth Client Configuration

OAuth is an authorisation framework that allows applications to communicate securely and obtain authorised access to resources.

In the Fedena , an OAuth client configuration may be used to register an application and manage its authentication or integration settings.

The configuration contains the following details:

7. How Does OAuth Authentication Work?

The general authentication process follows these steps:

Step 1: User accesses the application

The user opens the Fedena Website or an integrated application.

Step 2: Authentication request

The application identifies itself using the registered Client ID.

Step 3: Authentication verification

The authentication server validates the request and the required credentials.

Step 4: Redirect to the configured URI

After successful authentication, the user is redirected to the approved destination with the appropriate authentication response.

8. Why Is OAuth Configuration Important?

OAuth client configuration helps with:

1. Application Identification: Identifies the application requesting authentication.

2. Secure Authentication: Helps verify that the authentication request comes from a registered application.

3. Redirect URI Validation: Ensures that authentication responses are sent to an authorised URL.

4. Integration Management: Allows administrators to manage registered applications and their authentication settings.

5. Access Control: Supports controlled authorisation between connected applications.