Configuring AEM to work with AEM Mobile

Search
Experience Manager Mobile User Guide

On this page

Applies to: Experience Manager Mobile

某些 Creative Cloud 应用程序、服务和功能在中国不可用。

Set up an AEM instance that runs with an Adobe Experience Manager Mobile project. After you integrate AEM with AEM Mobile, articles you create in AEM wil appear in the AEM Mobile On-Demand Portal. You can create and manage content for mobile applications using AEM’s tools while using AEM Mobile’s On-Demand services for easy distribution of mobile content.

 

 

Setup requirements

To set up an AEM instance that runs with Adobe Experience Manager Mobile, you need access to the following items.

  • AEM 6.1 or AEM 6.2.
  • AEM Mobile Master Admin access to an AEM Mobile account.
  • API keys for AEM Mobile.

Install AEM packages

If you are running AEM 6.2, no additional packages are needed.

In order to configure AEM to work with AEM Mobile, you need AEM 6.1 with the following packages:

  • Service Package 1 (aem-service-pkg-bundles-6.1.SP1.zip)
  • Feature Package 3 (cq-6.1.0-apps-featurepack-3.0.0.zip)
  • Feature Package 3 Samples (cq-6.1.0-apps-featurepack-samples-3.0.0.zip)

For information about installing feature packages for AEM 6.1, see How to Work With Packages.

Create AEM Mobile project and test user

When you configure AEM instance to work with AEM Mobile, you need to configure the instance using an account that will tie AEM to a specific AEM Mobile project. That way, you can create articles in AEM and view those articles in the AEM Mobile project.

  1. If you haven’t done so, create a project in your AEM Mobile account in the On-Demand Portal (http://aemmobile.adobe.com).

  2. We recommend that you create a new Adobe ID using a new email address that will be used specifically for the integration. For example: aem-integration@company.com.

  3. In the Portal, add the user created in step 2 to the project. Include (at minimum) the following Content permissions:

    • Add & Edit Content
    • Delete Content
    • View Content
    • Publish Content

You will use this Adobe ID later when configuring your AEM instance for AEM Mobile.

Obtain API keys for AEM

Valid API credentials are required to take advantage of On-Demand Services APIs. In this case, the API credentials are required to configure your AEM instance with AEM Mobile.

API credentials consist of the following items:

  • API Key & Client Secret are credentials to access the API Gateway.
  • Device ID and Device Token are credentials to identify the API user.

  1. Request an API Key by following these instructions: Integrating third-party systems with AEM Mobile: API Keys.

     

    In the request form, include at minimum the specific Adobe ID created in the previous steps.

    After completing the request, you will receive the API Keys.

  2. Go to the https://aex.aemmobile.adobe.com/ for the IMS Device Token Generator and enter the following as requested:

    • IMS Client ID and Client Secret (obtained via email request).
    • Sign in using the specifc Adobe ID you assigned in the above steps. The device ID and device Token will be generated for this particular Adobe ID..
    aem_aex

  3. Copy and save all four of these values—Client ID, Client Secret, Device ID, and Device Token—in a known location. You will use all four of these values in the next set of steps.

Configure the AEM instance for AEM Mobile

You must complete the configuration steps in order for the AEM Mobile On-Demand integrations to function correctly. Configure your AEM instance to work with a specific AEM Mobile account.

Configuring AEM 6.2

Configure your AEM 6.2 instance to work with a specific AEM Mobile account.

  1. In a browser running AEM, click Adobe Experience Manager in the upper left, and then go to Tools (the hammer icon) > Operations > Web Console.

    A new tab or window is opened.

  2. Scroll down to “Experience Manager Mobile On-demand Services Client” and click the edit (pencil) icon.

  3. Enter the IMS Client ID and Client Secret in the “DPS Client Id” and “DPS Client Secret” fields and click Save. You can then close the Web Console tab or window.

  4. On the Main AEM page, go to Tools (hammer icon) > Deployment > Cloud Services.

  5. Scroll down to “Adobe Experience Manager Mobile On-demand Services” (under “Adobe Creative Cloud”), and click Configure Now.

  6. In the “Create Configuration” pop-up window, enter a Title and Name, and click Create. ("Name" should have no spaces.)

  7. In the Adobe Digital Publishing Solution Configuration pop-up window, enter the Device Id and Device Token from the IMS Device Token Generator used earlier.

  8. Click Test Device Configuration to check the configuration settings.

    If the test fails, use the IMS Device Token Generator to make sure that your Device ID and Device Token values have not expired and are copied properly.

  9. Click OK, and then navigate back to the Main AEM window.

Configuring AEM 6.1

  1. In a browser running AEM, go to Tools > Web Console.

    A new tab or window is opened.

  2. Scroll down to “Adobe Digital Publishing Solution Client” and click the edit (pencil) icon.

  3. Enter the IMS Client ID and Client Secret in the “DPS Client Id” and “DPS Client Secret” fields and click Save. You can then close the Web Console tab or window.

  4. On the Main AEM page, go to Tools > Operations > Cloud > Cloud Services.

  5. Scroll down to “Adobe Digital Publishing Solution” (under “Adobe Creative Cloud”), and click Configure Now.

  6. In the “Create Configuration” pop-up window, enter a Title and Name, and click Create. ("Name" should have no spaces.)

  7. In the Adobe Digital Publishing Solution Configuration pop-up window, enter the Device Id and Device Token from the IMS Device Token Generator used earlier.

  8. Click Test DPS Settings to check the configuration settings.

  9. Click OK, and then navigate back to the Main AEM window.

Your AEM instance is now configured to create and manage content in your AEM Mobile project.

Whenever you want to shut down your instance of AEM, click the button in the AEM Quickstart window to toggle it off. To restart AEM, double-click the original JAR file that you downloaded.

Create an app in AEM

Creating an app is often the first step towards creating and managing AEM Mobile On-Demand content, and is often performed at the AEM Administrator level. It represents the author-created content such as articles and collections that will appear in the mobile app.

The details of your app can be viewed in its "dashboard". The dashboard is a series of useful tiles which give an overview of the app's content, metadata, and AEM Mobile On-Demand connection status.

Note that the actual app that gets installed on mobile devices is created through the AEM Mobile On-Demand Portal.

For additional information, see Application Create and Configure Actions.

Creating an On-Demand app in AEM 6.2

  1. Go the Mobile section. (In AEM 6.2, click Adobe Experience Manager, click the Navigation icon, and then click Mobile.)
  2. Click Create > App.
  3. Choose "AEM Mobile runtime" and click Next.
  4. Enter app properties such as Title, Name, Description. The app properties should correspond to the properties used in the AEM Mobile On-Demand Portal, and click Next.
  5. Under Manage Connection, select the AEM Mobile account and target project.

Creating an On-Demand app in AEM 6.1

  1. Within your AEM instance, click “Apps” in the let nav bar.
  2. Click + Create > Create App, select “Adobe Digital Publishing Solution Mobile App”, and then click Next.
  3. Enter app properties such as Title, Name, Description. The app properties should correspond to the properties used in the AEM Mobile On-Demand Portal, and click Next.
  4. Under Manage Connection, select the AEM Mobile account and target project.