How To
ForgeRock Identity Platform
Does not apply to Identity Cloud
How do I configure AM (All versions) as an IdP when going through a proxy?
The purpose of this article is to provide information on configuring AM as a hosted IdP when going through a proxy, such as a load balancer. It assumes you have already created the hosted IdP.
1 reader recommends this article
Configuring AM
When you create a hosted IdP in AM, the server name is automatically used as the hostname for the IdP. If you go through a proxy or load balancer, you need to update all pre-populated instances of the hostname with the name of your proxy or load balancer.
The following URLs are used in this example:
- Server name - https://am.example.com:8443/am
- Load balancer name - https://lb.example.com:443/am
You can configure AM as follows:
- Back up AM configuration as described in Back up configurations (AM 7 and later) or How do I make a backup of configuration data in AM 6.x?
- Export the IdP's standard and extended metadata files using the following ssoadm command: $ ./ssoadm export-entity -u [adminID] -f [passwordfile] -e [realmname] -y [entityID] -c saml2 -m [metadataXMLfile] -x [extendedXMLfile]replacing [adminID], [passwordfile], [realmname], [entityID], [metadataXMLfile] and [extendedXMLfile] with appropriate values.
- Update all the Service location URLs in the standard metadata file by replacing the server name part of the URL with the proxy name instead. For example, the ArtifactResolutionService looked like this before the change: <ArtifactResolutionService index="0" isDefault="true" Binding="urn:oasis:names:tc:SAML:2.0:bindings:SOAP" Location="https://am.example.com:8443/am/ArtifactResolver/metaAlias/idp"/> and like this after the change: <ArtifactResolutionService index="0" isDefault="true" Binding="urn:oasis:names:tc:SAML:2.0:bindings:SOAP" Location="https://lb.example.com:443/am/ArtifactResolver/metaAlias/idp"/>
- Update any URLs (other than the entityID) in the extended metadata file by replacing the server name part of the URL with the proxy name instead. For example, the saeIDPUrl would now look like this after the change: <Attribute name="saeIDPUrl"> <Value>https://lb.example.com:443/am/idpsaehandler/metaAlias/idp</Value> </Attribute>
- Remove the hosted IdP configuration from AM before importing the modified metadata files using the following ssoadm command: $ ./ssoadm delete-entity -u [adminID] -f [passwordfile] -e [realmname] -y [entityID] -c saml2replacing [adminID], [passwordfile], [realmname] and [entityID] with appropriate values.
- Import the modified IdP's standard and extended metadata files into AM using the following ssoadm command: $ ./ssoadm import-entity -u [adminID] -f [passwordfile] -e [realmname] -t [entityCOT] -c saml2 -m [metadataXMLfile] -x [extendedXMLfile] replacing [adminID], [passwordfile], [realmname], [entityCOT], [metadataXMLfile] and [extendedXMLfile] with appropriate values.
See Also
Related Training
N/A
Related Issue Tracker IDs
N/A