Progress
Open Client
Developer’s Guide
Obtaining Run-time Information
If your Open Client application supports HTTPS, the Open Client Runtime must validate the Web server’s digital certificate. Validation is done using a Root Digital Certificate located on the client machine. Because the location of this certificate depends on where the Root Digital Certificate was installed, the location of this certificate must be obtained from the end user at run time. Therefore, the application must obtain this information from the end user and then pass the information to the Open Client Runtime using the RunTimeProperties object.
In addition, if an application must go through a proxy server to connect to AIA, the application must prompt the end user for the proxy host and port and for any required user Id and password information. Again, because the proxy server was configured on the end-user machine, the user using the application must provide the proxy server information. Therefore, the application must obtain the information from the end user and then pass the information to the Open Client Runtime using the methods and properties of the RuntimeProperties object.
Your Open Client application might need to obtain information from the end user when:
- The host address, port, userid, and password are required for a Proxy Web server.
- You need to provide the location of Root Digital Certificates to validate the Web server’s identity. Every Web server that hosts an AIA servlet and that supports the HTTPS protocol must have the Root Digital Certificate of the Certificate Authority who issued the digital certificate for the Web server.
Your Open Client application might need to obtain URL connection information from the end user when:
- The URL requires a userid and password for authentication to the Web server hosting the AIA when you use the HTTP or HTTPS protocols.
- The connection URL format differs between the AppServer and AppServerDC protocol and the HTTP and HTTPS protocols.
- You communicate with more than one AIA, you might need to use:
- When you use the
HTTPS protocol, you might need to supply the names and locations of the Root Digital Certificate files to load and use for authenticating the Web server hosting the AIA Java servlet.
The application might automatically prompt the user for the information when it starts, or it might chose to dynamically handle the Connection Error status returns specific to failed Web server authentication and retry the connection after getting the information from the end user.
For more information, see "Methods For Managing Digital Certificates" in "Programming Java Clients" and "Methods For Managing Digital Certificates" in Programming ActiveX Controller Clients."
Copyright © 2004 Progress Software Corporation www.progress.com Voice: (781) 280-4000 Fax: (781) 280-4095 |