Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

This section lists the prerequisites and steps for applying and verifying this patch.

...

  1. Go to …<ConnectPortalInstallFolder>\conf location.
  2. Open server.xml filand do the following changes:
    1. Add parameter secretRequired="false" in Connector tag for AJP.



    2. Copy Expand the section below to copy and paste the code in service section as shown below and paste in the existing server.xml file.

      Code Block
      collapsetrue
      <Service name="SoapService">
      	
      			<!-- 
      			<Connector port="80" protocol="HTTP/1.1" connectionTimeout="20000"
      			redirectPort="443" compression="on" noCompressionUserAgents="gozilla, 
      			traviata" compressableMimeType="text/html,text/xml,text/css,application/javascript,application/json" 
      			useSendfile="false" server="Adeptia" xpoweredby="false" />
      			 -->
      			
      			<!-- 
      			<Connector port="443" protocol="HTTP/1.1" SSLEnabled="true" maxThreads="5000" 
      			scheme="https" secure="true" compressionMinSize="128" connectionTimeout="20000" 
      			maxConnections="10000" clientAuth="false" sslProtocol="TLSv1.2" sslEnabledProtocols="TLSv1.2" keystoreFile="./keystore/adeptiaBPM.keystore" 
      			keystoreType="JKS" keystorePass="password" compression="on" noCompressionUserAgents="gozilla, 
      			traviata" compressableMimeType="text/html,text/xml,text/css,application/javascript,application/json" 
      			useSendfile="false" server="Adeptia" xpoweredby="false" />
      			-->
      			
      			<Engine defaultHost="localhost" name="soapwebapps">
      			
      				<Realm className="org.apache.catalina.realm.LockOutRealm">
      					<Realm className="org.apache.catalina.realm.UserDatabaseRealm" resourceName="UserDatabase"/>
      				</Realm>
      				
      				<Host appBase="soapwebapps/wars" autoDeploy="true" name="localhost" unpackWARs="true">
      					<Valve className="org.apache.catalina.valves.AccessLogValve" directory="logs" pattern="%h %l %u %t &quot;%r&quot; %s %b" prefix="localhost_access_log" suffix=".txt"/>
      					<Valve className="org.apache.catalina.valves.ErrorReportValve" showReport="false" showServerInfo="false"/>
      				</Host>
      				
      			</Engine>
      	</Service>
      	
      	  <Service name="RestService">
      	
      			<!-- 
      			<Connector port="80" protocol="HTTP/1.1" connectionTimeout="20000"
      			redirectPort="443" compression="on" noCompressionUserAgents="gozilla, 
      			traviata" compressableMimeType="text/html,text/xml,text/css,application/javascript,application/json" 
      			useSendfile="false" server="Adeptia" xpoweredby="false" />
      			-->
      			
      			<!-- 
      			<Connector port="443" protocol="HTTP/1.1" SSLEnabled="true" maxThreads="5000" 
      			scheme="https" secure="true" compressionMinSize="128" connectionTimeout="20000" 
      			maxConnections="10000" clientAuth="false" sslProtocol="TLSv1.2" sslEnabledProtocols="TLSv1.2" keystoreFile="./keystore/adeptiaBPM.keystore" 
      			keystoreType="JKS" keystorePass="password" compression="on" noCompressionUserAgents="gozilla, 
      			traviata" compressableMimeType="text/html,text/xml,text/css,application/javascript,application/json" 
      			useSendfile="false" server="Adeptia" xpoweredby="false" />
      			-->
      			
      			<Engine defaultHost="localhost" name="restwebapps">
      			
      				<Realm className="org.apache.catalina.realm.LockOutRealm">
      					<Realm className="org.apache.catalina.realm.UserDatabaseRealm" resourceName="UserDatabase"/>
      				</Realm>
      				
      				<Host appBase="restwebapps/wars" autoDeploy="true" name="localhost" unpackWARs="true">
      					<Valve className="org.apache.catalina.valves.AccessLogValve" directory="logs" pattern="%h %l %u %t &quot;%r&quot; %s %b" prefix="localhost_access_log" suffix=".txt"/>
      					<Valve className="org.apache.catalina.valves.ErrorReportValve" showReport="false" showServerInfo="false"/>
      				</Host>
      				
      			</Engine>
      	</Service>


  3. Save the file.

...

  1. Uncomment the following property:

    <!-- <property name="entityBaseURL" value="http://localhost:8080/adeptia"/> -->
  2. Update the URL as required. Where localhost is the IP address and port of the Connect Server.
  3. Uncomment the idp.xml property:



  4. If you are using Adeptia Connect with load balancer, follow these steps:
    • Remove or comment out the existing contextProvider bean
      <bean id="contextProvider" class="org.springframework.security.saml.context.SAMLContextProviderImpl"/>
    • Add the below contextProvider bean
      <bean id="contextProvider" class="org.springframework.security.saml.context.SAMLContextProviderLB">
      <property name="scheme" value="http"/>
      <property name="serverName" value="www.myserver.com"/>
      <property name="serverPort" value="8080"/>
      <property name="includeServerPortInRequestURL" value="false"/>
      <property name="contextPath" value="/adeptia"/>
      </bean>

    This table explains the each property of contextProvider bean:

    schemeName of the scheme (http or https).
    serverNameName of the server.
    serverPortPort number of the server.
    includeServerPortInRequestURLTo include server port number in the URL or not. It must be false.
    contextPathPrefix of a URL path used to select the context(s) to which an incoming request is passed. A URL is in the format: http://hostname.com/contextPath/, where each of the path elements can be zero or more separated elements. It must be /adeptia.

    Property Name

    Description

    It will look like:

    <bean id="contextProvider" class="org.springframework.security.saml.context.SAMLContextProviderLB">
    <property name="scheme" value="http"/>
    <property name="serverName" value="www.myserver.com"/>
    <property name="serverPort" value="8080"/>
    <property name="includeServerPortInRequestURL" value="false"/>
    <property name="contextPath" value="/adeptia"/>
    </bean>
  5. If there were any other changes in the old file, you have to do the same changes manually in the replaced securitycontextsecurityContext.xml file.
  6. Save the file.
  7. Restart Connect Portal.

...

  1. Go to …<ConnectPortalInstallFolder>\resources_config location.
  2. Open apps.properties file.
  3. Do the same manual changes in the file that you have done in your previous apps.properties file (that you had saved as backup).
  4. Search for "Microsoft SharePoint" and update below content into the file:
  5. # Microsoft SharePointReplace the details for Microsoft SharePoint by the details given below:

    Code Block
    microsoftsharepoint.oauthVersion=2.0

    
    microsoftsharepoint.oauth20.authorize={baseUrl}/_layouts/15/OAuthAuthorize.aspx

    
    microsoftsharepoint.oauth20.accessToken=https://accounts.accesscontrol.windows.net/{realmId}/tokens/OAuth/2

    
    microsoftsharepoint.scope=Site.Manage List.Manage Web.Manage Web.Write AllSites.Manage AllProfiles.Manage

    
    microsoftsharepoint.AccessTokenValueMap=resource$00000003-0000-0ff1-ce00-000000000000/{domain}.sharepoint.
    com@
    com@{realmId}


  6. Save the file.

...

Once the post installation steps are done, start the Connect Portal.

...

.

Anchor
Verifying Connect Portal patch
Verifying Connect Portal patch
Verifying Connect Portal patch

...