approveDebugSession()

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

nc.connect("rtmp://serverName/appName%3F%5Ffcs%5Fdebugreq%5F%3D1234");
// The original string is _fcs_debugreq_=1234.

nc_admin.call("approveDebugSession", null, appName/instName", 1234);

Comments

a_[w] said on Dec 26, 2005 at 1:32 AM :

nc_admin.call("approveDebugSession", null, appName/instName", 1234);
may be
nc_admin.call("approveDebugSession", null, "appName/instName", 1234);