Deprecated API


Contents
Deprecated Interfaces
com.sap.security.api.umap.system.ISystemLandscapeWrapper
          Use ISystemLandscape instead.

This interface serves as wrapper for a system landscape to be plugged into UME. The ISystemLandscapeObject objects provided by an ISystemLandscapeWrapper will be used by the User Mapping functionality of UME (see IUserMapping as an entry point).

At runtime, all available implementations of this interface can be retrieved by calling UMFactory.getSystemLandscapeWrappers().
An implementation can register itself in UME via UMFactory.addSystemLandscapeWrapper(ISystemLandscapeWrapper) .
Unregistering is possible using UMFactory.removeSystemLandscapeWrapper(ISystemLandscapeWrapper) .

The concept knows two naming principles:

Unique keys (GUIDs)
  • Each system must have exactly one unique key.
  • Unique keys must be unique inside of a system landscape represented by an ISystemLandscapeWrapper implementation.
  • Unique keys are unique in the sense that two systems are distinct if and only if their unique keys are distinct.
System aliases
  • One system can have an arbitrary number of system aliases (please note that at least one alias is required to make the system available for user mapping).
  • Systems can not be distinguished based on system aliases (because different aliases may belong to the same system).
  • System aliases must be unique inside of a system landscape represented by an ISystemLandscapeWrapper implementation.

An application using user mapping will usually call only two methods of this interface:

 
com.sap.security.core.server.saml.jaas.SAMLAuthenticationDataCarrier
          Use "com.sap.security.api.saml.jaas.ISAMLAuthenticationDataCarrier". 
 

Deprecated Classes
com.sap.security.core.server.saml.jaas.SAMLAuthenticationData
          Use "com.sap.security.api.saml.jaas.SAMLAuthenticationData". 
com.sap.security.api.logon.WebCallback
          Must not be used any longer. 
 

Deprecated Exceptions
com.sap.security.api.logon.LoginException
            
 

Deprecated Fields
com.sap.security.api.IGroupFactory.ANONYMOUS_USERS
          use IGroupFactory.ANONYMOUS_USERS_UNIQUEID instead 
com.sap.security.api.IGroupFactory.AUTHENTICATED_USERS
          use IGroupFactory.AUTHENTICATED_USERS_UNIQUEID instead 
com.sap.engine.lib.security.LoginExceptionDetails.CHANGE_PASSWORD_ALPHA_NOT_ALLOWED
          replaced by CHANGE_PASSWORD_FAILED 
com.sap.engine.lib.security.LoginExceptionDetails.CHANGE_PASSWORD_ALPHANUM_REQUIRED
          replaced by CHANGE_PASSWORD_FAILED 
com.sap.engine.lib.security.LoginExceptionDetails.CHANGE_PASSWORD_CHANGE_PASSWORD_NOT_ALLOWED
          replaced by CHANGE_PASSWORD_FAILED 
com.sap.engine.lib.security.LoginExceptionDetails.CHANGE_PASSWORD_LOWER_CASE_NOT_ALLOWED
          replaced by CHANGE_PASSWORD_FAILED 
com.sap.engine.lib.security.LoginExceptionDetails.CHANGE_PASSWORD_LOWERCASE_REQUIRED
          replaced by CHANGE_PASSWORD_FAILED 
com.sap.engine.lib.security.LoginExceptionDetails.CHANGE_PASSWORD_MIXED_CASE_REQUIRED
          replaced by CHANGE_PASSWORD_FAILED 
com.sap.engine.lib.security.LoginExceptionDetails.CHANGE_PASSWORD_NEW_PASSWORD_INVALID
          replaced by CHANGE_PASSWORD_FAILED 
com.sap.engine.lib.security.LoginExceptionDetails.CHANGE_PASSWORD_NO_PASSWORD_LOGON
          replaced by CHANGE_PASSWORD_FAILED 
com.sap.engine.lib.security.LoginExceptionDetails.CHANGE_PASSWORD_NUMERIC_NOT_ALLOWED
          replaced by CHANGE_PASSWORD_FAILED 
