Installation Guide for antegma accallio OX 1.0.0 Version 1.0

Installation Guide for antegma accallio OX 1.0.0

2

INSTALLATION VIA PACKAGE MANAGER OF ADOBE EXPERIENCE MANAGER 3

Download of the content package 3

Install content package via AEM Package Manager 3

CONFIGURATION OF ACCALLIO OX INSIDE OF AEM OSGI CONSOLE 4

antegma accallio Common OAuth2 Configuration 4

accallio OX Configuration 5

accallio OX Graph Configuration 6

CREATE A SERVICE USER FOR ACCALLIO 8

Create service user 8

Add Service User Mapping 9

Add permissions of service user 10

Installation Guide for antegma accallio OX 1.0.0

3

Installation via Package Manager of Adobe Experience Manager

Download of the content package The installer is shipped as an AEM content package. Please download the appropriate version of the installer of accallio OX from the antegma Nexus server.

Adobe Experience Manager Version

Content Package Name

AEM 6.4 accallio-ca-installer-aem64-1.0.0-SNAPSHOT.zip

AEM 6.3 accallio-ca-installer-aem63-1.0.0-SNAPSHOT.zip

AEM 6.2 accallio-ca-installer-aem62-1.0.0-SNAPSHOT.zip

AEM 6.1 accallio-ca-installer-aem61-1.0.0-SNAPSHOT.zip

AEM 6.0 accallio-ca-installer-aem60-1.0.0-SNAPSHOT.zip

All customers which have licensed antegma accallio OX have access to antegma Nexus Server.

Install content package via AEM Package Manager

Install the accallio CA View content package using the AEM Package Manager:

As Admin open the AEM Package Manager (/crx/packmgr/index.jsp)

Click on the button "Upload Package"

Click on the button "Browse" and choose the content package "accallio-ca-installer-aem6X-2.0.0-SNAPSHOT.zip" of the installation package you've downloaded previously

Click on the button "Upload"

After the upload has been finished, please install the content package by selecting it and clicking on the "Install" button.

Installation Guide for antegma accallio OX 1.0.0

4

Configuration of accallio OX inside of AEM OSGI Console

antegma accallio Common OAuth2 Configuration

To access the REST API of Office 365 Outlook & Exchange REST API, you have to setup an OAuth Configuration. When using Office 365 Outlook, you can create the necessary configuration using the Azure Portal. https://docs.microsoft.com/en-us/azure/active-directory/develop/howto-create-service-principal-portal Office 365 Outlook & Exchange REST API

Name Description

1 Tenant Identifier Unique ID for the OAuth Configuration Please enter the value “microsoft-exchange”

2 Server Base Url Url of of OAuth2 Server Endpoint of your Office 365 & Exchange Instance

3 Basic authentication username Username for basic authentication.

4 Basic authentication password Password for basic authentication.

5 Keystore File Location File path to the Java Keystore, if self-signed certificates or different HOST information within SSL certificates are used.

6 Keystore Password Passwort for Java Keystore.

7 Client ID Client ID for Office 365 Outlook or Exchange

8 Client Secret Client Secret for Office 365 Outlook or Exchange

9 Resource Identifier for the Resource which you would like to use. Please enter value “https://outlook.office365.com/” for Office 365

10 Scope Scope of the OAuth Request

Installation Guide for antegma accallio OX 1.0.0

5

Name Description

Please enter no value into this field.

Microsoft Graph for Access to Office365 People API

Name Description

1 Tenant Identifier Unique ID for the OAuth Configuration Please enter the value “microsoft-graph”

2 Server Base Url Url of of OAuth2 Server Endpoint of your Office 365 & Exchange Instance

3 Basic authentication username Username for basic authentication. Please enter no value into this field.

4 Basic authentication password Password for basic authentication. Please enter no value into this field.

5 Keystore File Location File path to the Java Keystore, if self-signed certificates or different HOST information within SSL certificates are used. Please enter no value into this field.

6 Keystore Password Passwort for Java Keystore. Please enter no value into this field.

7 Client ID Client ID for Office 365 Outlook or Exchange

8 Client Secret Client Secret for Office 365 Outlook or Exchange

9 Resource Identifier for the Resource which you would like to use. Please enter value “https://graph.microsoft.com” for Office 365

10 Scope Scope of the OAuth Request Please enter no value into this field.

accallio OX Configuration

Name Description

1 Server Base Url Url of Office 365 Outlook & Exchange API.

Installation Guide for antegma accallio OX 1.0.0

6

Name Description

Please enter the value “https://outlook.office.com/api/v2.0”

2 Basic Authentication Method Process which is used to authenticate with Office 365 Outlook or Exchange: Please select value “OAuth2”

3 Basic authentication username Username for basic authentication.

4 Basic authentication password Password for basic authentication.

5 Keystore File Location File path to the Java Keystore, if self-signed certificates or different HOST information within SSL certificates are used.

6 Keystore Password Passwort for Java Keystore.

7 Server Connections Timeout Server Timeout configuration for REST Call to Office 365 Outlook or Exchange

8 STS Tenant Identifier Unique Identifier for the accallio STS configuration If you are using the accallio STS for Single Sign On, please enter the identifier of the corresponding STS configuration

9 OAuth2 Tenant Identifier Unique Identifier for the accallio Common OAuth2 configuration Please enter the value “microsoft-exchange”

accallio OX Graph Configuration

Name Description

1 Server Base Url Url of Office 365 Outlook & Exchange API. Please enter the value “https://graph.microsoft.com/v1.0”

2 Basic Authentication Method Process which is used to authenticate with Microsoft Graph: Please select value “OAuth2”

3 Basic authentication username Username for basic authentication.

4 Basic authentication password Password for basic authentication.

Installation Guide for antegma accallio OX 1.0.0

7

Name Description

5 Keystore File Location File path to the Java Keystore, if self-signed certificates or different HOST information within SSL certificates are used.

6 Keystore Password Passwort for Java Keystore.

7 Server Connections Timeout Server Timeout configuration for REST Call to Microsoft Graph

8 STS Tenant Identifier Unique Identifier for the accallio STS configuration If you are using the accallio STS for Single Sign On, please enter the identifier of the corresponding STS configuration

9 OAuth2 Tenant Identifier Unique Identifier for the accallio Common OAuth2 configuration Please enter the value “microsoft-graph”

Installation Guide for antegma accallio OX 1.0.0

8

Create a service user for accallio To write and read information from the Adobe Experience Manager Repository, accallio Common provide a generic repository helper.

Starting with AEM 6.0, the repository helper needs a service user with corresponding permissions to read and write informations into the repository.

Create service user

Open http://localhost:4502/crx/explorer and check that you login as admin or login as admin

Installation Guide for antegma accallio OX 1.0.0

9

Create a new service user: accallioRepositoryHelper

Add Service User Mapping

Open http://localhost:4502/system/console/configMgr add a new Apache Sling Service User Mapper Service Amendment

Installation Guide for antegma accallio OX 1.0.0

10

Add permissions of service user

Open http://localhost:4502/useradmin open the user accallioRepositoryHelper and set the permission on /content and /home/users