Documentation
For further in-depth documentation please click here.
Installation
Download the setup program from the downloads section of the WyWare Stronghold Proxy Control web page.
Double click on the StrongholdProxy[version number].msi file. This installation program will copy all files to the control installation directory (e.g. "C:\Program Files\WyWare\WyWare Stronghold Proxy Control\").
Using the Control
Getting Started
Load a new or existing Microsoft .NET WinForms project from the Visual Studio .NET IDE.
Add a reference to the WyWare Stronghold Proxy Control by right clicking on the toolbox toolbar and clicking 'Choose Items'. Click the 'Browse' button and select the WyWare.Stronghold.Net.dll file in the installation directory. If you are using .NET Framework 1.1 choose the WyWare.stronghold.Net(F1.1).dll file.
The reference to the WyWare Stronghold Proxy control should appear under the .NET tab of the dialog box. Alternatively you could use the Browse tab and load the WyWare Stronghold Proxy control assembly from the installation directory. The control will now appear in the toolbox of the Visual Studio .NET IDE with the name 'NetController'.
Drag the NetContoller control from the toolbox onto a form. You may wish to hide the control by setting it's visible propery to false.
Class Reference (NetController)
Methods
Start()
Starts the proxy listening on the local IP Address 127.0.0.1 and on the default port 999. If the port is already in use an exception is raised.
Start(string address, string port)
Starts the proxy listening on the local IP Address address and on the port port. If the port is already in use an exception is raised.
Stop()
Stops the proxy from listening on the specified IP Address and port.
Properties
BufferSize
Gets and sets the size of the buffer when sending and receiving during the exchange of data between the browser and the web server.
IsRunning
Gets a value indicating whether the proxy is listening for incoming connections.
AuthenticationDialogRealm
Gets or sets the authentication realm displayed in the proxy authentication dialog.
AuthenticateDialogFailHtml
Gets or sets the html displayed when a user fails to authenticate with a valid proxy username and password.
AccessDeniedHtml
Gets or sets the html that is displayed when a user has properly authenticated but is denied access to the Internet site.
RegistrationCode
Sets the registration code for the product license.
RegistrationUnlockCode
Sets the registration unlock code for the product license.
Events
Log
The Log event fires whenever the proxy logs information. This may be information on an error or some other arbitrary information. The message type and the message are passed through the event arguments.
Connect
The Connect event fires whenever a request is made by the browser to connect to a web site. The url of the web site and the username and password of the user making the request is passed through the event arguments. The developer can also set the action to be taken after evaluating the arguments. The action can be allow the connection, deny the connection or authenticate/re-authenticate the user.
Request
The Request event fires whenever a request is received from the browser (this is after the connection has been allowed). The event arguments include the url, the raw (byte array) request data and a value that indicates whether the data is SSL encrypted or not. The raw request data may be modified by the developer from within this event before it is sent to the web server.
Response
The Response event fires whenever a response is received from a web server (this is after the connection has been allowed). The event arguments include the url, the raw (byte array) response data and a value that indicates whether the data is SSL encrypted or not. The raw response data may be modified by the developer from within this event before it is sent to the browser.
License
Revised Janurary 6th 2008
IMPORTANT NOTICE
PLEASE READ THIS CONTRACT CAREFULLY. BY USING ALL OR ANY PORTION OF THE SOFTWARE YOU ACCEPT ALL THE TERMS
AND CONDITIONS OF THIS AGREEMENT. YOU AGREE THAT THIS AGREEMENT IS ENFORCEABLE LIKE ANY WRITTEN NEGOTIATED
AGREEMENT SIGNED BY YOU. IF YOU DO NOT AGREE, DO NOT INSTALL OR OTHERWISE USE THIS SOFTWARE. IF YOU
ACQUIRED THE SOFTWARE WITHOUT AN OPPORTUNITY TO REVIEW THIS LICENSE AND YOU DO NOT ACCEPT THIS AGREEMENT,
YOU MUST IMMEDIATELY CEASE AND DESIST USING THE SOFTWARE AND MAY RETURN IT, WITH PROOF OF PAYMENT, TO THE
LOCATION FROM WHICH IT WAS OBTAINED FOR A FULL REFUND OF THE AMOUNT YOU ORIGINALLY PAID.
This License Agreement ("Agreement") is a legal agreement between WyWare Pty Ltd ("WyWare"), an Australian
company, principally located in Brisbane, Queensland, Australia and you, the user ("Licensee"), and is
effective the date Licensee installs, downloads, copies or otherwise Uses any WyWare software product in
whole or in part ("Software"). "Use", "Uses" or "Used" means to access any of the files that are included
with the Software, to develop an application that makes use of the Software, to consult any of the
documentation included with the Software, or to otherwise benefit from using the Software.
The Software is licensed, not sold. If Licensee has legitimately obtained a registered license from WyWare
or an authorized reseller, Licensee is considered to be an authorized ("Authorized") licensee.
1. GRANT OF INSTALL LICENSE
WyWare grants Licensee the non-exclusive license to install the Software on an unlimited number of
computers at Licensee’s premises and on portable computers operated solely by Licensee.
2. GRANT OF DEVELOPMENT LICENSE
WyWare grants Licensee the non-exclusive license to Use the Software on a single computer at any given
time for the sole purpose of developing any number of end user applications that operate in conjunction
with the Software. Only a Licensee that is Authorized may Use the Software for a period longer than 60
days after the date the Software was first installed on any computer at Licensee’s premises. The license
rights granted under this Agreement do not apply to development and distribution of software development
products or toolkits of any kind, including but not limited to any class libraries, components, controls,
web services, beans, compilers, plug-ins, adapters, authoring tools, DLLs, APIs or SDKs destined to be
used by software developers other than Licensee(s) that are Authorized.
If Licensee is Authorized and has purchased a "multi-developer " license, the Software may be Used on more
than one computer at Licensee’s premises by the number of software developers associated with the
multi-developer (e.g. a "4 User" license allows up to four software developers to Use the Software on up
to four computers at Licensee's premises).
If Licensee is Authorized and has purchased a "site license", the Software may be Used by any number of
software developers on any number of computers in a single physical building at Licensee’s premises.
3. GRANT OF DUPLICATION AND DISTRIBUTION LICENSE
The Software includes certain runtime libraries and binary files intended for duplication and distribution
by a Licensee that is Authorized. These runtime libraries and binary files are specifically identified in
the "Redistributable Files" section of the documentation included with the Software (herein,
"Redistributable Files").
If Licensee is Authorized, WyWare grants Licensee the non-exclusive, royalty-free license to duplicate and
distribute the Redistributable Files.
The foregoing license is subject to the following conditions: If Licensee distributes the Redistributable
Files, Licensee agrees to (i) distribute the Redistributable Files only in conjunction with and as part of
Licensee’s software products; (ii) not supply any means by which end users could incorporate the Software
or portions thereof in their own products; (iii) not use WyWare’s name, logo or trademarks to market a
software product; (iv) include a valid copyright notice on Licensee's software product; (v) indemnify,
hold harmless, and defend WyWare from and against any claims or lawsuits, including attorney’s fees, that
arise or result from the use and distribution of Licensee’s software product; and (vi) not permit further
distribution of the Redistributable Files by end user(s) of Licensee’s software product.
5. EXAMPLE CODE LICENSE
In addition to the licenses granted above, WyWare grants Licensee the non-exclusive license to Use, copy
and modify the source code version of those portions of the Software clearly identified as "Examples" or
"Example Code" or "Example applications" ("Example Code") for the sole purposes of designing, developing,
and testing Licensee’s software product(s). If Licensee is Authorized, Licensee may distribute any
software product(s) developed by Licensee that contain the Sample Code or modifications thereof.
The foregoing license is subject to the following conditions: (i) Licensee shall not use WyWare’s name,
logo, or trademarks to market their software product(s); (ii) Licensee shall include a valid copyright
notice on all copies of the Sample Code and any derivative works thereof; (iii) Licensee shall agree to
indemnify and hold harmless WyWare from and against any claims or lawsuits, including attorneys’ fees,
that arise from or result from the use, copying, modification or distribution of the Example Code and/or
derivative works thereof, and (iv) otherwise comply with the terms of this agreement. Licensee shall not
permit further distribution of the Example Code and/or derivative works by third parties.
6. BACK-UP AND TRANSFER
Licensee may make one copy of the Software solely for "back-up" purposes, as prescribed by Australian,
United States, and international copyright laws. Licensee must reproduce and include the copyright notice
on the back-up copy. Licensee may transfer the Software to another party only if the other party agrees
to the terms and conditions of the Agreement, and completes and returns registration information (name,
address, etc.) to WyWare within 30 days of the transfer. Upon transferring the Software to another party,
Licensee must terminate this Agreement by following the instructions in the "AGREEMENT TERMS" section
below.
7. REVERSE-ENGINEERING
Licensee acknowledges that the Software, in source code form, remains a confidential trade secret of
WyWare and/or its suppliers and therefore Licensee agrees that it shall not modify, decompile, disassemble
or reverse engineer the Software or attempt to do so. Licensee agrees to refrain from disclosing the
Software (and to take reasonable measures with its employees to ensure they do not disclose the Software)
to any person, firm or entity except as expressly permitted herein.
8. RESTRICTIONS
Licensee may not Use, copy, modify, translate, or transfer the Software, documentation, license key, or
any of the files included with the Software except as expressly defined in this agreement. Licensee may
not attempt to unlock or bypass any "copy-protection", licensing or authentication algorithm utilized by
the Software. Licensee may not remove or modify any copyright notice, nor the About dialog or the method
by which it may be invoked. Licensee may not rent or lease the Software. Violations will be prosecuted to
the maximum extent possible under the law.
9. LIABILITY DISCLAIMER
The Software is provided as is, without any representation or warranty of any kind, either express or
implied, including without limitation any representations or endorsements regarding the use of, the
results of, or performance of the product, its appropriateness, accuracy, reliability, or correctness. The
entire risk as to the use of this product is assumed by Licensee. WyWare does not assume liability for the
use of this Software beyond its original purchase price. In no event will WyWare be liable for additional
direct or indirect damages including any lost profits, lost savings, or other incidental or consequential
damages arising from any defects, or the use or inability to use the Software, even if WyWare has been
advised of the possibility of such damages.
10. EXPORT LAW
Licensee acknowledges and agrees that the Software may be subject to export restrictions and controls.
Licensee agrees and certifies that neither the Software nor any direct product thereof (e.g. any
application software product developed by Licensee that uses the Software) is being or will be acquired,
shipped, transferred, exported or re-exported, directly or indirectly, into any country prohibited by
export restrictions and controls. Licensee bears all responsibility for export law compliance and will
indemnify WyWare against all claims based on Licensee’s exporting the Software.
11. AGREEMENT TERMS
This Agreement is effective until terminated. Licensee may terminate it by destroying the Software, all
the Redistributable Files Licensee may have distributed, the documentation and copies thereof. This
license will also terminate if Licensee fails to comply with any terms or conditions of this Agreement.
Licensee agrees upon such termination to destroy all copies of the Software or return them to WyWare for
disposal.
12. PARTIES BOUND
If Licensee is executing this Agreement on behalf of an entity, then Licensee represents he or she has
the authority to execute this agreement on behalf of such entity.
13. COPYRIGHT
The Software is Copyright ©2007 WyWare Software Inc., all rights reserved. The Software is protected by
Australian and United States copyright laws, international treaties and all other applicable national or
international laws.
14. OTHER RIGHTS AND RESTRICTIONS
Except for the limited licenses granted herein, WyWare, and its suppliers, retains exclusive ownership
of all proprietary rights (including all ownership rights, title, and interest) in and to the Software.
Licensee agrees not to represent that WyWare is affiliated with or approves of Licensee’s software
product(s) in any way.
15. GENERAL
This Agreement shall be interpreted, construed, and enforced according to the laws of the state of
Queensland, Australia. In the event of any action under this Agreement, the parties agree that federal
and state courts located in Queensland, Australia will have exclusive jurisdiction and that a suit may
only be brought in Queensland, Australia and Licensee submits itself for the jurisdiction and venue of
the provincial and federal courts located in Queensland, Australia.
This Agreement constitutes the entire agreement and understanding of the parties and may be modified only
in writing signed by both parties. No officer, salesman or agent has any authority to obligate WyWare by
any terms, stipulations or conditions not expressed in the Agreement.
If any portion of this Agreement is determined to be legally invalid or unenforceable, such portion will
be severed from this Agreement and the remainder of the Agreement will continue to be fully enforceable
and valid.
For further in-depth documentation please click here.
|