com.sap.engine.lib.security.LoginExceptionDetails.CHANGE_PASSWORD_NUMERIC_REQUIRED
          replaced by CHANGE_PASSWORD_FAILED 
com.sap.engine.lib.security.LoginExceptionDetails.CHANGE_PASSWORD_OLDPASSWORD_IN_NEWPASSWORD
          replaced by CHANGE_PASSWORD_FAILED 
com.sap.engine.lib.security.LoginExceptionDetails.CHANGE_PASSWORD_PASSWORD_CONTAINED_IN_HISTORY
          replaced by CHANGE_PASSWORD_FAILED 
com.sap.engine.lib.security.LoginExceptionDetails.CHANGE_PASSWORD_PASSWORD_MAX_IDLE_TIME_EXCEEDED
          replaced by CHANGE_PASSWORD_FAILED 
com.sap.engine.lib.security.LoginExceptionDetails.CHANGE_PASSWORD_SPEC_CHARS_REQUIRED
          replaced by CHANGE_PASSWORD_FAILED 
com.sap.engine.lib.security.LoginExceptionDetails.CHANGE_PASSWORD_SPECIAL_CHARS_NOT_ALLOWED
          replaced by CHANGE_PASSWORD_FAILED 
com.sap.engine.lib.security.LoginExceptionDetails.CHANGE_PASSWORD_TOO_LONG
          replaced by CHANGE_PASSWORD_FAILED 
com.sap.engine.lib.security.LoginExceptionDetails.CHANGE_PASSWORD_TOO_MANY_INVALID_LOGON_ATTEMPTS
          replaced by CHANGE_PASSWORD_FAILED 
com.sap.engine.lib.security.LoginExceptionDetails.CHANGE_PASSWORD_TOO_SHORT
          replaced by CHANGE_PASSWORD_FAILED 
com.sap.engine.lib.security.LoginExceptionDetails.CHANGE_PASSWORD_USERID_CONTAINED_IN_PASSWORD
          replaced by CHANGE_PASSWORD_FAILED 
com.sap.engine.lib.security.LoginExceptionDetails.CHANGE_PASSWORD_WHITESPACES_NOT_ALLOWED
          replaced by CHANGE_PASSWORD_FAILED 
com.sap.security.api.IPrincipalSearchFilter.CHECK_ACCESS
            
com.sap.security.api.IGroupFactory.EVERYONE
          use IGroupFactory.EVERYONE_UNIQUEID instead 
com.sap.security.api.IPrincipalSearchFilter.EXTENDED_SEARCH
            
com.sap.security.api.IPrincipalFactory.ICUSTOM_OBJECT
            
com.sap.security.api.logon.ILoginConstants.LOGON_UID_ALIAS
            
com.sap.security.api.umap.IUserMapping.UMAP_SYSTEM_FIELDS
          This array of constants should not be used any more. 
com.sap.security.api.umap.IUserMapping.UMAP_SYSTEM_TYPE_EP6_ALIAS
          This constant is no longer valid and there's no replacement. 
com.sap.security.api.umap.IUserMapping.UMAP_SYSTEMATTRS_R3NAMEREF
          

System attribute name to flag a backend system as SAP reference system for UME.

This logic is no longer supported. Instead, the SAP reference system is defined in UME configuration property "ume.r3.mastersystem" (see ILoginConstants.R3_MASTERSYSTEM).

 
com.sap.engine.lib.security.LoginExceptionDetails.UNKNOWN_CHANGE_PASSWORD_ERROR
          replaced by CHANGE_PASSWORD_FAILED 
 

Deprecated Methods
com.sap.security.api.UMFactory.addSystemLandscapeWrapper(ISystemLandscapeWrapper)
          Use UMFactory.getSystemLandscapeFactory() and ISystemLandscapeFactory.registerLandscape(ISystemLandscape) instead. 
com.sap.security.api.IUserMaint.addToGroup(String)
          use IGroupFactory.addUserToGroup(String,String) instead 
com.sap.security.api.IUserAccount.addToGroup(String)
          use IUserMaint.addToGroup(String) instead 
