16
Server Management ActionScript Language Reference
approveDebugSession()
Availability
■
Flash Player 6.
■
Flash Media Server 2.
Usage
approveDebugSession(
appInst
, PIN)
Parameters
appInst
A string indicating the application and instance name that has a pending debug
connection to approve.
PIN
A number indicating the debug session Personal Identification Number. Each debug
connection issues a debug number when queueing to connect to an application. This same
number is included on this API. When this API is processed, the PIN numbers are matched
and the corresponding connection is allowed to connect. This is a security measure to prevent
unauthorized users from using the debug connection.
Keep in mind that 0 is not a valid
PIN
value. To maintain security, PIN numbers should not
be able to be easily guessed. PIN numbers must be non-zero and must be within the range of
+/- (2^31 - 1) that is between positive or negative 2147483648. If there is a pending
connection with a given PIN, and another connection arrives with the same PIN while the
original is still waiting, the second connection with the same PIN will be rejected as a security
measure.
Returns
If the call succeeds, the server sends a reply information object with a
level
property of
status
, a
code
property of
NetConnection.Call.Success
.
Description
Approves a pending debug session’s request to connect to a selected application. Once
approved and permitted, the debug session may connect to its application through the
Services.onDebugConnect
gateway and act as a regular client.
Connecting to an application with a debug session allows you to view the streams and shared
objects for an application through the management console.
Example
The following is an example of a Debug connection:
nc.connect("rtmp://serverName/appName%3F%5Ffcs%5Fdebugreq%5F%3D1234");
// The original string is _fcs_debugreq_=1234.