Custom applications

Create a Custom Application

When you integrate authentication in your mobile application or web portal using TrustBuilder SDKs, your applications are identified in the TrustBuilder platform as a Custom Mobile Application or a Custom Portal.

Mobile app using Trustbuilder SDK

To register your application using TrustBuilder SDK you should create a Custom application. This step is mandatory to declare Firebase parameters and enable application registration.

Only Firebase is supported.

1. Go to Applications > Custom Applications.

2. Click on + Create custom application.

3. Select the application type: Custom Authenticator - mobile.

4. Choose the operating system : Android or iOS.

5. Enter the Application ID (application identifier):

   • Android: applicationId in the module’s build.gradle file.

   • iOS: Bundle Identifier defined in Xcode.

6. Enter the internal application name. This will be the name used within Trustbuilder system.

7. (Optional) Specify a download link that will be used to provide access to the application download.

8. Upload or paste the Service Account (see Prerequisites).

9. Click Save.

10. Your custom application is now created.

APPLICATION ALIAS

An application alias is automatically generated when you create a custom application in TrustBuilder.

This value must be used in your mobile application so the SDK can communicate with TrustBuilder services.

See mobile SDKs

Now, you must create the associated internal authentication method to allow users to authenticate using your application.

Custom Login portal

The custom Login portal is the bridge between the user interface and the authentication backend (Trustbuilder). It handles the web authentication experience.

The custom login portal:

• calls Trustbuilder APIs to track authentication requests status and then displays the right screens to users.

• when needed, displays the available authentication methods to users to allow them to choose.

• can embed Trustbuilder Authenticator Web SDK.

In a white-label integration, the custom login portal is mandatory. Even without user interface, it must communicate with TrustBuilder APIs to handle authentication request status.

To link your custom login portal to Trustbuilder:

1. Go to Applications > Custom Applications.

2. Click on + Create custom application.

3. Select the application type: Custom login portal.

4. Fill in the fields:

   1. Internal application name: the name used in within Trustbuilder system

   2. User authentication URL: the URL where your custom portal is hosted.

   3. Allowed URLs or domains: URLs where users can be redirected after authentication. Click + Add to enter several URLs.
      Only URLs listed here will be accepted by TrustBuilder for redirection. Make sure to enter all URLs that users might be sent to, including multiple ones in case of load balancing.

5. Click Save.

6. Your custom application is now created.

If your custom portal embeds a custom Authenticator web, you must create the associated internal authentication method to allow users to authenticate using your application.