Configuring SAP Web Dispatcher

Configure Web Dispatcher as a proxy server for SAP Mobile Platform. Web Dispatcher handles only HTTPS requests; communication with back ends should also use HTTPS.


  1. Configure SAP Mobile Platform to support the Secure Sockets Layer (SSL) protocol. See Using SSL to Secure HTTPS Channel Communications in SAP Mobile Platform.
  2. Install SAP cryptographic software.


  1. Generate Personal Security Environments.
  2. Import the SAP Mobile Platform Server certificate into the list of trusted certificates for the Web Dispatcher client PSE.
  3. Create a profile.txt file, and configure back-end servers and Web Dispatcher server ports. For example:
    wdisp/system_0 = SID=SMP, SSL_ENCRYPT=0, CONFIG_PROTOCOL=http, EXTSRV=http://<SMP Server>:8080;http://<SMP Server>:8080, SRCSRV=*:9080, SRCURL=/, STICKY=true
    wdisp/system_1 = SID=SEC, EXTSRV=https://<SMP Server 1>:8081;https://<SMP Server 1>:8081, SRCSRV=*:9081, SRCURL=/, STICKY=true
    wdisp/system_2 = SID=MUL, EXTSRV=https://<SMP Server 2>:8082;https://<SMP Server 2>:8082, SRCSRV=*:9082 SRCURL=/, STICKY=true
    icm/server_port_0 = PROT=HTTP,PORT=9080
    icm/server_port_1 = PROT=HTTPS,PORT=9081
    icm/server_port_2 = PROT=HTTPS,PORT=9082,VCLIENT=2

    This example configures Web Dispatcher ports that correspond to the SAP Mobile Platform Server ports; and it defines the back-end server IDs, <SMP Server 1> and <SMP Server 2>. When you start Web Dispatcher, you specify the location of the profile.txt file.

  4. If required, configure other Web Dispatcher profile parameters.
  5. Start Web Dispatcher, and test the connection to SAP Mobile Platform Server.
  6. Import the SAP Mobile Platform Server certificate into the Web Dispatcher truststore.
  7. To enable mutual SSL (port 8082), map the Web Dispatcher certificate to the impersonator role in an application security profile role-mapping file. For example, map the user:C=NA, ST=NA, L=NA, O=SAP, OU=Certificates, CN= certificate to the impersonator role.