|
1 | | -# Universal Editor Sample App |
| 1 | +# Adobe Universal Editor Sample App |
2 | 2 |
|
3 | 3 | ## Using the Sample App |
4 | | -This Sample App is hosted at https://ue-remote-app.adobe.net. |
5 | | -Per Default the content is retrieved and written back to our Production Demo Environment: |
6 | | -``` |
7 | | -authorHost=https://author-p7452-e12433.adobeaemcloud.com |
8 | | -publishHost=https://publish-p7452-e12433.adobeaemcloud.com |
9 | | -service=<null> // using defualt built in Universal Editor |
10 | | -protocol=aem // protocol to work on AEMCS |
11 | | -``` |
12 | | -If you'd like to retrieve content from another environment add authorHost & publishHost as query parameters, e.g. |
| 4 | +The Sample App is hosted at https://ue-remote-app.adobe.net. |
| 5 | +Per Default the content is retrieved and written back to the Adobe Experience Manager as a Cloud Service ( Production ) Demo Environment: |
13 | 6 |
|
14 | | -[https://ue-remote-app.adobe.net?authorHost=https://author-p15902-e145656-cmstg.adobeaemcloud.com&publishHost=https://publish-p15902-e145656-cmstg.adobeaemcloud.com](https://ue-remote-app.adobe.net?authorHost=https://author-p15902-e145656-cmstg.adobeaemcloud.com&publishHost=https://publish-p15902-e145656-cmstg.adobeaemcloud.com) |
| 7 | +The default settings from [.env](.env) can be overwritten using Query parameters: |
| 8 | +* `authorHost`: host to retrieve data from and update content to; default=https://author-p7452-e12433.adobeaemcloud.com |
| 9 | +* `service`: Universal Editor Service endpoint; default Universal Editor default |
| 10 | +* `protocol`: protocol to use with backend, can be `aem`, `aem65`, `aemcsLegacy`; default: `aem` |
| 11 | +* `cors`: defining which cors.js - connection between Universal Editor and application shall be used. Can be `stage` or empty; default `null/empty`. `stage` will use the cors library hosted on stage, else it will use the production version |
15 | 12 |
|
16 | | -respectively if run on local dev environment: |
| 13 | +To retrieve content from another environment add `authorHost` as query parameters, e.g. |
17 | 14 |
|
18 | | -[https://localhost:3000?authorHost=https://author-p15902-e145656-cmstg.adobeaemcloud.com&publishHost=https://publish-p15902-e145656-cmstg.adobeaemcloud.com](https://localhost:3000?authorHost=https://author-p15902-e145656-cmstg.adobeaemcloud.com&publishHost=https://publish-p15902-e145656-cmstg.adobeaemcloud.com) |
| 15 | +[https://ue-remote-app.adobe.net?authorHost=https://author-p7452-e12433.adobeaemcloud.com](https://ue-remote-app.adobe.net?authorHost=https://author-p7452-e12433.adobeaemcloud.com) |
19 | 16 |
|
20 | | -## Prerequisites |
| 17 | +Similarly, if running the Universal Editor App on local dev environment, add `authorHost` as query parameters like this: |
21 | 18 |
|
22 | | -- AEMCS instance is available |
23 | | -- WKND project is installed on the instance |
24 | | -- CORS enabled on AEM instance for the app |
25 | | -- For local development with editor, ensure app is using *https* |
| 19 | +[https://localhost:3000?authorHost=https://localhost:8443&service=https://localhost:8443/universal-editor](https://localhost:3000?authorHost=https://localhost:8443&service=https://localhost:8443/universal-editor) |
| 20 | + |
| 21 | +## Run locally |
| 22 | + |
| 23 | +- AEM 6.5 or AEMCS instance |
| 24 | +- Latest WKND Content installed on the AEM instance[https://github.com/adobe/aem-guides-wknd/releases/latest](https://github.com/adobe/aem-guides-wknd/releases/latest) |
| 25 | +- AEM configured to run on HTTPS [https://experienceleague.adobe.com/en/docs/experience-manager-learn/foundation/security/use-the-ssl-wizard](https://experienceleague.adobe.com/en/docs/experience-manager-learn/foundation/security/use-the-ssl-wizard) |
| 26 | +- `Adobe Granite Token Authentication Handler` configured to set `token.samesite.cookie.attr=Partitioned` |
| 27 | +- Remove `X-FRAME-Options=SAMEORIGIN` from `Apache Sling Main Servlet`'s `sling.additional.response.headers` attribute if run locally |
| 28 | +- Add policy for `https://localhost:3000` to `Adobe Granite Cross-Origin Resource Sharing Policy`. The default `adobe` configuraiton can be used as blueprint if run local copy of the app |
| 29 | +- Follow configuration on [https://github.com/maximilianvoss/universal-editor-service-proxy](https://github.com/maximilianvoss/universal-editor-service-proxy) for local development set up |
| 30 | +- Open Universal Editor either |
| 31 | + - under AEM domain for AEMCS, e.g. [https://author-p7452-e12433.adobeaemcloud.com/ui#/aem/universal-editor/canvas/](https://author-p7452-e12433.adobeaemcloud.com/ui#/aem/universal-editor/canvas/) |
| 32 | + - or on [https://experience.adobe.com/#/aem/editor/canvas/](https://experience.adobe.com/#/aem/editor/canvas/) |
| 33 | +- For experience.adobe.com use the `Local Developer Login` to authenticate against your local AEM instance when using a local SDK or AEM 6.5 |
26 | 34 |
|
27 | 35 | ## Available Scripts |
28 | 36 |
|
@@ -72,5 +80,3 @@ Run in project root: |
72 | 80 |
|
73 | 81 | `npm run deploy prod` - deploy the app to the production link https://ue-remote-app.adobe.net (this is usually not needed, the application is automatically deployed on every PR merged to the `main` branch). |
74 | 82 |
|
75 | | -If case of permission issues, run `chmod +x deploy/script.sh` at the root of the project. |
76 | | - |
|
0 commit comments