How to enable Aprimo Content Connector

Updated December 09, 2024 19:35

This article guides you through the setup of Aprimo integration.

Prerequisites

Admin/owner access to the Templafy tenant.
Content Connectors module enabled.
An application must be registered in Aprimo via Administration > Integration > Registrations:
- The redirect URL should be set to
  https://public.templafy.com/integrations/oauth/login-callback
- The relevant OAuth Flow that should be applied for the Connector was selected:
  - Resource Owner Password should be used for Basic authentication in Templafy (organization content / same content for all)
  - Authorization code with PKCE should be used for OAuth 2 Authorization code with PKCE in Templafy (user specific content)
    - When selecting PKCE, we recommend checking Enable Refresh Token to reduce the frequency of log in required for the end-users

How to configure Aprimo

Go to Integrations section.
Go to Available tab.
Search for Aprimo
Click + to proceed with the configuration
Fill out the necessary configuration fields:
- Display Name (required)
  The name entered in this field will be displayed to the end-users
- Tenant Name (required)
  For mycompany.aprimo.com, the tenant's name will be mycompany
- Root classification (optional)
- Language ID (optional)
Select the desired Authentication type
- Basic authentication will display the same content to all users without login (organization's content)
- OAuth 2 Authorization code with PKCE will require user login and will display user specific content
Based on the selected Authentication type, fill out the necessary configuration fields
- For Basic authentication:
  - Username
  - User Token
  - Client ID
- For OAuth 2 Authorization code with PKCE:
  - Client ID
  - Client Secret
Hit Save

Important

The Aprimo content connector can have only one authentication type at a time. If several authentication types are required, several connectors should be set up.

Note

If the Aprimo Content Connector is utilizing Authorization code with PKCE as an authentication type, the following should be noted:

When not logged in, the user will not be able to access any Aprimo content; the content will only be displayed once the login has been successful.
If the user is already logged in on Aprimo side, the log in on Templafy side will be seamless as the token already exists.
If the user isn't already logged in on Aprimo side, the user will need to provide their Aprimo credentials to log in as the token cannot be found.
If a user has multiple Aprimo accounts and needs to switch between these accounts, this can be performed by logging out and logging in again within the same browser, OR by opening a different browser (or incognito window) and logging in with the desired account.

Related to

hive connectors dam admin_role

Articles in this section