Use the Domains dialog box to define authentication system domains for use with your ABL applications.
Note: The connected user must be a DBA to access this dialog box.
When you select the Domains option from the Domain Maintenance submenu, the Domains dialog box appears.
The browser at the top of the dialog box contains the following fields for databases enabled for multi-tenancy:
Name — Displays the logical name of a single authentication system that can be used to authenticate or validate the authentication of a user account
Tenant Name — The tenant associated with the domain
If the database is not enabled for multi-tenancy, the browser displays the following fields:
Name — Displays the logical name of a single authentication system that can be used to authenticate or validate the authentication of a user account
System Type — Displays the type of authentication system
Description — Description of the authentication domain
To update an authentication system domain, select it in the browser and edit the fields described below. To create a new authentication system domain, select Create and enter information into the following fields:
Name — The domain name
Tenant name — For databases enabled for multi-tenancy, the tenant to associate with the domain
System Type — The type of authentication system. This field is enabled only when you are creating a new domain. You cannot edit an existing domain type. To change the existing domain, delete the current domain record and add a new one.
Access Code — Encrypted access code phrase used to validate the identity and integrity of any CLIENT-PRINCIPAL issued by the authentication system represented by this domain
Audit Context — The audit record context value when a _client-session record is recorded to the database
Runtime Options — A comma delimited list of runtime options for use with the domain's ABL Virtual Machine (AVM)
System Options — Command options used by a Domain's authentication system at runtime to control its user authentication and/or ABLClient-Principal validation. See your authentication system documentation for a list of the supported options.
Description — Description of the authentication domain
Comments — Specific authentication domain details
Domain Enabled — Activate to specify the current domain is enabled
The following control options appear on the Domain dialog box:
OK — Closes the dialog. This option is disabled until you select Save or Cancel.
Create — Creates a new authentication system domain record and resets the fields for input.
Save — Saves changes to the current authentication system domain record and resets the fields for input.
Cancel — Cancels current changes to the authentication system domain record. Note that this option is disabled until you select Create or edit one of the fields for an existing record. If you select Cancel while creating a new record, the previously selected record displays.
Delete — Deletes the current administration system domain record after prompting for verification. If you delete a record, the next record in the browser appears. If you delete the last record, the Data Dictionary clears all of the fields in the Domains dialog box.
The following table describes the hot keys used with the Authentication Systems Domains dialog box.
Table 34. Authentication System Domains dialog box hot keys
Hot key
Description
CTRL+A
Selects Create, if the option is enabled
CTRL+N
Selects Cancel, if the option is enabled
DEL
Selects Delete, if the option is enabled
Note: This hot key applies only if an authentication system record is selected in the browser.
F1/GO
Selects Save, if the option is enabled. Otherwise, selects Done