Articles Archive
Articles Search
Director Wiki

Bringing Security to Director

July 18, 2002
by Gabrielle Dara Krim

[Editor's Note: The author is the Product Manager for INM's SecureNet Xtra. -DP]

Security is a Sign of Maturity

E-commerce, pay-per-use online services, user-authentication and tracking for e-learning, online gaming, contests... What do all of these applications have in common? The need for secure transfer of encrypted data between client workstations and server applications. According to a study by Gartner Consulting, the growing concern for Internet security parallels the evolution of e-business. In the earliest days of Internet development, the emphasis was on distributing content over the web and making it available to anyone. Now, as the Internet matures, clients are more concerned with ensuring that their assets, both monetary and intellectual, are protected from those who may commit fraud or abuse them. This is why more and more developers have been looking for security solutions.

The Technological Challenge

Secure HTTP, or Hypertext Transfer Protocol with Secure Sockets Layer (SSL), is the current standard for transmitting secure information over the Internet. The SSL security protocol, developed by Netscape Communications Corporation, provides data encryption, server authentication, message integrity, and optional client authentication for a TCP/IP connection. It uses public key cryptography, a technique that uses a pair of asymmetric keys for encryption and decryption. Data is encrypted using a public key, but can only be decrypted using a private key. URLs that use Secure HTTP begin with https://.

Out of the box, Director-based applications can only offer Secure HTTP connections through Shockwave within a browser. There is no way to ensure secure communications from a projector. Likewise, there is no efficient way to debug Secure HTTP communications in Director's authoring environment.

Common Workarounds and Consequences

There have been few alternatives for Director users:

INM's SecureNet Xtra

At Integration New Media, we understood developers' needs for secure Internet communication from both within and outside the browser environment. We built SecureNet Xtra with those needs in mind.

SecureNet Xtra provides nearly all the network communication methods of NetLingo - secure HTTP queries, posting form data to CGI or ASP scripts, downloading files -- and these operations can be performed from projectors, Shockwave and even in Director's authoring environment. Developers can save time -- even on Shockwave applications which could use the browser's own HTTPS implementation when deployed-- with the ability to test secure connections directly from the authoring mode. SecureNet Xtra piggy-backs on Internet Explorer's wininet.dll to provide the SSL encryption/decryption protocol for secure HTTP communications.

This table provides a comparison of some of the commands and functions used by standard Net Lingo and the SecureNet Xtra

Net Lingo methods SecureNet Xtra methods and behaviors Differences in SecureNet Xtra implementation from Net Lingo
DownloadNetThing snxDownloadNetThing
Only HTTP and HTTPS; not FTP. Allows downloading files from a secure HTTPS server from a projector or Director movie
GetNetText snxGetNetText
Only HTTP and HTTPS; not FTP. Does not support multiple OS character set. Use of netID parameter is mandatory. Allows retrieval of text from a secure HTTPS server from a projector or Director movie
PostNetText snxPostNetText
Only HTTP and HTTPS; not FTP. Does not support multiple OS character set. Use of netID  parameter is mandatory. Allows posting to a secure HTTPS server from a projector or Director movie
GetStreamStatus snxGetStreamStatus Does not support syntax with an URL passed as a parameter, only netID 
NetAbort snxNetAbort Does not support syntax with an URL passed as a parameter, only netID 
NetDone snxNetDone Use of netID  parameter is mandatory
NetError snxNetError
snxNetError doesn’t support the no parameter syntax snsDisplayError and snsNetError allow for multiple syntaxes
NetTextResult snxNetTextResult
Use of netID  parameter is mandatory. The Behaviors allow you to optionally display the returned result directly to a field or text member.
ProxyServer snxProxyServer SecureNet Xtra allows for additional syntaxes, with the ability to accept username and password

When not to use SecureNet Xtra

In most situations, you can safely use SecureNet Xtra in place of Net Lingo for your network communications. However, there are a few situations in which SecureNet Xtra would not be desirable:

How to Implement Network Operations
Using SecureNet Xtra

There are two ways to implement network operations with SecureNet Xtra: using behaviors, and using Lingo methods. The rest of this article describes how to implement a sample project called First Steps, using both approaches. The behavior version of this sample is available as a from the SecureNet Xtra Demo page.

The context is an e-purchasing application that accepts credit card information and sends it to an ASP script on a server implementing a Secure HTTP connection. The basic operation you need to implement is the standard HTTP POST, which most Internet forms employ when the user clicks a Submit button.

Using SecureNet Xtra Behaviors

The SecureNet Xtra Behaviors needed for this operation are snbForm.Field and snbForm.Submit. snbForm.Field associates the contents of a Director field with a specific variable on the server-side script. To properly submit the credit card information, you need to drag the snbForm.Field behavior over each field that contains data that the server-side ASP script requires, such an Last Name, First Name, Card Number, Expiry Date, Amount, etc. When you drag the behavior onto a text field on the stage, this dialog box opens.

For details on these parameters, download the SecureNet Xtra User Manual and the First Steps tutorial.

Once you have identified all the fields whose data will be sent, drag the snbForm.Submit behavior to a button on the stage that will trigger the network operation when clicked. This dialog box appears:

