13 out of 23 rated this helpful - Rate this topic

security attribute

Sets the value indicating whether the source file of a frame or iframe has specific security restrictions applied.

This attribute is not supported for Windows Store apps using JavaScript.

Syntax

HTML
<element security="" ... >

JScript

Property values

sSecure: A String that specifies the following value.

Standards information

There are no standards that apply here.

Remarks

The sSecure value must specify restricted. Because SECURITY is an attribute only, it must be defined in the frame element declaration.

If a frame is restricted by the SECURITY attribute, all nested frames share the same restrictions.

The SECURITY attribute applies the user security setting Restricted Sites to the source file of a frame or iframe. (Zone settings are found on the Security tab of the Internet Options dialog box.) By default, scripting is not enabled in the Restricted Sites zone. By changing the security settings of the zone, various negative results can occur, including, but are not limited to, allowing script to run.

Independent of user security settings, the SECURITY attribute affects the behavior of hyperlinks and forms inside a restricted frame or iframe in the following two ways.

Hyperlinks and forms open in a new window. This happens even when the TARGET attribute specifies "_self" for a frame nested in the restricted frame. In the following example, when you click a hyperlink in the iframe, a new window opens with the requested document.
Copy
<IFRAME SECURITY="restricted" src="http://www.microsoft.com"></IFRAME>
The SECURITY attribute restricts use of the javascript, vbscript, and about protocols in the URL. For example, in a restricted frame or iframe, the source file cannot execute the following code.
Copy
<A HREF="javascript:alert('Disallowed in restricted FRAME or IFRAME!');">JavaScript Link</A>

Security Warning: If the restricted document contains script, the script can be executed when the page is opened in a new window, depending on the security settings of the zone. This is not a problem if the restricted iframe contains inline content, for example, there is no src attribute; or if the content comes from a another more restricted domain, for example, "contoso.com" hosts a page from "untrusted.com". However, when content from the same domain is hosted in a restricted frame, care should be taken to limit the action of hyperlinks and forms. Refer to the following example.

You can access the properties and contents of a restricted frame or iframe through the Document Object Model (DOM) of the container document.

Examples

The following example shows how to give the user the choice of loading a document into a restricted or unrestricted iframe. Note that the createElement method is used to create the two frames. The createElement method must use an HTML string for the parameter to specify the SECURITY attribute dynamically; after the iframe is parsed into the document, it cannot be altered.

Code example: http://samples.msdn.microsoft.com/workshop/samples/author/dhtml/refs/securityEX.htm


<html>

<head>
<script type="text/javascript">
var bRestShown = false;
var bUnRestShown = false;
function createIframe(){
    var sContents;
    if (event.srcElement.id=="restricted" && bRestShown!=true){
        sContents = "<IFRAME SECURITY='restricted' SRC='frameSource.htm'>"
        var newIframe = document.createElement(sContents);
        restIframe.appendChild(newIframe);}
   else if (event.srcElement.id=="unrestricted" && bUnRestShown!=true){
        sContents = "<IFRAME SRC='frameSource.htm'>"
        var newIframe = document.createElement(sContents);
        unRestIframe.appendChild(newIframe);}
        
}
</script>
</head>

<body>

<table>
  <tr>
	<td>
	<input id="restricted" onclick="createIframe();bRestShown=true;" type="BUTTON" value="Create Restricted IFRAME"></td>
	<td>
	<input id="unrestricted" onclick="createIframe();bUnRestShown=true;" type="BUTTON" value="Create Unrestricted IFRAME"></td>
  </tr>
  <tr>
	<td><b>IFRAME with SECURITY="restricted"</b> </td>
	<td><b>IFRAME without SECURITY attribute</b> </td>
  </tr>
  <tr>
	<td><span id="restIframe"></span></td>
	<td><span id="unRestIframe"></span></td>
  </tr>
</table>
<body>

</body>

</body>

</html>

Hyperlinks that are clicked and forms that are submitted in the restricted frame open in a new window. If the page contains script, it can be executed at that time, depending on the security settings of the zone. The following example demonstrates how to disable hyperlinks and submit buttons that might compromise security. Note: The embedded page must be in the same domain.

Code example: http://samples.msdn.microsoft.com/workshop/samples/author/dhtml/refs/security2.htm


<html>

<head>
<title>Restricted iframe - Hosting Script</title>
</head>

<body>

<h1>Restricted iframe</h1>
<p>The page below cannot run script, but try clicking the link.</p>
<iframe height="200" name="myFrame" security="restricted" src="security2_script.htm" width="50%">
</iframe><br><button id="btnDisable" onclick="disableAll()">Disable Links and Buttons
</button>
<script type="text/javascript">
function disableAll()
{
    var doc = document.frames("myFrame").document;
    
    disableLinks(doc.links);
    
    disableSubmitButtons(doc.getElementsByTagName("INPUT"));
    disableSubmitButtons(doc.getElementsByTagName("BUTTON"));
    
    btnDisable.disabled = true;
}
function disableLinks(c)
{
    for (var i=0; i<c.length; i++)
    {
        // display the href as a ToolTip
        c[i].title = c[i].href;
        c[i].href = "about:blank";
        c[i].disabled = true;
    }
}
function disableSubmitButtons(c)
{
    for (var i=0; i<c.length; i++)
    {
        if (c[i].type == "submit")
            c[i].disabled = true;
    }
}
</script>

</body>

</html>

Requirements

Minimum supported client	Windows XP [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]

Community Additions

ADD