# <SecurityOptions>

The SecurityOptions element specifies settings for securing the content of a document. iSiloX and iSiloXC add indicators to the converted document so that conforming applications that utilize the document can determine what types of actions to allow on the document.

## Full element example

        <SecurityOptions>
          <CopyBeam                 value="allow"/>
          <CopyAndPaste             value="allow"/>
          <Modify                   value="allow"/>
          <Convert                  value="allow"/>
          <Print                    value="allow"/>
        </SecurityOptions>
        <Expiration>
          <Expires                  value="no"/>
          <Date                     value="20030529"/>
        </Expiration>
        <Password>
          <Require                  value="no"/>
          <Password>MyPassword</Password>
        </Password>
        <RegistrationCode>
          <Require                  value="no"/>
          <DocumentID>UniqueID55PC</DocumentID>
        </RegistrationCode>

## Sub-element summary

Tag | Type | Default | Description
--- | --- | --- | ---
`<CopyBeam>` | value | allow | Whether to allow copying and beaming of the document
`<CopyAndPaste>` | value | allow | Whether to allow copying of content to the clipboard
`<Modify>` | value | allow | Whether allow modification of the document
`<Convert>` | value | allow | Whether to allow conversion to other formats
`<Print>` | value | allow | Whether to allow printing of the document. This option requires version 3.15 or later of iSiloX and iSiloXC.
`<Expiration>` | container | n/a | Specifies an expiration date to set for the document. This option requires version 3.2 or later of iSiloX and iSiloXC.
`<Password>` | container | n/a | Specifies the password for the document. This option requires version 3.2 or later of iSiloX and iSiloXC.
`<RegistrationCode>` | container | n/a | Specifies the registration code requirement for the document. This option requires version 3.2 or later of iSiloX and iSiloXC.

## Sub-element descriptions

### <CopyBeam>

Description
Set the value attribute of the tag to `allow` or `disallow` to respectively allow or disallow copying and beaming of the document.
Examples
This example specifies that copying and beaming should be allowed.

      <CopyBeam                 value="allow"/>

This example specifies that copying and beaming should not be allowed.

      <CopyBeam                 value="disallow"/>

### <CopyAndPaste>

Description
Set the value attribute of the tag to `allow` or `disallow` to respectively allow copying of content from the document to the system clipboard or disallow the operation so that content can not be copied and pasted elsewhere.
Examples
This example specifies that copying to the clipboard should be allowed.

      <CopyAndPaste             value="allow"/>

This example specifies that copying to the clipboard should not be allowed.

      <CopyAndPaste             value="disallow"/>

### <Modify>

Description
Set the value attribute of the tag to `allow` or `disallow` to respectively allow or disallow modification of the document. This includes modification of the document's global and document bookmarks.
Examples
This example specifies that the document can be modified.

      <Modify                   value="allow"/>

This example specifies that the document may not be modified.

      <Modify                   value="disallow"/>

### <Convert>

Description
Set the value attribute of the tag to `allow` or `disallow` to respectively allow or disallow conversion of the document to other formats. Saving the content of a document to a text file is also considered a conversion of the document to another format.
Examples
This example specifies that the document can be converted to other formats.

      <Convert                  value="allow"/>

This example specifies that the document may not be converted to other formats.

      <Convert                  value="disallow"/>

### <Print>

Description
Set the value attribute of the tag to `allow` or `disallow` to respectively allow or disallow printing of the document. Though at this time you can not directly print a document from all platforms for which iSilo™ is available, it may become possible to do so in the future. If you know now that you do not want to allow printing regardless of the case, set the value attribute of this tag to `disallow`.
Examples
This example specifies that the document can be printed.

      <Print                    value="allow"/>

This example specifies that the document may not be printed.

      <Print                    value="disallow"/>

## <Expiration> sub-element summary

The elements in the <Expiration> container element specify whether or not the document expires on a given date. Possible uses of setting an expiration date include beta or trial versions of documents. In iSilo™, if the user attempts to open a document that has an expiration date and the current date is on or after the expiration date, iSilo™ does not allow opening of the document and reports to the user that the document has expired.

Tag | Type | Default | Description
--- | --- | --- | ---
`<Expires>` | value | no | Whether the document has an expiration date
`<Date>` | value | n/a | Specifies the document expiration date in the form YYYYMMDD

## <Expiration> sub-element descriptions

### <Expires>
<Date>

Description
Set the value attribute of the <Expires> tag to `yes` and provide the document expiration date in the value attribute of the <Date> element to have the document expire on the given date. The expiration date must have the form YYYYMMDD, where YYYY is the four digit year, MM is the two digit month, and DD is the two digit day of the month.

Set the value attribute of the <Expires> tag to `no` to have the document never expire.
Examples
This example specifies that the document expires on May 29, 2003.

      <Expires                value="yes"/>
      <Date                   value="20030529"/>

This example specifies that the document does not expire.

      <Expires                value="no"/>

## <Password> sub-element summary

The elements in the <Password> container element specify whether or not the document requires a password. In iSilo™, the user is asked to enter the password each time the document is opened. If the user enters an incorrect password, iSilo™ refuses to open the document. Only if the users enters the password correctly does the document open successfully.

Tag | Type | Default | Description
--- | --- | --- | ---
`<Require>` | value | no | Whether the document requires a password
`<Password>` | string | n/a | Specifies the password to require to open the document

## <Password> sub-element descriptions

### <Require>
<Password>

Description
Set the value attribute of the <Require> tag to `yes` and provide the document password in the Password element.

Set the value attribute of the <Require> tag to `no` to not require a password for the document.
Examples
This example specifies that the document requires the user to enter the password "MyPassword" in order to open the document.

      <Require                value="no"/>
      <Password>MyPassword</Password>

This example specifies that the document does not require a password to open.

      <Require                value="no"/>

## <RegistrationCode> sub-element summary

The elements in the <RegistrationCode> container element specify whether or not the document requires a registration code.

Tag | Type | Default | Description
--- | --- | --- | ---
`<Require>` | value | no | Whether the document requires a password
`<DocumentID>` | string | n/a | Specifies a textual identifier for the document

## <RegistrationCode> sub-element descriptions

### <Require>
<DocumentID>

Description
Set the value attribute of the <Require> tag to `yes` and provide the identifier for the document in the DocumentID element.

Set the value attribute of the <Require> tag to `no` to not require a registration code for the document.

The document ID is used to generate registration codes that work only with that document. Two documents with different document IDs require different registration codes, so in order to prevent registration codes from other documents working for your document, you will want to use a unique document ID. Furthermore, you will want to keep the document ID private unless you want others to be able to generate registration codes for your document. A document ID can consist of digits, the underscore character, and uppercase or lowercase letters. Spaces and other characters are not allowed.

In iSilo™, when the user opens a document protected with a registration code, iSilo™ asks the user for the registration code. If the user enters a valid registration code, iSilo™ remembers the registration code so that the next time the user opens the document, the user does not need to re-enter the registration code. However, if the user installs an updated version of the document that has a different document ID, the user will be asked for the registration code for the document since the previous registration code was not keyed to the document ID of the updated document.

iSiloX provides a dialog interface for generating registration codes. iSiloXC does not have the ability to generate registration codes for documents.
Examples
This example specifies that the document requires the user to enter a registration code in order to open the document.

      <Require                value="no"/>
      <DocumentID>UniqueID55PC</DocumentID>

This example specifies that the document does not require a registration code to open.

      <Require                value="no"/>

©1999-2017 DC & Co. All rights reserved.