Installation Guide for antegma accallio OX Version 1.0

Transcription

1 Installation Guide for antegma accallio OX Version 1.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 2

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 AEM 6.4 AEM 6.3 AEM 6.2 AEM 6.1 AEM 6.0 Content Package accallio-ca-installer-aem snapshot.zip accallio-ca-installer-aem snapshot.zip accallio-ca-installer-aem snapshot.zip accallio-ca-installer-aem snapshot.zip accallio-ca-installer-aem 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 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. 3

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. Office 365 Outlook & Exchange REST API 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 for Office Scope Scope of the OAuth Request 4

5 Microsoft Graph for Access to Office365 People API 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. 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 for Office Scope Scope of the OAuth Request accallio OX Configuration 1 Server Base Url Url of Office 365 Outlook & Exchange API. 5

6 Please enter the value 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 1 Server Base Url Url of Office 365 Outlook & Exchange API. Please enter the value 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. 6

7 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 7

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 and check that you login as admin or login as admin 8

9 Create a new service user: accalliorepositoryhelper Add Service User Mapping Open add a new Apache Sling Service User Mapper Service Amendment 9

10 Add permissions of service user Open open the user accalliorepositoryhelper and set the permission on /content and /home/users 10