com.sap.security.api.IUserMaint.addToRole(String)
          use IRoleFactory.addUserToRole(String, String) instead 
com.sap.security.api.IUserAccount.addToRole(String)
          use IUserMaint.addToRole(String) instead 
com.sap.engine.interfaces.security.auth.AbstractLoginModule.changePasswordIfNeeded(String, CallbackHandler)
          This functionality is moved to the login context. 
com.sap.engine.interfaces.security.auth.AbstractLoginModule.changePasswordIfNeeded(UserContext, UserInfo, CallbackHandler)
          This functionality is moved to the login context. 
com.sap.engine.interfaces.security.auth.AbstractLoginModule.changePasswordIfNeeded(X509Certificate, CallbackHandler)
          This functionality is moved to the login context. 
com.sap.security.api.umap.IUserMapping.checkCryptoConfiguration(String)
          Use IUserMapping.checkCryptoConfiguration(ISystemLandscapeObject) instead. 
com.sap.engine.interfaces.security.auth.AbstractLoginModule.checkUserLockStatus(String)
          This functionality is moved to the login context. 
com.sap.engine.interfaces.security.auth.AbstractLoginModule.checkUserLockStatus(UserContext, UserInfo)
          This functionality is moved to the login context. 
com.sap.engine.interfaces.security.auth.AbstractLoginModule.checkUserLockStatus(X509Certificate)
          This functionality is moved to the login context. 
com.sap.security.core.server.csi.util.URLDecoder.decode(String)
          The resulting string may vary depending on the platform's default encoding. Instead, use the decode(String,String) method to specify the encoding. 
com.sap.security.core.server.csi.util.URLDecoder.decodeAll(String, String)
          Use decodeAll(String s, String enc, boolean ignoreExceptions) instead. 
com.sap.security.api.acl.IAclManager.deletePrincipal(IPrincipal)
          please use deletePrincipal(String principalID) 
com.sap.security.core.server.csi.util.URLEncoder.encode(String)
          The resulting string may vary depending on the platform's default encoding. Instead, use the encode(String,String) method to specify the encoding. 
com.sap.security.api.ticket.TicketVerifier.findCertificate(X509Certificate[], String, BigInteger)
          This method will be removed in the next release. Use TicketVerifier.findCertificates(java.security.cert.X509Certificate[], String, BigInteger) as replacement. 
com.sapmarkets.tpd.master.TradingPartnerDirectoryInterface.findTradingPartners(TradingPartnerInterface)
            
com.sapmarkets.tpd.master.TradingPartnerInterface.getAddress()
          not used or supported by UME 
com.sapmarkets.tpd.master.TradingPartnerDirectoryInterface.getAllBuyers(TradingPartnerInterface)
            
com.sap.security.api.ISecurityPolicy.getCertLogonRequired()
            
com.sap.security.api.IUserSearchFilter.getCompanyId()
          use IUserSearchFilter.getCompany() instead. 
com.sap.security.api.ISecurityPolicy.getCookieLifeTime()
            
com.sapmarkets.tpd.master.TradingPartnerInterface.getCreateTimestamp()
          not used or supported by UME 
com.sapmarkets.tpd.master.TradingPartnerInterface.getCurrency()
          not used or supported by UME 
com.sap.security.api.UMFactory.getDefaultFactory()
          : use UMFactory.getUserFactory() instead 
com.sapmarkets.tpd.master.TradingPartnerInterface.getDescription()
          not used or supported by UME 
com.sap.security.core.server.destinations.api.Destination.getDestinationProperties()
           
com.sapmarkets.tpd.master.TradingPartnerInterface.getDisabled()
          not used or supported by UME 
com.sapmarkets.tpd.master.TradingPartnerInterface.getDUNS()
          not used or supported by UME 
com.sap.security.api.IPrincipalSearchFilter.getElementAt(int)
          use IPrincipalSearchFilter.getSearchElementAt(int) instead 
com.sapmarkets.tpd.master.TradingPartnerInterface.getEmail()
          not used or supported by UME 
com.sapmarkets.tpd.master.TradingPartnerInterface.getFax()
          not used or supported by UME 
