Alfrodin: configuration for "Edit in Office" (Alfresco Office Services, AOS)
Release 2026-09-28, https://alfrodin.com
Copyright (c) 2026 Matthias Bauernberger Software

The step-by-step guide is appendix A of the Alfrodin product manual at
https://alfrodin.com/setup.html#documentation. The folders match its sections.

A1-metadata-copy     Microsoft Entra ID only: copy of the Entra metadata with the Alfresco scope
                       create-metadata-copy.sh
                       etc/nginx/conf.d/alfresco-oidc-metadata.conf
                       alfresco-global.properties.txt (lines to add)
A2-startup-options   Java system properties for the start of Alfresco
A3-session-store     Sign-in of Office managed in the proxy (nginx with the njs module),
                     required for Office for Mac, recommended for Windows:
                       etc/nginx/njs/aos_session.js          to /etc/nginx/njs/
                       etc/nginx/conf.d/00-aos-session.conf  to /etc/nginx/conf.d/
                       etc/nginx/snippets/aos-session.conf   to /etc/nginx/snippets/
                       server-block-locations.conf           into the server block of Alfresco
                     The sessions live in the memory of one nginx: run one nginx per
                     Alfresco address, or bind each client to one nginx at the load
                     balancer (for example by source IP). After a switch, users sign
                     in to Office once more.
A4-checks            Commands to check the configuration

Placeholders: <host> public name of the Alfresco server, <TENANT-ID> tenant ID,
<CLIENT-ID> application ID of the app registration, repo_lb your upstream to Alfresco (Tomcat).

Tested with Alfresco Community 25.3 (AOS module 3.4.0), nginx 1.24 with njs 0.8.2
(Ubuntu 24.04), Microsoft Entra ID, Microsoft Office for Mac 16.111 and Microsoft 365
for Windows (Word, Excel, PowerPoint).

License and use: the files in this package are licensed under the MIT License
(LICENSE.txt). They are provided as is, without warranty or guarantee of any kind and
without any entitlement to support. Using them is the sole responsibility of the
customer. The license covers the files in this package only; Alfrodin(R) is a registered
trademark, and the license grants no rights to it.
