Search for	Example	Results
A single word	`cat`	Topics that contain the word "cat". You will also find its grammatical variations, such as "cats".
A phrase. You can specify that the search results contain a specific phrase.	`"cat food"` (quotation marks)	Topics that contain the literal phrase "cat food" and all its grammatical variations. Without the quotation marks, the query is equivalent to specifying an OR operator, which finds topics with one of the individual words instead of the phrase.

Search for	Operator	Example
Two or more words in the same topic	`AND` `and` `+` (plus symbol) `&` (ampersand)	`cat AND dog` `"cat food"+milk` `"cat food"&"dog food"`
Either word in a topic	`OR` `or` `\|` (pipe)	`cat OR dog` `cat \| dog`
Topics that do not contain a specific word or phrase	`NOT` `not` `!` (exclamation point)	`NOT cat` `! dog`
Topics that contain one string and do not contain another	`^` (caret)	`cat ^ mouse`
A combination of search types	`( )` parentheses	`cat + (dog \| mouse)` `cat \| dog + (! mouse)`

Service Manager9.52

Administer > System security > SAML Single Sign-On > SAML SSO setup > Configure SAML SSO using the standalone IdM > Configure IdM authentication in the Service Manager web tier

Configure IdM authentication in the Service Manager web tier

You only need to update the WEB-INF/webtier.properties file to enable HPE Identity Manager (IdM) authentication in the web tier.

To enable IdM authentication in the web tier, follow these steps:

Stop the web application server.

Open the WEB-INF/web.xml file in a text editor, and check that the LW-SSO filter mapping and filter are commented out as shown below.

Note You must not enable both SAML SSO and LW-SSO for Service Manager. This step will disable LW-SSO.

<!--
  <filter-mapping>
    <filter-name>LWSSO</filter-name>
    <url-pattern>/*</url-pattern>
  </filter-mapping>
-->


<!--
  <filter>
    <filter-name>LWSSO</filter-name>
    <filter-class>com.hp.sw.bto.ast.security.lwsso.LWSSOFilter</filter-class>
  </filter>
-->

Open the WEB-INF/webtier.properties file in a text editor, and then specify the following parameters.

Tip For more information about IdM parameters, see Install and configure the standalone IdM service.

Parameter	Default	Description
idm.sso.enabled	false	Indicates if IdM SSO is enabled. To enable IdM SSO, set this parameter to true.
idm.tenant	N/A	The tenant in which all Service Manager user accounts will reside. This parameter value must match the tenant configured on the IdM service side: For the standalone IdM, you can find the tenant configuration in Install and configure the standalone IdM service; For the Service Portal IdM, the tenant is the name of the organization configured for Service Manager (which you can find from the Identity application).
idm.token.signingKey	N/A	This is the key used to sign IdM tokens. This parameter value must match the idm.encryptedSigningKey value defined in the \WEB-INF\string\applicationContext.properties file of the IdM service.
idm.endpoint	N/A	This is the absolute URL of the IdM service. For example: https://localhost:8443/idm-service.
idm.http.user idm.http.password	N/A	This is the user account used to access the IdM service. These parameter values must match the values of the integrationAcctUserName property and integrationAcctPassword property that are specified in the WEB-INF\spring\applicationContext.xml file of the IdM service.
idm.ssl.trustAll	false	Indicates whether to verify that the IdM server certificate is trusted. To verify the IdM server certificate, keep the default value (false).
idm.truststore idm.truststore.password	N/A	This is the IdM client trust store and password. The IdM client uses this file to validate the IdM server certificate. For more information, see (Optional) Create an IdM client trust store. Note You must specify these two parameters if the idm.ssl.trustAll parameter is set to false.
isCustomAuthenticationUsed	true	To enable SAML SSO, set this parameter to false. Note The web tier configuration file (web.xml) also contains this parameter (default: true). The setting in the WEB-INF/webtier.properties file overrides the setting in the web.xml file.
idm.returnUri	N/A	The absolute URL of the Web client to which the IdM service will return after successful authentication. It must not contain the servlet path (*.do). Example: https://www.example.com/webtier-9.x Note Normally, this parameter is not required. Only when the application server is deployed behind a web server (for example, Apache or IIS) or proxy, if the web tier cannot get the host name and port of the web server or proxy, or if the web tier context path is mapped to a different URI in the web server or proxy, you must set this parameter.

The following is an example.

idm.sso.enabled=true
idm.tenant=IDM-SM
idm.token.signingKey=awscd456!
idm.endpoint=https://localhost:8443/idm-service
idm.http.user=idmTransportUser
idm.http.password=idmTransportUser
idm.ssl.trustAll=false
idm.truststore=/WEB-INF/trustStore.keystore
idm.truststore.password=tomcat1
isCustomAuthenticationUsed=false

Restart the web application server.

Once the web application server is restarted, the idm.http.password, idm.token.signingKey, and idm.truststore password parameter values are automatically encrypted.

Note Later when you need to update any of these values, you need to change the old encrypted value to your new value, and then restart the web application server. The new value you have entered is automatically encrypted.

Send Help Center feedback