com.sapmarkets.tpd.master.TradingPartnerInterface.getGroupNames()
            
com.sapmarkets.tpd.master.TradingPartnerInterface.getId()
          Please use getPartnerID instead. Then call PartnerID.toString() to get the String representation of the ID. 
com.sap.security.core.server.vsi.api.Instance.getInfections()
          Do not use 
com.sap.security.api.umap.IUserMapping.getInverseMappingData(String, String, byte)
          Use IUserMapping.getInverseMappingData(String, ISystemLandscapeObject) instead. 
com.sap.security.core.server.destinations.api.DestinationService.getKeystoreViews()
            
com.sapmarkets.tpd.master.TradingPartnerInterface.getLanguage()
          not used or supported by UME 
com.sap.security.api.IUserAccount.getLastSuccessfulLogonDate()
            
com.sap.security.api.IUserAccount.getLockReason()
          use IUserAccount.isPasswordLocked() and IUserAccount.isUserAccountLocked() instead 
com.sapmarkets.tpd.master.TradingPartnerInterface.getLogoURL()
          not used or supported by UME 
com.sap.security.api.umap.IUserMapping.getMappedSystemsForPrincipal(IPrincipal)
          Call IUserMapping.existsMappingData(ISystemLandscapeObject, IPrincipal) for every relevant system. 
com.sap.security.api.IRoleFactory.getMaxRoleDescriptionLength()
          the maximum length is defined in (String, String, String[]) 
com.sapmarkets.tpd.master.TradingPartnerInterface.getModifyTimestamp()
          not used or supported by UME 
com.sap.security.api.logon.IAuthScheme.getModules()
          Use getAuthenticationTemplate instead to get the name of the authentication template which contains the login modules that are processed for logon. 
com.sapmarkets.tpd.master.TradingPartnerInterface.getMpid()
          Please use getPartnerID instead. Then call PartnerID.toString() to get the String representation of the ID. 
com.sapmarkets.tpd.master.TradingPartnerInterface.getName()
          Use getDisplayName instead. 
com.sapmarkets.tpd.master.TradingPartnerInterface.getOrgId()
          Please use getPartnerID instead. Then call PartnerID.toString() to get the String representation of the ID. 
com.sapmarkets.tpd.master.TradingPartnerDirectoryInterface.getPartner(String)
          use getPartner(PartnerID) 
com.sapmarkets.tpd.master.TradingPartnerDirectoryInterface.getPartners()
          using getPartners(STring serachString, int max) 
com.sapmarkets.tpd.master.TradingPartnerDirectoryInterface.getPartners(String)
          using getPartners(STring serachString, int max) 
com.sapmarkets.tpd.master.TradingPartnerDirectoryInterface.getPartnersByAddress(String, String, String, String, String, String)
            
com.sap.security.api.ISecurityPolicy.getPasswordChangeRequired()
            
com.sap.security.api.IUserAccount.getPreviousSuccessfulLogonDate()
            
com.sap.security.api.UMFactory.getProperties()
          Released for internal use only 
com.sap.security.api.umap.IUserMapping.getR3UserName(IUser, String, Map, boolean)
          Use IUserMapping.getR3UserName(IUser,ISystemLandscapeObject,boolean) instead. 
com.sap.security.core.server.vsi.api.Instance.getScanErrors()
          Do not use 
com.sap.security.core.server.securestorage.SecureStorageRuntimeInterface.getSecureStorageClientContext()
          use secure/protected entries of Configuration 
com.sap.security.core.server.securestorage.SecureStorageRuntimeInterface.getSecureStorageClientContext(String)
          use secure/protected entries of Configuration 
com.sap.security.core.server.securestorage.SecureStorageRuntimeInterface.getSecureStorageClientContext(String, int)
          use secure/protected entries of Configuration 
com.sap.security.api.ticket.TicketVerifier.getSignerCertificate()
          This method will be removed in the next release. Use TicketVerifier.getSignerCert() instead. 
com.sap.security.api.IUserAccount.getSuccessfulLogonCounts()
            
