Appendix G - ARWebService Related Exceptions
            
         
        
             
The Secure Access Web Service (ARWebService) can throw the following application exceptions. The type of the exception is PortSight.SecureAccess.WebServices.Common.ARWSException. It is derived from System.ApplicationException and extends this base class by ErrorCode property that uniquely specifies the error.
Class PortSight.SecureAccess.WebServices.Service.ARWSWebService throws:
    - 
    (1001) "Symmetric encryption required but the request was not encrypted." 
Note: It is requested to encrypt the requests / responses using symmetric encryption but the request was not encrypted.
    
    
    
     - 
    (1002) "Symmetric encryption required but the symmetric key was not specified." 
    
    
Note: 
    
    It is requested to encrypt the requests / responses using symmetric encryption but the symmetric key was not specified.
    
    
    
     - 
    (1003) " 
    
    X509 encryption required but the request was not encrypted using service's certificate. 
    
    
    
    "
Note: It is requested to encrypt the requests / responses using X509 encryption but the request was not encrypted.
    
    
    
     - 
    (1004) "X509 data encryption required but the response cannot be encrypted becouse of the request was not signed using client's private key." 
Note: The request must be signed using client's private certificate in order to provide client's public key to the service so the service can encrypt the response using client's public key.
    
    
    
     - 
    (1005) "X509 signature required but the reuqest was not signed." 
Note: It is requested to encrypt the requests / responses using symmetric encryption but the symmetric key was not specified.
    
    
    
     - 
    (1006) "X509 signature required but the service certificate with private key was not specified." 
Note: It is requested to sign the responses using X509 signature but the Subject Key Identifier of the service certificate was not specified.
    
    
    
     - 
    (1007) "Only SOAP requests are permitted."
Note: If we don't have a request SOAP context, we need to throw an exception because we were not given a SOAP request.
    
    
    
     - 
    (1008) "No matching certificates were found for the key ID provided." 
Note: The certificate specified by its Subject Key Identifier cannot be found in the LocalMachine certificate store. 
    
    
    
     - 
    (1009) "SecureAccessTimeToLive parameter in the .config file has an invalid value. An integer value (number of milliseconds) is expected."
    
    
    
     - 
    (1010) - 
    
    SecureAccessRuleSymmetricEncryptionRequired parameter in the .config file has an invalid value. A boolean value ("true" or "false") is expected.
    
    
    
     - 
    (1011) - SecureAccessRuleX509EncryptionRequired parameter in the .config file has an invalid value. A boolean value ("true" or "false") is expected.
    
    
    
     - 
    (1012) - SecureAccessRuleX509SignatureRequired parameter in the .config file has an invalid value. A boolean value ("true" or "false") is expected.
    
    
    
     - 
    (1013) - Authentication Failed. Provided loginname doesn't exist.
    
    
    
     - 
    (1014) - Authentication Failed. Password has expired.
    
    
    
     - 
    (1015) - Authentication Failed. The provided account is locked.
    
    
    
     - 
    (1016) - Authentication Failed. Provided password is incorrect.
    
    
    
     - 
    (1017) - Cannot read catalog data from the catalogs.xml file 
    
    
    
     - 
    (1018) 
    
    - Cannot connect to the catalog.
    
    
    
     - 
    (1019) - Error occurred while authenticating the user.
    
    
    
     - 
    (1020) - Cannot get object from the catalog.
    
    
    
     - 
    (1021) - Cannot change password - An error occured while updating the user account.
    
    
    
     - 
    (1022) - Password is too short (see catalog settings for min. size).
    
    
    
     - 
    (1023) - Password contains too few capital characters (see catalog settings for min. number).
    
    
    
     - 
    (1024) - Password contains too few numerals (see catalog settings for min. number).
    
    
    
     - 
    (1025) - Password contains too few special characters (see catalog settings for min. number).
    
    
    
     - (1026) - Password is the same as current. 
 
Class PortSight.SecureAccess.WebServices.Common.ARWSDecryptionKeyProvider throws:
    - 
    (2001) 
    
    "Symmetric key not found in configuration." 
Note: The message was encrypted using symmetric key, but cannot be decrypted because of the symmetric key is not specified in the configuration file.
    
    
    
     - 
    (2002) "Key name not supported." 
Note: The message was encrypted using symmetric key, whose name is not supported by Secure Access Web Service. 
    
    
    
     - (2003) "Hexadecimal data on input has incorrect length (must be multiple of 2)." 
 
Class PortSight.SecureAccess.WebServices.Client.ARWSClient throws:
    - 
    (3001) "No matching certificates were found for the key ID provided." The certificate specified by its Subject Key Identifier cannot be found in the CurrentUser certificate store. 
    
    
    
     - 
    (3002) 
    
    "The certificate must support data encryption." - The certificate specified to be used for message encrytion does not support encryption.
    
     - (3003) "The certificate must support data signing." - The certificate specified to be used for signing the message does not support data signing.