Installation Guide for antegma accallio SP 1.0.0 Version 1.0
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 Fehler! Textmarke nicht definiert. CREATE A SERVICE USER FOR ACCALLIO 6 Create service user 6 Add Service User Mapping 7 Add permissions of service user 8 2
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 SP 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 Name accallio-sp-installer-aem64-1.0.0.zip accallio-sp-installer-aem63-1.0.0.zip accallio-sp-installer-aem62-1.0.0.zip accallio-sp-installer-aem61-1.0.0.zip accallio-sp-installer-aem60-1.0.0.zip All customers which have licensed antegma accallio SP have access to antegma Nexus Server. Install content package via AEM Package Manager Install the accallio SP installer 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-sp-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. 3
Configuration of accallio inside of AEM OSGI Console antegma accallio Common OAuth2 Configuration To access the REST API of SharePoint REST API, you have to setup an OAuth Configuration. When using Office 365 SharePoint, you can create the necessary configuration using the Azure Portal. https://docs.microsoft.com/en-us/azure/active-directory/develop/howto-create-serviceprincipal-portal Office 365 SharePoint REST API Name Description 1 Tenant Identifier Unique ID for the OAuth Configuration Please enter the value microsoft-sharepoint 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 SharePoint or SharePoint 8 Client Secret Client Secret for Office 365 SharePoint or SharePoint 9 Resource Identifier for the Resource which you would like to use. Please enter value https://{tenant}.sharepoint.com for Office 365 SharePoint Replace {tenant} with the name of your Office 365 SharePoint tenant. 4
Name Description 10 Scope Scope of the OAuth Request Please enter no value into this field. accallio SP Configuration Name Description 1 Server Base Url Url of Office 365 SharePoint API. Please enter value https://{tenant}.sharepoint.com for Office 365 SharePoint Replace {tenant} with the name of your Office 365 SharePoint tenant. 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-shareppoint 5
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 6
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 7
Add permissions of service user Open http://localhost:4502/useradmin open the user accalliorepositoryhelper and set the permission on /content and /home/users 8