com.sap.security.api.UMFactory.getSystemLandscapeWrappers()
          Use UMFactory.getSystemLandscapeFactory() and ISystemLandscapeFactory.getAllLandscapes() resp. ISystemLandscapeFactory.getLandscape(String) instead. 
com.sapmarkets.tpd.master.TradingPartnerInterface.getTandC()
          not used or supported by UME 
com.sapmarkets.tpd.master.TradingPartnerInterface.getTelephone()
          not used or supported by UME 
com.sap.security.api.UMFactory.getTicketVerifier()
          Please use the native library "SAPSSOEXT" and the corresponding Java wrapper. For further information, including where to download the "SAPSSOEXT" package, please refer to the online documentation. 
com.sapmarkets.tpd.master.TradingPartnerInterface.getTimezone()
          not used or supported by UME 
com.sapmarkets.tpd.master.TradingPartnerInterface.getTPOrderBy()
          not used or supported by UME 
com.sapmarkets.tpd.master.TradingPartnerInterface.getTPShortName()
          not used or supported by UME 
com.sapmarkets.tpd.master.TradingPartnerInterface.getType()
          not used or supported by UME 
com.sap.security.api.IUser.getUid()
          new applications should use IPrincipal.getUniqueID(). 
com.sap.security.api.umap.IUserMapping.getUserMappingData(String, IPrincipal, Map)
          Use IUserMapping.getUserMappingData(ISystemLandscapeObject,IPrincipal) instead. 
com.sapmarkets.tpd.master.TradingPartnerInterface.getVisibility()
          not used or supported by UME 
com.sapmarkets.tpd.master.TradingPartnerInterface.getWebsite()
          not used or supported by UME 
com.sap.security.api.IUserAccount.incrementSuccessfulLogonCounts()
            
com.sap.security.api.logon.ILogonAuthentication.isAuthenticated(IUser)
            
com.sap.security.api.IUserAccount.isLocked()
          use IUserAccount.isPasswordLocked() and IUserAccount.isUserAccountLocked() instead 
com.sap.security.api.ISecurityPolicy.isPasswordValid(String)
          please use isPasswordValid(String pass, String logonId) 
com.sap.engine.interfaces.security.auth.AbstractLoginModule.isUserAccountExpired(String)
          This functionality is moved to the login context. 
com.sap.engine.interfaces.security.auth.AbstractLoginModule.isUserAccountExpired(UserInfo, UserContext)
          This functionality is moved to the login context. 
com.sap.security.api.IUserMaint.removeFromGroup(String)
          use IGroupFactory.removeUserFromGroup(String, String) instead 
com.sap.security.api.IUserAccount.removeFromGroup(String)
          use IUserMaint.removeFromGroup(String) instead 
com.sap.security.api.IUserMaint.removeFromRole(String)
          use IRoleFactory.removeUserFromRole(String, String) instead 
com.sap.security.api.IUserAccount.removeFromRole(String)
          use IUserMaint.removeFromRole(String) instead 
com.sap.security.api.UMFactory.removeSystemLandscapeWrapper(ISystemLandscapeWrapper)
          Use UMFactory.getSystemLandscapeFactory() and ISystemLandscapeFactory.unregisterLandscape(ISystemLandscape) instead. 
com.sap.security.core.server.vsi.api.Instance.setActiveContent(boolean)
          this method has no effect 
com.sap.security.api.ISecurityPolicy.setAutoUnlockTime(int)
            
com.sap.security.api.ISecurityPolicy.setCertLogonRequired(boolean)
            
com.sap.security.api.IUserSearchFilter.setCompanyId(String, int, boolean)
          use IUserSearchFilter.setCompany(String, int, boolean) instead. 
com.sap.security.api.ISecurityPolicy.setCookieLifeTime(int)
            
com.sap.security.core.server.destinations.api.Destination.setDestinationProperties(Properties)
           
com.sap.security.api.ISecurityPolicy.setEnforcePolicyAtLogon(boolean)
            
com.sap.security.api.IUserAccount.setLastSuccessfulLogonDate(Date)
            
