{"type":"doc","content":[{"type":"paragraph","content":[{"text":"With the upgrade to version Manhattan 4.0, we want to unify and simplify the infrastructure by removing the ProxyPath step. Therefore, together with the upgrade of the backend Pricefx server to Manhattan 4.x, Unity should be deployed locally (deployPricefxApp command) to private clusters.","type":"text"}]},{"type":"paragraph","content":[{"text":"The legacy infrastructure looks like this:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":58.0},"content":[{"type":"media","attrs":{"width":902,"id":"f86bdf44-57dd-4241-b817-48b8f5cfaf77","collection":"contentId-5482807952","type":"file","height":368}}]},{"type":"paragraph","content":[{"text":"And this is the new simplified model:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":58.0},"content":[{"type":"media","attrs":{"width":908,"id":"fd6f2c19-aa24-4f33-8a12-95a2d14771c3","collection":"contentId-5482807952","type":"file","height":160}}]},{"type":"paragraph","content":[{"text":"What does it mean for you?","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If you use /unity/* paths and especially if you use generic domains like sfdc.pricefx.eu, dynamics.pricefx.eu or c4c.dynamics.pricefx.eu, this means that you will have to ","type":"text"},{"text":"adjust the settings in the CRM application","type":"text","marks":[{"type":"strong"}]},{"text":" (e.g., Salesforce). The ACS URL, entity ID or callback URL must point to your cluster domain, not the generic domains.","type":"text"},{"type":"hardBreak"},{"text":"The main changes are:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"relayStateURLs should use /app/ instead of /unity/master/*","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"ACS URLs should point to .pricefx.eu/pricefx/[PARTITION]/saml/consume/[CONFIGURATION]/RelayState=[RELAY_STATE]. The same applies to the Canvas URL. These URLs ","type":"text"},{"text":"must not point to the sfdc.pricefx.eu domain","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If you use an external identity provider (Okta, Azure, etc.), you should check their settings too and adjust them if necessary.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Please follow the steps provided below for a smooth upgrade to version 4.0.","type":"text"}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{},"macroMetadata":{"macroId":{"value":"c698dfe8-2fc0-4910-8c58-9bd33f25e826"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"5e75be44-7ea6-42eb-8250-8ef59e03661f"}},{"type":"heading","attrs":{"level":1},"content":[{"text":"Prerequisites","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Pricefx Operations have installed Unity on the client's cluster.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Pricefx Operations have set the alias for the app.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Update SAML Configuration in Pricefx Partition","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Login to the partition with an admin account.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Go to ","type":"text"},{"text":"Administration","type":"text","marks":[{"type":"strong"}]},{"text":" > ","type":"text"},{"text":"Configuration","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Scroll down to the section ","type":"text"},{"text":"External Systems","type":"text","marks":[{"type":"strong"}]},{"text":" > ","type":"text"},{"text":"SAML Configuration","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":89.0},"content":[{"type":"media","attrs":{"width":1343,"id":"30f21d76-bdbf-4cc8-aee5-613ee21c1bf8","collection":"contentId-5482807952","type":"file","height":585},"marks":[{"type":"border","attrs":{"size":2,"color":"#091e4224"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Select the SAML Configuration, usually called \"","type":"text"},{"text":"DEFAULT","type":"text","marks":[{"type":"strong"}]},{"text":"\" and then scroll down to find the ","type":"text"},{"text":"Relay States","type":"text","marks":[{"type":"strong"}]},{"text":" section at the bottom of the page.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Edit the ","type":"text"},{"text":"relayStateURL","type":"text","marks":[{"type":"strong"}]},{"text":" so that it has the following format:","type":"text"},{"type":"hardBreak"},{"text":"https:///app/?partition=&applicationEnvironment=salesforce&confName=","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"For example: ","type":"text"},{"type":"hardBreak"},{"text":"https://abc-qa.pricefx.eu/app/?partition=company_qa&applicationEnvironment=salesforce&confName=unity_config_qa","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Save the changes.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Update Salesforce App Configuration","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Login to Salesforce with an admin account.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":89.0},"content":[{"type":"media","attrs":{"width":1843,"id":"e594c1c4-4da1-4e1c-b18b-3a6fb7fd12cf","collection":"contentId-5482807952","type":"file","height":441},"marks":[{"type":"border","attrs":{"size":2,"color":"#091e4224"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click on the ","type":"text"},{"text":"Setup","type":"text","marks":[{"type":"strong"}]},{"text":" icon and open the Setup page.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":23.0},"content":[{"type":"media","attrs":{"width":327,"id":"af61fbbb-a938-4b06-baa2-2bbed172f2dd","collection":"contentId-5482807952","type":"file","height":346},"marks":[{"type":"border","attrs":{"size":2,"color":"#091e4224"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In the Setup menu navigate to ","type":"text"},{"text":"Platform Tools","type":"text","marks":[{"type":"strong"}]},{"text":" > ","type":"text"},{"text":"Apps","type":"text","marks":[{"type":"strong"}]},{"text":" > ","type":"text"},{"text":"App Manager","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"},{"type":"hardBreak"},{"text":"A list of all the Managed Apps will be displayed.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":89.0},"content":[{"type":"media","attrs":{"width":1920,"id":"25d358ba-5adf-4e33-b5d5-62075e5e798d","collection":"contentId-5482807952","type":"file","height":655},"marks":[{"type":"border","attrs":{"size":2,"color":"#091e4224"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"On the right-hand side of the list, there is a down arrow. Click on it and select ","type":"text"},{"text":"Edit","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":89.0},"content":[{"type":"media","attrs":{"width":1628,"id":"c9590eca-25ab-4c68-b466-897f0d0b5fa7","collection":"contentId-5482807952","type":"file","height":208},"marks":[{"type":"border","attrs":{"size":2,"color":"#091e4224"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"You are now on the Setup page for that App. Scroll down to the Web App Settings section to find the ","type":"text"},{"text":"Entity ID","type":"text","marks":[{"type":"strong"}]},{"text":" and the ","type":"text"},{"text":"ACS URL","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":73.0},"content":[{"type":"media","attrs":{"width":1027,"id":"1e9a835f-43ca-4657-bc4c-0095498a54bc","collection":"contentId-5482807952","type":"file","height":506},"marks":[{"type":"border","attrs":{"size":2,"color":"#091e4224"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Update the ","type":"text"},{"text":"Entity ID","type":"text","marks":[{"type":"strong"}]},{"text":" and the ","type":"text"},{"text":"ACS URL","type":"text","marks":[{"type":"strong"}]},{"text":" so that they have the following format:","type":"text"},{"type":"hardBreak"},{"text":"https:///pricefx//saml/consume?RelayState=","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"For example:","type":"text"},{"type":"hardBreak"},{"text":"https://abc-qa.pricefx.eu/pricefx/company_qa/saml/consume?RelayState=quoteConfigurator","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Scroll down to Canvas App Settings.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":48.0},"content":[{"type":"media","attrs":{"width":756,"id":"967caba1-2d12-48c0-8922-3c4cf08a8504","collection":"contentId-5482807952","type":"file","height":872},"marks":[{"type":"border","attrs":{"size":2,"color":"#091e4224"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Update the ","type":"text"},{"text":"Canvas App URL","type":"text","marks":[{"type":"strong"}]},{"text":" so that it has the following format:","type":"text"},{"type":"hardBreak"},{"text":"https:///","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"For example:","type":"text"},{"type":"hardBreak"},{"text":"https://abc-qa.pricefx.eu","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Save the changes.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Note","type":"text","marks":[{"type":"strong"}]},{"text":": Verify that you can load the page in Salesforce. If you cannot load the page, please take screen shots of each screen detailed above and open a support ticket. You may also check the IdP Certificate in Web App Settings – ensure that the setting is correct. The \"Default IdP Certificate\" may be set there and this may not be the latest/correct certificate. Consult you Salesforce Admin about which one to use.","type":"text"}]},{"type":"paragraph","content":[{"type":"emoji","attrs":{"id":"atlassian-warning","text":":warning:","shortName":":warning:"}},{"text":" If you are migrating Salesforce Classic the steps will be slightly different and there might be some caching of the Relay State. So you need to also change the name of the relay state in the SAML Config on the partition to _new which forces Salesforce Classic to update its settings.","type":"text"}]}],"version":1}

Browser not supported