From this box, you can define most of the parameters by simply selecting from drop-down menus. The URL to which you are posting data is stored within a Director cast member, as is the result returned, if applicable. Note the proxy server settings in the lower half of the dialog box. These settings allow your application to communicate through an end-user's proxy server if there is one. See the SecureNet Xtra User Manual for details.

With SecureNet Xtra behaviors, the communication is synchronous - that is, Director waits until the network operation has completed before processing any other commands. The user will fill in his credit card information, click a Submit button, and wait to receive some notification, which is either a response sent by the remote URL or something else you choose to do in your application.

Using SecureNet Xtra Methods

Now let's look at how to implement the same kind of example using the Lingo methods. In Lingo, you have the option of coding SecureNet Xtra communications in either synchronous or asynchronous modes.

As with the behaviors, you would likely have the data to be sent stored in fields on the stage. You would then send the data using the method snxPostNetText within the mouseUp handler of a Submit button. Between each network operation, it's good practice to call one of the error handling methods, which are supplied in a script within the Behaviors Library.

Synchronous Example:

-- send the variables to the server-side script
NetID = snxPostNetText (, [#name:myName, #cardnumber:myNumber, #expires: myExpires])
-- if an error ocurred, display the error directly in an alert box and don't continue
if (snsDisplayError (NetID, 1)) then
end if

-- the POST command was initiated successfully
-- now check for completion
-- repeat/while loop is used to implement synchronous communication
-- and prevent Director from processing other commands
repeat while (NOT snxNetDone (NetID))
   -- get the status of the operation
   lStatus = snxGetStreamStatus (NetID)
  pctDone = (lStatus.BytesSoFar / lStatus.BytesTotal) * 100
   -- display a progress indicator while the user waits
end repeat
-- check for result status
if (snsDisplayError (NetID, 1)) then
  -- don't continue if errors occurred
end if
-- display any response from the server script
member ("Result").text = snxNetTextResult (NetID)

If you choose to implement the communication synchronously, with the repeat loop, the user cannot interact with Director until the operation has completed. This is usually desirable for network operations that are reasonably quick. If, however, you want the user to be able to send multiple network communications without waiting for a response between each, or you want to display an animation while the user waits, you may use the asynchronous mode.

Asynchronous Example:

on mouseUp
  -- initalize variables to send here
  -- send the variables to the server-side script
  gNetID = snxPostNetText (, [#name:myName, #cardnumber:myNumber, #expires: myExpires])
   -- if an error ocurred, display the error directly in an alert box and don't continue
  if (snsDisplayError(gNetID, 1)) then
  end if
  -- the POST command was initiated successfully
end mouseUp

-- now check for completion
on exitFrame
  -- get the status of the operation
  lStatus = snxGetStreamStatus(NetID)
  pctDone = (lStatus.BytesSoFar/lStatus.BytesTotal) * 100
  -- display a progress indicator while the user waits

  -- check for completion
  if (snxNetDone (gNetID)) then
    if (snsDisplayError (gNetID, 1)) then
      -- don't continue if errors occurred
    end if
    -- display any response from the server script
    member ("Result").text = snxNetTextResult (gNetID)
    -- go to a specific frame
    go to the frame
  end if
end exitFrame

Note that with the asynchronous mode, you must use a global variable: gNetID instead of NetID.


Internet-based applications are here to stay. Even applications delivered on CD-ROM now offer some dynamic, web-based content. Therefore, security has become an important concern for project sponsors, end-users and developers alike. Project sponsors, in particular, who fund development projects and expect a return on their investments, are driving the trend, demanding and expecting certain measures of security for their Internet-based applications. Moreover, they are willing to pay extra for applications that can offer security.

The Gartner Consulting paper lists the "ability to provide authentication and authorization functionality as part of the defined security solution" as one of the key criteria in evaluating a software vendor. They conclude by stating, "a vendor who is able to offer these [secure] software tools and integration services can truly help their customers leverage the power of the Internet for e-business."

The bottom line for Director developers is that we all have to stay abreast of current security concerns or risk being left behind. With SecureNet Xtra, we now have a new option for secure application development that doesn't compromise the multimedia experience that has earned Director its worldwide recognition.

System requirements

As of the writing of this article SecureNet Xtra version 1.0 is only available for Director, on Windows.

Product Info

For more information on the features see the product web site.


Integration New Media's Home Page

SecureNet Xtra Beta test site.

To learn more about Secure HTTP and the Secure Sockets Layer (SSL) protocol, visit:

Gartner Consulting's white paper, "The Evolution of e-Business Security Requirements", prepared for Verisign, Inc.


© Integration New Media Inc 2002

All colorized Lingo code samples have been processed by Dave Mennenoh's brilliant HTMLingo Xtra, available from his site at

Gabrielle Krim has a B.A. in Computer Science from Cornell University and a M.A. in Educational Technology from Concordia University. She has over 10 years experience in the industry, as a software developer and multimedia author for database and e-learning projects. She has been working for INM as Instructional Designer and Project Manager since March 2002.

Copyright 1997-2017, Director Online. Article content copyright by respective authors.