ASRP - Adobe Storage Resource Provider

Last update: May 3, 2023

CREATED FOR:

  • Admin
CAUTION
AEM 6.4 has reached the end of extended support and this documentation is no longer updated. For further details, see our technical support periods. Find the supported versions here.

About ASRP

When AEM Communities is configured to use ASRP as its common store, user generated content (UGC) is accessible from all author and publish instances without the need for synchronization nor replication.

See also Characteristics of SRP Options and Recommended Topologies.

Requirements

An additional license is required for the use of ASRP.

To configure your AEM Communities site to use ASRP for UGC, contact your account representative for:

  • Data Center URL (address of the ASRP endpoint)
  • Consumer Key
  • Secret Key
  • Report Suite ID(s)

The consumer and secret keys are shared across all report suites for a company. There is one report suite per tenant.

Configuration

Select ASRP

The Storage Configuration console allows for the selection of the default storage configuration, which identifies which implementation of SRP to use.

On author:

  • From global navigation: Tools > Communities > Storage Configuration

chlimage_1-310

  • Select Adobe Storage Resource Provider (ASRP)

  • The following information comes from the provisioning process

    • Data Center URL

      Pull-down to select the production data center identified by your account representative

    • Default Report Suite

      Enter the name of the default report suite

    • Consumer Key

      Enter the consumer key

    • Secret

      Enter the secret key

  • Select Submit

Prepare the publish instances:

After submitting the configuration, test the connection:

  • Select Test Config
    for each author and publish instance, test the connection to the data center from the Storage Configuration console

  • Finally, ensure that the site URLs for profile data are routable from the Data Center by externalizing links.

Replicate the Crypto Key

The Consumer Key and Secret Key are encrypted. In order for the keys to be encrypted/decrypted properly, the primary Granite Crypto key must be the same on all AEM instances.

Follow the instructions at Replicate the Crypto Key.

For correct profile and profile image links, be sure to properly Configure the Link Externalizer.

Be sure to set the domains to be URLs that are routable from the Data Center URL (ASRP endpoint).

Time Synchronization

In order for authentication with the ASRP endpoint to succeed, the machines running your hosted AEM Communities must be time synchronized, such as with the Network Time Protocol (NTP).

Publishing the Configuration

ASRP must be identified as the common store on all author and publish instances.

To make the identical configuration available in the publish environment:

  • On author:

    • Navigate from main menu to Tools > Operations > Replication

    • Select Activate Tree

    • Start Path:

      • Browse to /etc/socialconfig/srpc/

    • Uncheck Only Modified

    • Select Activate

Upgrading from AEM 6.0

CAUTION
If you enable ASRP on a published community site, any UGC already stored in JCR will no longer be visible as there is no synchronization of data between on-premise storage and cloud storage.

AEM Communities Extension was previously introduced in AEM 6.0 social communities as a cloud service. As of AEM 6.1 Communities, no cloud configuration is necessary, simply select ASRP from the storage configuration console.

Due to the new storage structure, it is necessary to follow the upgrade instructions when upgrading from social communities to Communities.

Managing User Data

For information regarding users, user profiles and user groups, often entered in the publish environment, visit

Troubleshooting

UGC Disappears after Upgrade

If upgrading from an exisitng AEM 6.0 social community site, be sure to follow the upgrade instructions, else UGC will appear to be lost.

Authentication Errors

If receiving authentication errors against the Data Center URL, and the AEM error.log contains messages about stale timestamps, then verify that time synchronization is happening.

It is recommended to use a tool such as the Network Time Protocol (NTP) to time synchronize all AEM author and publish servers.