Class Reference
IRIS for UNIX 2019.2
InterSystems: The power behind what matters   
Documentation  Search
  [%SYS] >  [Security] >  [Services]
Private  Storage   

persistent class Security.Services extends %Persistent, %XML.Adaptor, %SYSTEM.Help

Services defined for the system.

The table for this class should be manipulated only through object access, the published API's or through the System Management Portal. It should not be updated through direct SQL access.

Inventory

Parameters Properties Methods Queries Indices ForeignKeys Triggers
10 34 2 1


Summary

Properties
AutheEnabled ClientSystems Description Enabled Name

Methods
%AddToSaveSet %AddToSyncSet %BMEBuilt %CheckConstraints
%CheckConstraintsForExtent %ClassIsLatestVersion %ClassName %ComposeOid
%ConstructClone %Delete %DeleteExtent %DeleteId
%DispatchClassMethod %DispatchGetModified %DispatchGetProperty %DispatchMethod
%DispatchSetModified %DispatchSetMultidimProperty %DispatchSetProperty %Exists
%ExistsId %Extends %GUID %GUIDSet
%GetLock %GetParameter %GetSwizzleObject %Id
%InsertBatch %IsA %IsModified %IsNull
%KillExtent %KillExtentData %LoadFromMemory %LockExtent
%LockId %New %NormalizeObject %ObjectIsNull
%ObjectModified %Oid %OnBeforeAddToSync %OnDetermineClass
%Open %OpenId %OriginalNamespace %PackageName
%PhysicalAddress %PurgeIndices %Reload %RemoveFromSaveSet
%ResolveConcurrencyConflict %RollBack %Save %SaveDirect
%SaveIndices %SerializeObject %SetModified %SortBegin
%SortEnd %SyncObjectIn %SyncTransport %UnlockExtent
%UnlockId %ValidateIndices %ValidateObject Exists
Export Get Help Import
IsPublic Modify XMLDTD XMLExport
XMLExportToStream XMLExportToString XMLNew XMLSchema
XMLSchemaNamespace XMLSchemaType


Properties

• property AutheEnabled as Security.Datatype.Authentication [ InitialExpression = 0 ];
Authentication methods enabled for the service
Bit 0 = AutheK5CCache
Bit 1 = AutheK5Prompt
Bit 2 = AutheK5API
Bit 3 = AutheK5KeyTab
Bit 4 = AutheOS
Bit 5 - AutheCache
Bit 6 = AutheUnauthenticated
Bit 7 = AutheKB
Bit 8 = AutheKBEncryption
Bit 9 = AutheKBIntegrity
Bit 10 = AutheSystem
Bit 11 = AutheLDAP
Bit 13 = AutheDelegated
Bit 14 = AutheLoginToken
Bits 15-19 reserved
Bit 20 = TwoFactorSMS
Bit 21 = TwoFactorPW
• property ClientSystems as list of %String(MAXLEN=32767);
List of valid IP addresses allowed to connect for this service.
• property Description as %String(MAXLEN=256,MINLEN=1) [ Required ];
Full name of the service
• property Enabled as Security.Datatype.BooleanYN [ InitialExpression = 0,Required ];
Service enabled
• property Name as %String(COLLATION="Exact",MAXLEN=64,MINLEN=1) [ Required ];
Name of the service

Methods

• classmethod Exists(Name As %String, ByRef Service As %ObjectHandle, ByRef Status As %Status) as %Boolean
Service exists.
This method checks for the existence of a Service in the security database.
Parameters:
Name - Name of the Service to check existence of
Return values:
If Value of the method = 0 (Service does not exist, or some error occured)
Service = Null
Status = Service "x" does not exist, or other error message

If Value of the method = 1 (Service exists)
Service = Object handle to Service
Status = $$$OK
• classmethod Export(FileName As %String = "ServicesExport.xml", ByRef NumExported As %Integer, Services As %String = "*") as %Status
This method exports Service records to a file in xml format.
Parameters:
Filename - Output file name
NumExported (byref) - Returns number of records exported.
Services - Comma separated list of Services to export, "*" = All
• classmethod Get(Name As %String, ByRef Properties As %String) as %Status
Get a service's properties.
Gets a service's properties from the security database.
Parameters:
Name - Name of the Service to get
Return values:
Properties - Array of properties
Properties("AutheEnabled") - Enabled authentication options
Properties("AutheEnabledCapabilities") - Allowed authentication options (Internal use only)
Properties("Capabilities") - Additional capability options (Internal use only)
Properties("Enabled") - Service is enabled
Properties("Description") - Full name of the service
Properties("ClientSystems") - Semicolon separated list of allowed IP connections, "ipsec1;ipspec2;ipspec3" (On some services, an ipspec can be ip|role1,role2,etc.)
• classmethod Import(FileName As %String = "ServicesExport.xml", ByRef NumImported As %Integer, Flags As %Integer = 0) as %Status
Import Service records from an xml file.
Parameters:
FileName - Filename to import Service records from
NumImported (byref) - Returns number of records imported
Flags - Control import
Bit 0 - Do not import records, just return count
Note: On failure, no records will be imported
• method IsPublic() as %Boolean
Service is public.
• classmethod Modify(Name As %String, ByRef Properties As %String) as %Status
Modify a Service's properties.
Modifies a Service's properties from the security database.
Parameters:
Name - Name of the service to modify
Properties - Array of properties to modify.
See the Get() method for a description of the Properties parameter.
If a specific property is not passed in the properties array, the value is not modified. Note that some system defined properties are not changeable.

Queries

• query Detail(Names As %String)
Selects Name As %String, Enabled As %String, Public As %String, Authentication Methods As %String, Allowed Connections As %String, Description As %String, EnabledBoolean As %Boolean, HttpOnlyCookies As %Boolean, TwoFactorEnabled As %Boolean
Detail list of services.
Names - Comma separated list of Service names, "*" = All
Note: This query may change in future versions
• query List(Names As %String)
Selects Name As %String, Enabled As %String, Public As %String, Description As %String, EnabledBoolean As %Boolean
List of services.
Names - Comma separated list of Service names, "*" = All
Note: This query may change in future versions

Indices

•index (NameIndex on NameLowerCase) [IdKey];


Copyright (c) 2019 by InterSystems Corporation. Cambridge, Massachusetts, U.S.A. All rights reserved. Confidential property of InterSystems Corporation.