• What is NGinx server? NGINX is a web server that also acts as an email proxy, reverse proxy, and load balancer.

• Download the stable NGinx version from the below link: http://nginx.org/en/download.html

• We need to install nginx server in the Separate server which is in the DMZ Zone

• Extract the downloaded zip file.

• After extracting the zip file, need to modify the nginx.conf file to enable URL restriction for mobile apps.

• Open the nginx.conf file which is available under "nginx/conf/" directory.

• Replace the nginx.conf file with the below configuration file.

                   Nginx Configuration file: refer to the nginx attached file

  server {
      # Below to change the nginx server's port
        listen       80; 
  #Refer to the below configuration to configure the nginx domain

• Refer to the below configurations to configure the ServiceDesk Plus server name/IP and port in nginx.conf file. For Example,

upstream internalserver {
    server 192.168.18.280:8080;
}

• Refer to the below configurations to configure the ServiceDesk Plus HTTP/HTTPs protocols. Replace all the http://internalserver; to https://internalserver in nginx configuration

  # Default is HTTP Mode
  location ~ /api/v3/requests/([0-9]+) {
     if ($request_method = GET) {
          proxy_pass http://internalserver;  
     }
           if ($request_method = PUT) {
          proxy_pass http://internalserver;  
     }
           if ($request_method = POST) {
          proxy_pass http://internalserver;  
     }
  
  }
#If you wish to change to HTTPS Mode change all the proxy_pass http://internalserver to https://internalserver
     location ~ /api/v3/requests/([0-9]+) {
     if ($request_method = GET) {
          proxy_pass https://internalserver;  
     }
           if ($request_method = PUT) {
          proxy_pass https://internalserver;  
     }
           if ($request_method = POST) {
          proxy_pass https://internalserver;  
     }
}

• Start the nginx server

➤ Open the command prompt, under the nginx server installed directory and execute the below command.

                                Command: start nginx.exe (or) start nginx

➤ Use the below command to shutdown the nginx server

                                Command for fast shutdown: nginx -s stop  

        Command for graceful shutdown: nginx -s quit 

Note:

• Refer to the below configurations to configure the ServiceDesk Plus server name/IP and port.

location /api/v3/mobile_devices  {
    # Below to configure the servicedeskplus server details
     proxy_pass  http://192.168.19.35:8080;
}

• Refer to the below configurations to redirect the mobile app URLs to ServiceDesk Plus server.

location /api/v3/app_resources/authenticate {
     proxy_pass http://192.168.19.35:8080;
}
# whitelist the api/v3/solutions (GET) by below configuration
location ~ /api/v3/solutions/([0-9]+) {
    if ($request_method = GET) {
     proxy_pass http://localhost:8080;  
    }
}
# Other url's are blacklisted by using below configuration
location / {
    # block this url Or redirect to error page
   proxy_pass http://192.168.19.35:8080/jsp/pagenotfound.jsp;
}