define | create security_policy

Use the define|create security_policy command to create a security policy file.

Syntax

define | create security_policy [policy_name <string>]
[encrypt <boolean>][validity_days <integer>] policy_file <string>

Parameters

The following table lists the parameters for this command with a description of each parameter.

define | create security_policy Parameters
Parameter Description
policy_name Optional. Specifies the name of the policy to be created. If you do not specify a policy name, the policy is given the default name AS-POLICY.
Note: You cannot specify a policy file and a security token for the same connection.

You can also specify one or more domains that the policy is associated with:

To specify that the policy is associated with one domain, specify the policy name and the domain as follows:

define | create security_policy policy_name <policy_name>/<domain name> policy_file <string>. 

For example:

create security_policy policy_name "OUR_POLICY/OUR_DOMAIN" policy_file "ourpolicy.txt"

If you enter the command in this way, the encrypt setting defaults to false: then if you specify one domain, you are prompted to enter and verify the password for that domain. If you specify multiple domains, you are prompted to enter and verify the password for each domain.

Note: If you specify encrypt=false, ActiveSpaces creates all domains is created with an unencrypted ID, which requires no password, and you are not prompted for a password.

To create multiple domains associated with the policy, specify the policy name and a list of domains that the policy is associated with. Specify the domains separated by commas:

define | create security_policy policy_name "<string/string, string, string ...>" policy_file <string>

For example:

create security_policy policy_name "NEW_POLICY/MD1,MD2,MD3" policy_file "newpolicy.txt"
encrypt Optional. Indicates whether the private key for the policy is to be encrypted. The default is encrypt true.

If you specify encryption, as-admin prompts you to specify and verify a new domain password and creates an encrypted private key in the Domain Identity section of the policy file.

If you specify encrypt false, the domain does not require a password, and as-admin creates an unencrypted private key in the policy file.

validity_days An integer that specifies how long the domain ID that the command creates remains valid. The default value is 365 days.

Policies can have more than one domain, where (in theory) each of them can have different validity days if the domain definitions are moved between policy files manually.

policy_file Enter the name of the policy file that is to be created for the policy.
Note: You cannot specify a policy file and a security token for the same connection.
Note: The policy filename cannot contain a forward slash character (“/”).

Example

The following examples illustrate the syntax of the define | create security_policy command:

  • create security_policy policy_name 'mypolicy' policy_file 'policy.txt'
  • create security_policy policy_name 'mypolicy' encrypt false policy_file 'policy.txt'
  • define security_policy "MY_POLICY/MY_DOMAIN" policy_file ’policy.txt’
    Note: Parameter values must be enclosed in either single or double quotes.