com.sap.security.api.ISecurityPolicy.setLockAfterInvalidAttempts(int)
            
com.sap.security.api.ISecurityPolicy.setLogonIdLowerCaseRequired(int)
            
com.sap.security.api.ISecurityPolicy.setLogonIdMaxLength(int)
            
com.sap.security.api.ISecurityPolicy.setLogonIdMinLength(int)
            
com.sap.security.api.ISecurityPolicy.setLogonIdNumericDigitsRequired(int)
            
com.sap.security.api.ISecurityPolicy.setLogonIdSpecialCharRequired(int)
            
com.sap.security.api.ISecurityPolicy.setOldInNewAllowed(boolean)
            
com.sap.security.api.ISecurityPolicy.setPasswordAlphaNumericRequired(int)
            
com.sap.security.api.ISecurityPolicy.setPasswordChangeAllowed(boolean)
            
com.sap.security.api.ISecurityPolicy.setPasswordChangeRequired(boolean)
            
com.sap.security.api.ISecurityPolicy.setPasswordExpiredDays(int)
            
com.sap.security.api.ISecurityPolicy.setPasswordHistory(int)
            
com.sap.security.api.ISecurityPolicy.setPasswordMaxIdleTime(int)
            
com.sap.security.api.ISecurityPolicy.setPasswordMaxLength(int)
            
com.sap.security.api.ISecurityPolicy.setPasswordMinLength(int)
            
com.sap.security.api.ISecurityPolicy.setPasswordMixCaseRequired(int)
            
com.sap.security.api.ISecurityPolicy.setPasswordPasswordLastChangeDateDefault(Date)
            
com.sap.security.api.ISecurityPolicy.setPasswordSpecialCharRequired(int)
            
com.sap.security.api.ISecurityPolicy.setPasswordSuccessfulCheckDateDefault(Date)
            
com.sap.security.core.server.vsi.api.Instance.setScanInfo(boolean)
          this method has no effect 
com.sap.security.api.IUserAccount.setSuccessfulLogonCounts(int)
            
com.sap.security.api.ISecurityPolicy.setUseridInPasswordAllowed(boolean)
            
com.sap.security.api.ISecurityPolicy.setUserName(String)
            
com.sap.security.core.server.ssf.SsfDataXML.sign(Element, SsfRefXMLList, ISsfProfile, int, boolean)
          Use sign(Element sigHome, SsfRefXMLList refList, ISsfProfile profile, int incCerts, boolean detached, boolean incKeyName) instead 
com.sap.security.core.server.ssf.SsfDataXML.sign(SsfRefXMLList, ISsfProfile, int, boolean)
          Use sign(Element sigHome, SsfRefXMLList refList, ISsfProfile profile, int incCerts, boolean detached, boolean incKeyName) instead 
com.sap.security.api.umap.IUserMappingData.storeLogonData(Map)
          Please use IUserMappingData.saveLogonData(Map) instead which supports more differentiated exception handling.

Store logon data for a specific user and backend system.

Please consider calling IUserMappingData.isReadOnly() before to make sure this user mapping entry can be (over)written.

 
com.sap.security.api.ISecurityPolicy.validatePassword(String)
          please use validatePassword(String pass, String uid) 
com.sap.security.api.ticket.TicketVerifier.verifyCertificate(X509Certificate[], X509Certificate, boolean)
          The method is not used any more. The chain of the ticket signing certificate must not be verified. 
com.sap.engine.interfaces.security.auth.AbstractLoginModule.writeLogonStatistics(boolean, String, long, Map)
          This functionality is moved to the login context. 
com.sap.engine.interfaces.security.auth.AbstractLoginModule.writeLogonStatistics(boolean, UserInfo, long, Map)
          This functionality is moved to the login context. 
 

Deprecated Constructors
com.sap.security.core.server.util0.IDMessage(IDMessage.BaseMsg, Object[], String, String, String)
          Switch to AS Java MessageID infrastructure by using the constructor with three parameters, where you specify the MessageID prefix. 
 



Copyright 2014 SAP AG Complete Copyright Notice