{"type":"doc","content":[{"type":"paragraph","content":[{"text":"This section describes how to create a connected application in Salesforce, connect it to Pricefx, and set up authentication and application layout.","type":"text"}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{},"macroMetadata":{"macroId":{"value":"501ab56d-b37f-455e-bb55-7aec9c7169eb"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"3503a8d6-376b-48f0-bb8e-5420bafb760f"}},{"type":"heading","attrs":{"level":1},"content":[{"text":"Create a Connected Application","type":"text"}]},{"type":"paragraph","content":[{"text":"Take the following steps:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Log in to Salesforce as administrator.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Switch to Salesforce Classic view.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":23.0},"content":[{"type":"media","attrs":{"width":354,"id":"7592d2a8-58d3-4859-b052-e3385c87caa3","collection":"contentId-5482283637","type":"file","height":355},"marks":[{"type":"border","attrs":{"size":2,"color":"#091e4224"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Go to ","type":"text"},{"text":"Setup","type":"text","marks":[{"type":"strong"}]},{"text":" > ","type":"text"},{"text":"Build","type":"text","marks":[{"type":"strong"}]},{"text":" > ","type":"text"},{"text":"Create","type":"text","marks":[{"type":"strong"}]},{"text":" > ","type":"text"},{"text":"Apps","type":"text","marks":[{"type":"strong"}]},{"text":" > ","type":"text"},{"text":"Connected Apps","type":"text","marks":[{"type":"strong"}]},{"text":" and click the ","type":"text"},{"text":"New","type":"text","marks":[{"type":"strong"}]},{"text":" button.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":81.0},"content":[{"type":"media","attrs":{"width":2220,"id":"ae818a18-3583-47db-95ba-ab5940a6ccf0","collection":"contentId-5482283637","type":"file","height":952},"marks":[{"type":"border","attrs":{"size":2,"color":"#091e4224"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Fill in the following fields in the Basic Information section:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Connected App Name","type":"text","marks":[{"type":"strong"}]},{"text":" – The unique name of your application, e.g., Quote Configurator.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"API Name","type":"text","marks":[{"type":"strong"}]},{"text":" – Application name used by the API (cannot contain spaces or special characters), e.g., Quote_Configurator.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Contact Email ","type":"text","marks":[{"type":"strong"}]},{"text":"– support@pricefx.eu","type":"text"}]}]}]},{"type":"mediaSingle","attrs":{"layout":"center","width":48.0},"content":[{"type":"media","attrs":{"width":716,"id":"39421916-8ec5-4425-af2a-0853c26d8d42","collection":"contentId-5482283637","type":"file","height":271},"marks":[{"type":"border","attrs":{"size":2,"color":"#091e4224"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Check the ","type":"text"},{"text":"Enable OAuth Settings","type":"text","marks":[{"type":"strong"}]},{"text":" box and:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Enter the ","type":"text"},{"text":"Callback URL","type":"text","marks":[{"type":"strong"}]},{"text":": https://.pricefx.eu/ (it can be different, please ask the Pricefx support).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Add ","type":"text"},{"text":"Full access (full)","type":"text","marks":[{"type":"em"}]},{"text":" as ","type":"text"},{"text":"Selected OAuth Scope","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]}]},{"type":"mediaSingle","attrs":{"layout":"center","width":64.0},"content":[{"type":"media","attrs":{"width":967,"id":"1947c9c9-f63e-4c3a-becb-b02cc72adb57","collection":"contentId-5482283637","type":"file","height":609},"marks":[{"type":"border","attrs":{"size":2,"color":"#091e4224"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In the Web App Settings section: ","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Check the ","type":"text"},{"text":"Enable SAML","type":"text","marks":[{"type":"strong"}]},{"text":" box.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Enter ","type":"text"},{"text":"Entity Id","type":"text","marks":[{"type":"strong"}]},{"text":": https://","type":"text"},{"text":"","type":"text","marks":[{"type":"em"}]},{"text":".pricefx.eu/pricefx/","type":"text"},{"text":"","type":"text","marks":[{"type":"em"}]},{"text":"/saml/consume/","type":"text"},{"text":"","type":"text","marks":[{"type":"em"}]},{"text":"?RelayState=quoteConfigurator ","type":"text"},{"text":"(customization for your partition)","type":"text","marks":[{"type":"em"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Enter ","type":"text"},{"text":"ACS URL","type":"text","marks":[{"type":"strong"}]},{"text":": https://","type":"text"},{"text":"","type":"text","marks":[{"type":"em"}]},{"text":".pricefx.eu/pricefx/","type":"text"},{"text":"","type":"text","marks":[{"type":"em"}]},{"text":"/saml/consume/","type":"text"},{"text":"","type":"text","marks":[{"type":"em"}]},{"text":"?RelayState=quoteConfigurator ","type":"text"},{"text":"(customization for your partition)","type":"text","marks":[{"type":"em"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Leave the default settings for the other options.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":46.0},"content":[{"type":"media","attrs":{"width":652,"id":"44c6f2f2-557f-42cb-9567-de2336da7d23","collection":"contentId-5482283637","type":"file","height":300},"marks":[{"type":"border","attrs":{"size":2,"color":"#091e4224"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"It is possible to check the SAML configuration in a specific cluster to get some more information about how to prefill the Entity Id and ACS URL.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":88.0},"content":[{"type":"media","attrs":{"width":1859,"id":"c8eaef83-b001-497f-a204-177a2ff55df9","collection":"contentId-5482283637","type":"file","height":883},"marks":[{"type":"border","attrs":{"size":2,"color":"#091e4224"}}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In the Canvas App Settings section, enable the ","type":"text"},{"text":"Canvas","type":"text","marks":[{"type":"strong"}]},{"text":" option and:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Enter the ","type":"text"},{"text":"Canvas App URL","type":"text","marks":[{"type":"strong"}]},{"text":": https://","type":"text"},{"text":"","type":"text","marks":[{"type":"em"}]},{"text":".pricefx.eu/ ","type":"text"},{"text":"(it can be different, please ask Pricefx support)","type":"text","marks":[{"type":"em"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Leave ","type":"text"},{"text":"Signed Request (POST)","type":"text","marks":[{"type":"em"}]},{"text":" as ","type":"text"},{"text":"Access Method","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Select ","type":"text"},{"text":"Identity Provider Initiated","type":"text","marks":[{"type":"em"}]},{"text":" as ","type":"text"},{"text":"SAML Initiation Method","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Select ","type":"text"},{"text":"Visualforce Page","type":"text","marks":[{"type":"em"}]},{"text":" and ","type":"text"},{"text":"Mobile Nav","type":"text","marks":[{"type":"em"}]},{"text":" as ","type":"text"},{"text":"Locations","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":48.0},"content":[{"type":"media","attrs":{"width":646,"id":"a0765581-c904-4bd6-b1dd-a2c0ecbe28fc","collection":"contentId-5482283637","type":"file","height":338},"marks":[{"type":"border","attrs":{"size":2,"color":"#091e4224"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Save the settings.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Go to ","type":"text"},{"text":"Build","type":"text","marks":[{"type":"strong"}]},{"text":" > ","type":"text"},{"text":"Create","type":"text","marks":[{"type":"strong"}]},{"text":" > ","type":"text"},{"text":"Apps","type":"text","marks":[{"type":"strong"}]},{"text":" > ","type":"text"},{"text":"Connected Apps","type":"text","marks":[{"type":"strong"}]},{"text":" and find your new application in the list and press ","type":"text"},{"text":"Manage","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click ","type":"text"},{"text":"Edit Policies","type":"text","marks":[{"type":"strong"}]},{"text":" and set ","type":"text"},{"text":"All users may self-authorize","type":"text","marks":[{"type":"strong"}]},{"text":" to ","type":"text"},{"text":"Admin approved users are pre-authorized","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click ","type":"text"},{"text":"Save","type":"text","marks":[{"type":"strong"}]},{"text":" and in the list of applications click your application's name.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click ","type":"text"},{"text":"Manage","type":"text","marks":[{"type":"strong"}]},{"text":" and in the ","type":"text"},{"text":"Profiles","type":"text","marks":[{"type":"strong"}]},{"text":" section, click ","type":"text"},{"text":"Manage Profiles","type":"text","marks":[{"type":"strong"}]},{"text":" and add all profiles which will use this application.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":56.0},"content":[{"type":"media","attrs":{"width":921,"id":"d962cbb6-c1b5-4853-a9f0-eb71cdb94323","collection":"contentId-5482283637","type":"file","height":100},"marks":[{"type":"border","attrs":{"size":2,"color":"#091e4224"}}]}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Create a Visualforce Page","type":"text"}]},{"type":"paragraph","content":[{"text":"Take the following steps:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Open the Developer console (","type":"text"},{"text":"Setup","type":"text","marks":[{"type":"strong"}]},{"text":" > ","type":"text"},{"text":"Developer Console","type":"text","marks":[{"type":"strong"}]},{"text":") and go to ","type":"text"},{"text":"File","type":"text","marks":[{"type":"strong"}]},{"text":" > ","type":"text"},{"text":"New","type":"text","marks":[{"type":"strong"}]},{"text":" > ","type":"text"},{"text":"Visualforce Page","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Enter the name of the page, e.g., Quote_Configurator.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In the editor, enter the following markup for the page (with the appropriate applicationName value):","type":"text"}]},{"type":"codeBlock","content":[{"text":"\n \n","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click ","type":"text"},{"text":"File","type":"text","marks":[{"type":"strong"}]},{"text":" > ","type":"text"},{"text":"Save","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Go to ","type":"text"},{"text":"Setup","type":"text","marks":[{"type":"strong"}]},{"text":" > ","type":"text"},{"text":"Build","type":"text","marks":[{"type":"strong"}]},{"text":" > ","type":"text"},{"text":"Create","type":"text","marks":[{"type":"strong"}]},{"text":" > ","type":"text"},{"text":"Tabs","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In the Visualforce Tabs section, click ","type":"text"},{"text":"New","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Select the Visualforce page that you have created previously.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Enter the label (e.g., Quote Configurator) and the name (e.g., Quote_Configurator) of the new tab.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":48.0},"content":[{"type":"media","attrs":{"width":686,"id":"e85940d1-af74-4651-b71d-dd7d501216a0","collection":"contentId-5482283637","type":"file","height":182},"marks":[{"type":"border","attrs":{"size":2,"color":"#091e4224"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click ","type":"text"},{"text":"Next","type":"text","marks":[{"type":"strong"}]},{"text":" and select the profiles for which the tab will be available.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click ","type":"text"},{"text":"Next","type":"text","marks":[{"type":"strong"}]},{"text":" and select the custom apps for which the tab will be available.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click ","type":"text"},{"text":"Save","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Go to ","type":"text"},{"text":"Setup","type":"text","marks":[{"type":"strong"}]},{"text":" > ","type":"text"},{"text":"Visualforce Pages","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Select your created page.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click ","type":"text"},{"text":"Security","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":73.0},"content":[{"type":"media","attrs":{"width":2604,"id":"7115e366-5d38-41d3-bd89-3066c6ce7d38","collection":"contentId-5482283637","type":"file","height":1350},"marks":[{"type":"border","attrs":{"size":2,"color":"#091e4224"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Add all the required profiles.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":56.0},"content":[{"type":"media","attrs":{"width":1540,"id":"856f094f-9710-4cc7-8a83-4d1f3a534d74","collection":"contentId-5482283637","type":"file","height":1022},"marks":[{"type":"border","attrs":{"size":2,"color":"#091e4224"}}]}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"One Canvas App for All Partitions","type":"text"}]},{"type":"paragraph","content":[{"text":"Instead of having one canvas app for each partition, you can have a configuration in which there is just one app that redirects the user to the correct partition.","type":"text"}]},{"type":"paragraph","content":[{"text":"In this configuration, the app's URL does not point to a concrete partition but to 'system'. For example:","type":"text"}]},{"type":"paragraph","content":[{"text":"https://pricefx.eu/pricefx/system/saml/consume?RelayState=quoteConfigurator&applicationEnvironment=salesforce","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"When this request is sent to Pricefx, it is consumed by 'system' SAML Consume service. This backend service resolves the target partition based on the user ID or email address. The service utilizes a user-partition map and redirects the authenticated user to the partition where the user has an account.","type":"text"}]},{"type":"paragraph","content":[{"text":"In cases when the same email address or user ID exists in multiple partitions (e.g., IT support users), the user will be redirected to a so called \"preferred partition\". The preferred partition is set on the Pricefx side as a feature flag. ","type":"text"}]},{"type":"paragraph","content":[{"text":"Note","type":"text","marks":[{"type":"strong"}]},{"text":": This solution is suitable only for customer dedicated clusters.","type":"text"}]}],"version":1}

Browser not supported