66fbe847b07e426ede8ec273deff6af998c608c0
[aaf/authz.git] / cadi / core / src / main / java / org / onap / aaf / cadi / config / Config.java
1 /**
2  * ============LICENSE_START====================================================
3  * org.onap.aaf
4  * ===========================================================================
5  * Copyright (c) 2018 AT&T Intellectual Property. All rights reserved.
6  * ===========================================================================
7  * Licensed under the Apache License, Version 2.0 (the "License");
8  * you may not use this file except in compliance with the License.
9  * You may obtain a copy of the License at
10  * 
11  *      http://www.apache.org/licenses/LICENSE-2.0
12  * 
13  * Unless required by applicable law or agreed to in writing, software
14  * distributed under the License is distributed on an "AS IS" BASIS,
15  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
16  * See the License for the specific language governing permissions and
17  * limitations under the License.
18  * ============LICENSE_END====================================================
19  *
20  */
21
22 package org.onap.aaf.cadi.config;
23
24 import java.io.IOException;
25 import java.lang.reflect.Constructor;
26 import java.lang.reflect.Field;
27 import java.lang.reflect.InvocationTargetException;
28 import java.lang.reflect.Method;
29 import java.net.HttpURLConnection;
30 import java.net.InetAddress;
31 import java.net.URI;
32 import java.net.UnknownHostException;
33 import java.security.NoSuchAlgorithmException;
34 import java.security.cert.CertificateException;
35 import java.util.ArrayList;
36 import java.util.Collections;
37 import java.util.List;
38
39 import org.onap.aaf.cadi.AbsUserCache;
40 import org.onap.aaf.cadi.Access;
41 import org.onap.aaf.cadi.Access.Level;
42 import org.onap.aaf.cadi.CachingLur;
43 import org.onap.aaf.cadi.CadiException;
44 import org.onap.aaf.cadi.Connector;
45 import org.onap.aaf.cadi.CredVal;
46 import org.onap.aaf.cadi.CredValDomain;
47 import org.onap.aaf.cadi.Locator;
48 import org.onap.aaf.cadi.LocatorException;
49 import org.onap.aaf.cadi.Lur;
50 import org.onap.aaf.cadi.PropAccess;
51 import org.onap.aaf.cadi.Symm;
52 import org.onap.aaf.cadi.TrustChecker;
53 import org.onap.aaf.cadi.lur.EpiLur;
54 import org.onap.aaf.cadi.lur.LocalLur;
55 import org.onap.aaf.cadi.lur.NullLur;
56 import org.onap.aaf.cadi.taf.HttpEpiTaf;
57 import org.onap.aaf.cadi.taf.HttpTaf;
58 import org.onap.aaf.cadi.taf.basic.BasicHttpTaf;
59 import org.onap.aaf.cadi.taf.cert.X509Taf;
60 import org.onap.aaf.cadi.taf.dos.DenialOfServiceTaf;
61 import org.onap.aaf.cadi.util.FixURIinfo;
62 import org.onap.aaf.cadi.util.Split;
63
64 /**
65  * Create a Consistent Configuration mechanism, even when configuration styles are as vastly different as
66  * Properties vs JavaBeans vs FilterConfigs...
67  * 
68  * @author Jonathan
69  *
70  */
71 public class Config {
72
73     private static final String AAF_V2_0 = "org.onap.aaf.cadi.aaf.v2_0";
74     private static final String AAF_V2_0_AAFCON = AAF_V2_0+".AAFCon";
75     private static final String AAF_V2_0_AAF_LUR_PERM = AAF_V2_0+".AAFLurPerm";
76     private static final String OAUTH = "org.onap.auth.oauth";
77     private static final String OAUTH_TOKEN_MGR = OAUTH+".TokenMgr";
78     private static final String OAUTH_HTTP_TAF = OAUTH+".OAuth2HttpTaf";
79     private static final String OAUTH_DIRECT_TAF = OAUTH+".OAuthDirectTAF";
80     public static final String UTF_8 = "UTF-8";
81
82     // Property Names associated with configurations.
83     // As of 1.0.2, these have had the dots removed so as to be compatible with JavaBean style
84     // configurations as well as property list style.
85     public static final String HOSTNAME = "hostname";
86     public static final String CADI_PROP_FILES = "cadi_prop_files"; // Additional Properties files (separate with ;)
87     public static final String CADI_LOGLEVEL = "cadi_loglevel";
88     public static final String CADI_LOGDIR = "cadi_log_dir";
89     public static final String CADI_ETCDIR = "cadi_etc_dir";
90     public static final String CADI_LOGNAME = "cadi_logname";
91 //    public static final String CADI_LOGFMT="cad_logging_format";
92 //    public static final String CADI_LOGFMT_UTC="UTC";
93 //    public static final String CADI_LOGFMT_ISO8601="ISO-8601";
94     public static final String CADI_KEYFILE = "cadi_keyfile";
95     public static final String CADI_KEYSTORE = "cadi_keystore";
96     public static final String CADI_KEYSTORE_PASSWORD = "cadi_keystore_password";
97     public static final String CADI_ALIAS = "cadi_alias";
98     public static final String CADI_CLIENT_ALIAS = "cadi_client_alias";
99     public static final String CADI_LOGINPAGE_URL = "cadi_loginpage_url";
100     public static final String CADI_LATITUDE = "cadi_latitude";
101     public static final String CADI_LONGITUDE = "cadi_longitude";
102
103
104     public static final String CADI_KEY_PASSWORD = "cadi_key_password";
105     public static final String CADI_TRUSTSTORE = "cadi_truststore";
106     public static final String CADI_TRUSTSTORE_PASSWORD = "cadi_truststore_password";
107     public static final String CADI_X509_ISSUERS = "cadi_x509_issuers";
108     public static final String CADI_TRUST_MASKS="cadi_trust_masks";
109     public static final String CADI_TRUST_PERM="cadi_trust_perm"; //  IDs with this perm can utilize the "AS " user concept
110     public static final String CADI_PROTOCOLS = "cadi_protocols";
111     public static final String CADI_NOAUTHN = "cadi_noauthn";
112     public static final String CADI_LOC_LIST = "cadi_loc_list";
113     
114     // Special Behaviors
115     public static final String CADI_BATH_CONVERT = "cadi_bath_convert";
116     public static final String CADI_API_ENFORCEMENT = "cadi_api_enforcement";
117     public static final String CADI_ADD_TAFS = "cadi_add_tafs";
118     public static final String CADI_ADD_LURS = "cadi_add_lurs";
119     
120     public static final String CADI_USER_CHAIN_TAG = "cadi_user_chain";
121     public static final String CADI_USER_CHAIN = "USER_CHAIN";
122     
123     public static final String CADI_OAUTH2_URL="cadi_oauth2_url";
124     public static final String CADI_TOKEN_DIR = "cadi_token_dir";
125
126     public static final String HTTPS_PROTOCOLS = "https.protocols";
127     public static final String HTTPS_CLIENT_PROTOCOLS="jdk.tls.client.protocols";
128     public static final String HTTPS_PROTOCOLS_DEFAULT = "TLSv1.1,TLSv1.2";
129     public static final String HTTPS_CIPHER_SUITES = "https.cipherSuites";
130     public static final String HTTPS_CIPHER_SUITES_DEFAULT="TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256,TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA,"
131             + "TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA,TLS_RSA_WITH_AES_128_CBC_SHA,TLS_ECDH_ECDSA_WITH_AES_128_CBC_SHA,"
132             + "TLS_ECDH_RSA_WITH_AES_128_CBC_SHA,TLS_DHE_RSA_WITH_AES_128_CBC_SHA,TLS_DHE_DSS_WITH_AES_128_CBC_SHA,"
133             + "TLS_ECDHE_ECDSA_WITH_RC4_128_SHA,TLS_ECDHE_RSA_WITH_RC4_128_SHA,TLS_ECDH_ECDSA_WITH_RC4_128_SHA,"
134             + "TLS_ECDH_RSA_WITH_RC4_128_SHA,TLS_ECDHE_ECDSA_WITH_3DES_EDE_CBC_SHA,TLS_ECDHE_RSA_WITH_3DES_EDE_CBC_SHA,"
135             + "TLS_ECDH_ECDSA_WITH_3DES_EDE_CBC_SHA,TLS_ECDH_RSA_WITH_3DES_EDE_CBC_SHA,TLS_EMPTY_RENEGOTIATION_INFO_SCSV";
136              
137
138     public static final String LOCALHOST_ALLOW = "localhost_allow";
139     public static final String LOCALHOST_DENY = "localhost_deny";
140     
141     public static final String BASIC_REALM = "basic_realm";  // what is sent to the client 
142     public static final String BASIC_WARN = "basic_warn";  // Warning of insecure channel 
143     public static final String USERS = "local_users";
144     public static final String GROUPS = "local_groups";
145     public static final String WRITE_TO = "local_writeto"; // dump RBAC to local file in Tomcat Style (some apps use)
146     
147     public static final String OAUTH_CLIENT_ID="client_id";
148     public static final String OAUTH_CLIENT_SECRET="client_secret";
149     
150     public static final String AAF_ENV = "aaf_env";
151     public static final String AAF_ROOT_NS = "aaf_root_ns";
152     public static final String AAF_ROOT_NS_DEF = "org.osaaf.aaf";
153     public static final String AAF_ROOT_COMPANY = "aaf_root_company";
154     /**
155      * Use Config.getAAFLocateUrl(access) to get correct property in/out of container
156      */
157     public static final String AAF_LOCATE_URL = "aaf_locate_url"; //URL for AAF locator
158     public static final String AAF_LOCATE_URL_TAG = "AAF_LOCATE_URL"; // Name of Above for use in Config Variables.
159     public static final String AAF_DEFAULT_API_VERSION = "2.1";
160     public static final String AAF_API_VERSION = "aaf_api_version";
161     public static final String AAF_URL = "aaf_url"; //URL for AAF... Use to trigger AAF configuration   
162     public static final String AAF_LOCATOR_CLASS = "aaf_locator_class";
163     // AAF Locator Entries are ADDITIONAL entries, which also gives the Property ability
164     // to set these entries manually
165     // example: adding a K8S name like "oom"
166     // this will allow Registrations to pick up 
167     // locator_ns.oom for onap's "OOM" based k8s entries, etc.
168     public static final String AAF_LOCATOR_CONTAINER="aaf_locator_container";
169     // An ID for another Container, to be used to avoid picking up the wrong internal info 
170     // for another container.
171     public static final String AAF_LOCATOR_CONTAINER_ID = "aaf_locator_container_id";
172     public static final String AAF_LOCATOR_CONTAINER_NS = "aaf_locator_container_ns";
173     public static final String AAF_LOCATOR_VERSION = "aaf_locator_version";
174     public static final String AAF_LOCATOR_PROTOCOL = "aaf_locator_protocol";
175     public static final String AAF_LOCATOR_SUBPROTOCOL = "aaf_locator_subprotocol";
176     public static final String AAF_LOCATOR_APP_NS = "aaf_locator_app_ns";
177     public static final String AAF_LOCATOR_ENTRIES = "aaf_locator_entries";
178     public static final String AAF_LOCATOR_FQDN = "aaf_locator_fqdn";
179     public static final String AAF_LOCATOR_NAME = "aaf_locator_name";
180     public static final String AAF_LOCATOR_PUBLIC_PORT = "aaf_locator_public_port";
181     public static final String AAF_LOCATOR_PUBLIC_FQDN = "aaf_locator_public_fqdn";
182     public static final String AAF_LOCATOR_PUBLIC_NAME = "aaf_locator_public_name";
183     
184     // AAF Service will write to the Audit Log if a past due AAF stored Password
185     // is being used within # of days specified.
186     public static final String AAF_CRED_WARN_DAYS="aaf_cred_warn_days";
187     public static final String AAF_CRED_WARN_DAYS_DFT="7";
188
189     public static final String AAF_APPID = "aaf_id";
190     public static final String AAF_APPPASS = "aaf_password";
191     public static final String AAF_LUR_CLASS = "aaf_lur_class";
192     public static final String AAF_TAF_CLASS = "aaf_taf_class";
193     public static final String AAF_CONNECTOR_CLASS = "aaf_connector_class";
194     public static final String AAF_CONN_TIMEOUT = "aaf_conn_timeout";
195     public static final String AAF_CONN_TIMEOUT_DEF = "3000";
196     public static final String AAF_CONN_IDLE_TIMEOUT = "aaf_conn_idle_timeout"; // only for Direct Jetty Access.
197     public static final String AAF_CONN_IDLE_TIMEOUT_DEF = "10000"; // only for Direct Jetty Access.
198      
199     // Default Classes: These are for Class loading to avoid direct compile links
200     public static final String AAF_TAF_CLASS_DEF = "org.onap.aaf.cadi.aaf.v2_0.AAFTaf";
201     public static final String AAF_LOCATOR_CLASS_DEF = "org.onap.aaf.cadi.aaf.v2_0.AAFLocator";
202     public static final String CADI_OLUR_CLASS_DEF = "org.onap.aaf.cadi.olur.OLur";
203     public static final String CADI_OBASIC_HTTP_TAF_DEF = "org.onap.aaf.cadi.obasic.OBasicHttpTaf";
204     public static final String CADI_AAF_CON_DEF = "org.onap.aaf.cadi.aaf.v2_0.AAFCon";
205
206     public static final String AAF_CALL_TIMEOUT = "aaf_timeout";
207     public static final String AAF_CALL_TIMEOUT_DEF = "5000";
208     public static final String AAF_USER_EXPIRES = "aaf_user_expires";
209     public static final String AAF_USER_EXPIRES_DEF = "600000"; // Default is 10 mins
210     public static final String AAF_CLEAN_INTERVAL = "aaf_clean_interval";
211     public static final String AAF_CLEAN_INTERVAL_DEF = "30000"; // Default is 30 seconds
212     public static final String AAF_REFRESH_TRIGGER_COUNT = "aaf_refresh_trigger_count";
213     public static final String AAF_REFRESH_TRIGGER_COUNT_DEF = "3"; // Default is 10 mins
214     
215     public static final String AAF_HIGH_COUNT = "aaf_high_count";
216     public static final String AAF_HIGH_COUNT_DEF = "1000"; // Default is 1000 entries
217     public static final String AAF_PERM_MAP = "aaf_perm_map";
218 //    public static final String AAF_COMPONENT = "aaf_component";
219     public static final String AAF_CERT_IDS = "aaf_cert_ids";
220     public static final String AAF_DEBUG_IDS = "aaf_debug_ids"; // comma delimited
221     public static final String AAF_DATA_DIR = "aaf_data_dir"; // AAF processes and Components only.
222     public static final String AAF_RELEASE = "aaf_release";
223
224     public static final String AAF_URL_GUI="aaf_url_gui";
225     public static final String AAF_URL_FS="aaf_url_fs";
226     public static final String AAF_URL_CM = "aaf_url_cm";
227     public static final String AAF_URL_CM_DEF = "https://AAF_LOCATE_URL/AAF_NS.cm:"+AAF_DEFAULT_API_VERSION;
228     public static final String AAF_URL_HELLO = "aaf_url_hello";
229     public static final String CM_TRUSTED_CAS = "cm_trusted_cas";
230
231     public static final String PATHFILTER_URLPATTERN = "pathfilter_urlpattern";
232     public static final String PATHFILTER_STACK = "pathfilter_stack";
233     public static final String PATHFILTER_NS = "pathfilter_ns";
234     public static final String PATHFILTER_NOT_AUTHORIZED_MSG = "pathfilter_not_authorized_msg";
235
236     // This one should go unpublic
237     public static final String AAF_DEFAULT_REALM = "aaf_default_realm";
238     private static String defaultRealm="none";
239
240     public static final String AAF_DOMAIN_SUPPORT = "aaf_domain_support";
241     public static final String AAF_DOMAIN_SUPPORT_DEF = ".com:.org";
242
243     // OAUTH2
244     public static final String AAF_OAUTH2_TOKEN_URL = "aaf_oauth2_token_url";
245     public static final String AAF_OAUTH2_INTROSPECT_URL = "aaf_oauth2_introspect_url";
246     public static final String AAF_ALT_OAUTH2_TOKEN_URL = "aaf_alt_oauth2_token_url";
247     public static final String AAF_ALT_OAUTH2_INTROSPECT_URL = "aaf_alt_oauth2_introspect_url";
248     public static final String AAF_ALT_OAUTH2_DOMAIN = "aaf_alt_oauth2_domain"; 
249     public static final String AAF_ALT_CLIENT_ID = "aaf_alt_oauth2_client_id";
250     public static final String AAF_ALT_CLIENT_SECRET = "aaf_alt_oauth2_client_secret";
251     public static final String AAF_OAUTH2_HELLO_URL = "aaf_oauth2_hello_url";
252
253     private static final String AAF_V2_0_AAF_CON_HTTP = "org.onap.aaf.cadi.aaf.v2_0.AAFConHttp";
254
255
256     public static void setDefaultRealm(Access access) {
257         try {
258             defaultRealm = logProp(access,Config.AAF_DEFAULT_REALM,
259                 logProp(access,Config.BASIC_REALM,
260                     logProp(access,HOSTNAME,InetAddress.getLocalHost().getHostName())
261                     )
262                 );
263         } catch (UnknownHostException e) {
264             access.log(Level.INIT, "Unable to determine Hostname",e);
265         }
266     }
267
268     public static HttpTaf configHttpTaf(Connector con, SecurityInfoC<HttpURLConnection> si, TrustChecker tc, CredVal up, Lur lur, Object ... additionalTafLurs) throws CadiException, LocatorException {
269         Access access = si.access;
270         RegistrationPropHolder rph;
271         try {
272                         rph = new RegistrationPropHolder(access, 0);
273                 } catch (UnknownHostException e2) {
274                         throw new CadiException(e2);
275                 }
276         /////////////////////////////////////////////////////
277         // Setup AAFCon for any following
278         /////////////////////////////////////////////////////
279         Class<?> aafConClass = loadClass(access,CADI_AAF_CON_DEF);
280         Object aafcon = null;
281         if (con!=null && aafConClass!=null && aafConClass.isAssignableFrom(con.getClass())) {
282             aafcon = con;
283         } else if (lur != null) {
284             Field f;
285             try {
286                 f = lur.getClass().getField("aaf");
287                 aafcon = f.get(lur);
288             } catch (Exception e) {
289                 access.log(Level.INIT, e);
290             }
291         }
292
293         boolean hasDirectAAF = hasDirect("DirectAAFLur",additionalTafLurs);
294         // IMPORTANT!  Don't attempt to load AAF Connector if there is no AAF URL
295         String aafURL = logProp(rph, AAF_URL,null);
296         if (!hasDirectAAF && aafcon==null && aafURL!=null) {
297             aafcon = loadAAFConnector(si, aafURL);    
298         }
299         
300         HttpTaf taf;
301         // Setup Host, in case Network reports an unusable Hostname (i.e. VTiers, VPNs, etc)
302         String hostname = logProp(access, HOSTNAME,null);
303         if (hostname==null) {
304             try {
305                 hostname = InetAddress.getLocalHost().getHostName();
306             } catch (UnknownHostException e1) {
307                 throw new CadiException("Unable to determine Hostname",e1);
308             }
309         }
310         
311         access.log(Level.INIT, "Hostname set to",hostname);
312         // Get appropriate TAFs
313         ArrayList<Priori<HttpTaf>> htlist = new ArrayList<>();
314
315         /////////////////////////////////////////////////////
316         // Add a Denial of Service TAF
317         // Note: how IPs and IDs are added are up to service type.
318         // They call "DenialOfServiceTaf.denyIP(String) or denyID(String)
319         /////////////////////////////////////////////////////
320         htlist.add(new Priori<HttpTaf>(new DenialOfServiceTaf(access),0));
321
322         /////////////////////////////////////////////////////
323         // Configure Client Cert TAF
324         /////////////////////////////////////////////////////
325         X509Taf x509TAF = null;
326         String truststore = logProp(access, CADI_TRUSTSTORE,null);
327         if (truststore!=null) {
328             String truststorePwd = access.getProperty(CADI_TRUSTSTORE_PASSWORD,null);
329             if (truststorePwd!=null) {
330                 if (truststorePwd.startsWith(Symm.ENC)) {
331                     try {
332                         access.decrypt(truststorePwd,false);
333                     } catch (IOException e) {
334                         throw new CadiException(CADI_TRUSTSTORE_PASSWORD + " cannot be decrypted",e);
335                     }
336                 }
337                 try {
338                     x509TAF=new X509Taf(access,lur);
339                     htlist.add(new Priori<HttpTaf>(x509TAF,10));
340                     access.log(Level.INIT,"Certificate Authorization enabled");
341                 } catch (SecurityException | IllegalArgumentException e) {
342                     access.log(Level.INIT,"AAFListedCertIdentity cannot be instantiated. Certificate Authorization is now disabled",e);
343                 } catch (CertificateException e) {
344                     access.log(Level.INIT,"Certificate Authorization failed, it is disabled",e);
345                 } catch (NoSuchAlgorithmException e) {
346                     access.log(Level.INIT,"Certificate Authorization failed, wrong Security Algorithm",e);
347                 }
348             }
349         } else {
350             access.log(Level.INIT,"Certificate Authorization not enabled");
351         }
352         
353         /////////////////////////////////////////////////////
354         // Configure Basic Auth (local content)
355         /////////////////////////////////////////////////////
356         boolean hasOAuthDirectTAF = hasDirect("DirectOAuthTAF", additionalTafLurs);
357         String basicRealm = logProp(access, BASIC_REALM,null);
358         String aafCleanup = logProp(access, AAF_USER_EXPIRES,AAF_USER_EXPIRES_DEF); // Default is 10 mins
359         long userExp = Long.parseLong(aafCleanup);
360         boolean basicWarn = "TRUE".equals(access.getProperty(BASIC_WARN,"FALSE"));
361
362         if (!hasDirectAAF) {
363             HttpTaf aaftaf=null;
364             if (!hasOAuthDirectTAF) {
365                 if (basicRealm!=null) {
366                     @SuppressWarnings("unchecked")
367                     Class<HttpTaf> obasicCls = (Class<HttpTaf>)loadClass(access,CADI_OBASIC_HTTP_TAF_DEF);
368                     if (obasicCls!=null) {
369                         try {
370                             String tokenurl = logProp(rph,Config.AAF_OAUTH2_TOKEN_URL, null);
371                             String introspecturl = logProp(rph,Config.AAF_OAUTH2_INTROSPECT_URL, null);
372                             if (tokenurl==null || introspecturl==null) {
373                                 access.log(Level.INIT,"Both tokenurl and introspecturl are required. Oauth Authorization is disabled.");
374                             }
375                             Constructor<HttpTaf> obasicConst = obasicCls.getConstructor(PropAccess.class,String.class, String.class, String.class);
376                             htlist.add(new Priori<HttpTaf>(obasicConst.newInstance(access,basicRealm,tokenurl,introspecturl),20));
377                             access.log(Level.INIT,"Oauth supported Basic Authorization is enabled");
378                         } catch (NoSuchMethodException | SecurityException | InstantiationException | IllegalAccessException | IllegalArgumentException | InvocationTargetException e) {
379                             access.log(Level.INIT, e);
380                         }
381                     } else if (up!=null) {
382                         access.log(Level.INIT,"Basic Authorization is enabled using realm",basicRealm);
383                         // Allow warning about insecure channel to be turned off
384                         if (!basicWarn) {
385                             access.log(Level.INIT, "WARNING! The basicWarn property has been set to false.",
386                                 " There will be no additional warning if Basic Auth is used on an insecure channel");
387                         }
388                         BasicHttpTaf bht = new BasicHttpTaf(access, up, basicRealm, userExp, basicWarn);
389                         for (Object o : additionalTafLurs) {
390                             if (o instanceof CredValDomain) {
391                                 bht.add((CredValDomain)o);
392                             }
393                         }
394                         if (x509TAF!=null) {
395                             x509TAF.add(bht);
396                         }
397                         htlist.add(new Priori<HttpTaf>(bht,20));
398                         access.log(Level.INIT,"Basic Authorization is enabled");
399                     }
400                 } else {
401                     access.log(Level.INIT,"Local Basic Authorization is disabled.  Enable by setting basicRealm=<appropriate realm, i.e. my.att.com>");
402                 }
403             
404                 /////////////////////////////////////////////////////
405                 // Configure AAF Driven Basic Auth
406                 /////////////////////////////////////////////////////
407                 if (aafcon==null) {
408                     access.log(Level.INIT,"AAF Connection (AAFcon) is null.  Cannot create an AAF TAF");
409                 } else if (aafURL==null) {
410                     access.log(Level.INIT,"No AAF URL in properties, Cannot create an AAF TAF");
411                 } else {// There's an AAF_URL... try to configure an AAF 
412                     String aafTafClassName = logProp(access, AAF_TAF_CLASS,AAF_TAF_CLASS_DEF);
413                     // Only 2.0 available at this time
414                     if (AAF_TAF_CLASS_DEF.equals(aafTafClassName)) { 
415                         try {
416                             Class<?> aafTafClass = loadClass(access,aafTafClassName);
417                             if (aafTafClass!=null) {
418                                 Constructor<?> cstr = aafTafClass.getConstructor(Connector.class,boolean.class,AbsUserCache.class);
419                                 if (cstr!=null) {
420                                     if (lur instanceof AbsUserCache) {
421                                         aaftaf = (HttpTaf)cstr.newInstance(aafcon,basicWarn,lur);
422                                     } else {
423                                         cstr = aafTafClass.getConstructor(Connector.class,boolean.class);
424                                         if (cstr!=null) {
425                                             aaftaf = (HttpTaf)cstr.newInstance(aafcon,basicWarn);
426                                         }
427                                     }
428                                     if (aaftaf==null) {
429                                         access.log(Level.INIT,"ERROR! AAF TAF Failed construction.  NOT Configured");
430                                     } else {
431                                         access.log(Level.INIT,"AAF TAF Configured to ",aafURL);
432                                         // Note: will add later, after all others configured
433                                     }
434                                 }
435                             } else {
436                                 access.log(Level.INIT, "There is no AAF TAF class available: %s. AAF TAF not configured.",aafTafClassName);
437                             }
438                         } catch (Exception e) {
439                             access.log(Level.INIT,"ERROR! AAF TAF Failed construction.  NOT Configured",e);
440                         }
441                     }
442                 }
443             }
444             
445             /////////////////////////////////////////////////////
446             // Configure OAuth TAF
447             /////////////////////////////////////////////////////
448             if (!hasOAuthDirectTAF) {
449                 String oauthTokenUrl = logProp(rph,Config.AAF_OAUTH2_TOKEN_URL,null);
450                 Class<?> oadtClss;
451                 try {
452                     oadtClss = Class.forName(OAUTH_DIRECT_TAF);
453                 } catch (ClassNotFoundException e1) {
454                     oadtClss = null;
455                     access.log(Level.DEBUG, e1);
456                 }
457                 if (additionalTafLurs!=null && additionalTafLurs.length>0 && (oadtClss!=null && additionalTafLurs[0].getClass().isAssignableFrom(oadtClss))) {
458                     htlist.add(new Priori<HttpTaf>((HttpTaf)additionalTafLurs[0],30));
459                     String[] array= new String[additionalTafLurs.length-1];
460                     if (array.length>0) {
461                         System.arraycopy(htlist, 1, array, 0, array.length);
462                     }
463                     additionalTafLurs = array;
464                     access.log(Level.INIT,"OAuth2 Direct is enabled");
465                 } else if (oauthTokenUrl!=null) {
466                     String oauthIntrospectUrl = logProp(rph,Config.AAF_OAUTH2_INTROSPECT_URL,null);
467                     @SuppressWarnings("unchecked")
468                     Class<HttpTaf> oaTCls = (Class<HttpTaf>)loadClass(access,OAUTH_HTTP_TAF);
469                     if (oaTCls!=null) {
470                         Class<?> oaTTmgrCls = loadClass(access, OAUTH_TOKEN_MGR);
471                         if (oaTTmgrCls!=null) {
472                             try {
473                                 Method oaTTmgrGI = oaTTmgrCls.getMethod("getInstance",PropAccess.class,String.class,String.class);
474                                 Object oaTTmgr = oaTTmgrGI.invoke(null /*this is static method*/,access,oauthTokenUrl,oauthIntrospectUrl);
475                                 Constructor<HttpTaf> oaTConst = oaTCls.getConstructor(Access.class,oaTTmgrCls);
476                                 htlist.add(new Priori<HttpTaf>(oaTConst.newInstance(access,oaTTmgr),30));
477                                 access.log(Level.INIT,"OAuth2 TAF is enabled");
478                             } catch (NoSuchMethodException | SecurityException | IllegalAccessException | IllegalArgumentException | InvocationTargetException | InstantiationException e) {
479                                 access.log(Level.INIT,"OAuth2HttpTaf cannot be instantiated. OAuth2 is disabled",e);
480                             }
481                         }
482                     }
483                 } else {
484                     access.log(Level.INIT,"OAuth TAF is not configured");
485                 }
486             }
487     
488             /////////////////////////////////////////////////////
489             // Adding BasicAuth (AAF) last, after other primary Cookie Based
490             // Needs to be before Cert... see below
491             /////////////////////////////////////////////////////
492             if (aaftaf!=null) {
493                 htlist.add(new Priori<HttpTaf>(aaftaf,40));
494             }
495         }    
496
497         /////////////////////////////////////////////////////
498         // Any Additional Tafs passed in Constructor
499         /////////////////////////////////////////////////////
500         if (additionalTafLurs!=null) {
501                 int i=0;
502             for (Object additional : additionalTafLurs) {
503                 if (additional instanceof BasicHttpTaf) {
504                     BasicHttpTaf ht = (BasicHttpTaf)additional;
505                     for (Object cv : additionalTafLurs) {
506                         if (cv instanceof CredValDomain) {
507                             ht.add((CredValDomain)cv);
508                             access.printf(Level.INIT,"%s Authentication is enabled",cv);
509                         }
510                     }
511                     htlist.add(new Priori<HttpTaf>(ht,50+i++));
512                 } else if (additional instanceof HttpTaf) {
513                     HttpTaf ht = (HttpTaf)additional;
514                     htlist.add(new Priori<HttpTaf>(ht,50+i++));
515                     access.printf(Level.INIT,"%s Authentication is enabled",additional.getClass().getSimpleName());
516                 } else if (hasOAuthDirectTAF) {
517                     Class<?> daupCls;
518                     try {
519                         daupCls = Class.forName("org.onap.aaf.auth.direct.DirectAAFUserPass");
520                     } catch (ClassNotFoundException e) {
521                         daupCls = null;
522                         access.log(Level.INIT, e);
523                     }
524                     if (daupCls != null && additional.getClass().isAssignableFrom(daupCls)) {
525                         htlist.add(new Priori<HttpTaf>(new BasicHttpTaf(access, (CredVal)additional , basicRealm, userExp, basicWarn),50+i++));
526                         access.printf(Level.INIT,"Direct BasicAuth Authentication is enabled",additional.getClass().getSimpleName());
527                     }
528                 }
529             }
530         }
531         
532         // Add BasicAuth, if any, to x509Taf
533         if (x509TAF!=null) {
534             for ( Priori<HttpTaf> ht : htlist) {
535                 if (ht.t instanceof BasicHttpTaf) {
536                     x509TAF.add((BasicHttpTaf)ht.t);
537                 }
538             }
539         }
540         
541         /////////////////////////////////////////////////////
542         // Additional TAFs by Plugin
543         /////////////////////////////////////////////////////
544         Priori.add(access, CADI_ADD_TAFS, htlist);
545         
546         /////////////////////////////////////////////////////
547         // Create EpiTaf from configured TAFs
548         /////////////////////////////////////////////////////
549         if (htlist.size()==1) {
550             // just return the one
551             taf = htlist.get(0).t;
552         } else {
553                 Collections.sort(htlist);
554             HttpTaf[] htarray = new HttpTaf[htlist.size()];
555             int i=-1;
556             StringBuilder sb = new StringBuilder("Tafs processed in this order:\n");
557             for(Priori<HttpTaf> pht : htlist) {
558                 htarray[++i] = pht.t;
559                 sb.append("    ");
560                 sb.append(pht.t.getClass().getName());
561                 sb.append('(');
562                 sb.append(pht.priority);
563                 sb.append(")\n");
564             }
565             access.log(Level.INIT, sb);
566
567             Locator<URI> locator = loadLocator(si, logProp(rph, Config.getAAFLocateUrl(access), null));
568             
569             taf = new HttpEpiTaf(access,locator, tc, htarray); // ok to pass locator == null
570             String level = logProp(access, CADI_LOGLEVEL, null);
571             if (level!=null) {
572                 access.setLogLevel(Level.valueOf(level));
573             }
574         }
575         
576         return taf;
577     }
578     
579     public static String logProp(RegistrationPropHolder rph, String tag, String def) {
580         String rv = rph.access().getProperty(tag, def);
581         if (rv == null) {
582                 rph.access().log(Level.INIT,tag,"is not explicitly set");
583         } else {
584                 rv = rph.replacements("Config.logProp",rv, null, null);
585                 rph.access().log(Level.INIT,tag,"is set to",rv);
586         }
587         return rv;
588         
589     }
590     
591     public static String logProp(Access access,String tag, String def) {
592         String rv = access.getProperty(tag, def);
593         if (rv == null) {
594             access.log(Level.INIT,tag,"is not explicitly set");
595         } else {
596             access.log(Level.INIT,tag,"is set to",rv);
597         }
598         return rv;
599     }
600     
601     public static Lur configLur(SecurityInfoC<HttpURLConnection> si, Connector con, Object ... additionalTafLurs) throws CadiException {
602         Access access = si.access;
603         RegistrationPropHolder rph;
604         try {
605                         rph = new RegistrationPropHolder(access, 0);
606                 } catch (UnknownHostException e2) {
607                         throw new CadiException(e2);
608                 }
609
610         List<Priori<Lur>> lurs = new ArrayList<>();
611         
612         /////////////////////////////////////////////////////
613         // Configure a Local Property Based RBAC/LUR
614         /////////////////////////////////////////////////////
615         try {
616             String users = access.getProperty(USERS,null);
617             String groups = access.getProperty(GROUPS,null);
618
619             if (groups!=null || users!=null) {
620                 LocalLur ll = new LocalLur(access, users, groups);  // note b64==null is ok.. just means no encryption.
621                 lurs.add(new Priori<Lur>(ll,10));
622                 
623                 String writeto = access.getProperty(WRITE_TO,null);
624                 if (writeto!=null) {
625                     String msg = UsersDump.updateUsers(writeto, ll);
626                     if (msg!=null) {
627                         access.log(Level.INIT,"ERROR! Error Updating ",writeto,"with roles and users:",msg);
628                     }
629                 }
630             }
631         } catch (IOException e) {
632             throw new CadiException(e);
633         }
634
635         /////////////////////////////////////////////////////
636         // Configure the OAuth Lur (if any)
637         /////////////////////////////////////////////////////
638         String tokenUrl = logProp(rph,AAF_OAUTH2_TOKEN_URL, null);
639         String introspectUrl = logProp(rph,AAF_OAUTH2_INTROSPECT_URL, null);
640         if (tokenUrl!=null && introspectUrl !=null) {
641             try {
642                 Class<?> olurCls = loadClass(access, CADI_OLUR_CLASS_DEF);
643                 if (olurCls!=null) {
644                     Constructor<?> olurCnst = olurCls.getConstructor(PropAccess.class,String.class,String.class);
645                     Lur olur = (Lur)olurCnst.newInstance(access,tokenUrl,introspectUrl);
646                     lurs.add(new Priori<Lur>(olur,20));
647                     access.log(Level.INIT, "OAuth2 LUR enabled");
648                 } else {
649                     access.log(Level.INIT,"AAF/OAuth LUR plugin is not available.");
650                 }
651             } catch (NoSuchMethodException| SecurityException | InstantiationException | IllegalAccessException | IllegalArgumentException | InvocationTargetException e) {
652                 String msg = e.getMessage();
653                 if (msg==null && e.getCause()!=null) {
654                     msg = e.getCause().getMessage();
655                 }
656                 access.log(Level.INIT,"AAF/OAuth LUR is not instantiated.",msg,e);
657             } 
658         } else {
659             access.log(Level.INIT, "OAuth2 Lur disabled");
660         }
661
662         if (con!=null) { // try to reutilize connector
663             lurs.add(new Priori<Lur>(con.newLur(),30));
664         } else { 
665             /////////////////////////////////////////////////////
666             // Configure the AAF Lur (if any)
667             /////////////////////////////////////////////////////
668             String aafURL = logProp(rph,AAF_URL,null); // Trigger Property
669             String aafEnv = access.getProperty(AAF_ENV,null);
670             if (aafEnv == null && aafURL!=null && access instanceof PropAccess) { // set AAF_ENV from AAF_URL
671                 int ec = aafURL.indexOf("envContext=");
672                 if (ec>0) {
673                     ec += 11; // length of envContext=
674                     int slash = aafURL.indexOf('/', ec);
675                     if (slash>0) {
676                         aafEnv = aafURL.substring(ec, slash);
677                         ((PropAccess)access).setProperty(AAF_ENV, aafEnv);
678                         access.printf(Level.INIT, "Setting aafEnv to %s from aaf_url value",aafEnv);
679                     }
680                 }
681             }
682
683             // Don't configure AAF if it is using DirectAccess
684             if (!hasDirect("DirectAAFLur",additionalTafLurs)) {
685                 if (aafURL==null) {
686                     access.log(Level.INIT,"No AAF LUR properties, AAF will not be loaded");
687                 } else {// There's an AAF_URL... try to configure an AAF
688                     String aafLurClassStr = logProp(access,AAF_LUR_CLASS,AAF_V2_0_AAF_LUR_PERM);
689                     ////////////AAF Lur 2.0 /////////////
690                     if (aafLurClassStr!=null && aafLurClassStr.startsWith(AAF_V2_0)) { 
691                         try {
692                             Object aafcon = loadAAFConnector(si, aafURL);
693                             if (aafcon==null) {
694                                 access.log(Level.INIT,"AAF LUR class,",aafLurClassStr,"cannot be constructed without valid AAFCon object.");
695                             } else {
696                                 Class<?> aafAbsAAFCon = loadClass(access, AAF_V2_0_AAFCON);
697                                 if (aafAbsAAFCon!=null) {
698                                     Method mNewLur = aafAbsAAFCon.getMethod("newLur");
699                                     Object aaflur = mNewLur.invoke(aafcon);
700                 
701                                     if (aaflur==null) {
702                                         access.log(Level.INIT,"ERROR! AAF LUR Failed construction.  NOT Configured");
703                                     } else {
704                                         access.log(Level.INIT,"AAF LUR Configured to ",aafURL);
705                                         lurs.add(new Priori<Lur>((Lur)aaflur,40));
706                                         String debugIDs = logProp(access,Config.AAF_DEBUG_IDS, null);
707                                         if (debugIDs !=null && aaflur instanceof CachingLur) {
708                                             ((CachingLur<?>)aaflur).setDebug(debugIDs);
709                                         }
710                                     }
711                                 }
712                             }
713                         } catch (Exception e) {
714                             access.log(e,"AAF LUR class,",aafLurClassStr,"could not be constructed with given Constructors.");
715                         }
716                     } 
717                 }
718             }
719         }
720
721         /////////////////////////////////////////////////////
722         // Any Additional passed in Constructor
723         /////////////////////////////////////////////////////
724         if (additionalTafLurs!=null) {
725                 int i=0;
726             for (Object additional : additionalTafLurs) {
727                 if (additional instanceof Lur) {
728                     lurs.add(new Priori<Lur>((Lur)additional,50+i++));
729                     access.log(Level.INIT, additional);
730                 }
731             }
732         }
733
734         /////////////////////////////////////////////////////
735         // Additional LURs by Plugin
736         /////////////////////////////////////////////////////
737         Priori.add(access, CADI_ADD_LURS, lurs);       
738
739         /////////////////////////////////////////////////////
740         // Return a Lur based on how many there are... 
741         /////////////////////////////////////////////////////
742         switch(lurs.size()) {
743             case 0: 
744                 access.log(Level.INIT,"WARNING! No CADI LURs configured");
745                 // Return a NULL Lur that does nothing.
746                 return new NullLur();
747             case 1:
748                 return lurs.get(0).t; // Only one, just return it, save processing
749             default:
750                 // Multiple Lurs, use EpiLUR to handle
751                 Collections.sort(lurs);
752                 Lur[] la = new Lur[lurs.size()];
753                 int i=-1;
754                 StringBuilder sb = new StringBuilder("Lurs processed in this order:\n");
755                 for(Priori<Lur> pht : lurs) {
756                         la[++i] = pht.t;
757                         sb.append("    ");
758                         sb.append(pht.t.getClass().getName());
759                         sb.append('(');
760                         sb.append(pht.priority);
761                         sb.append(")\n");
762                 }
763                 access.log(Level.INIT, sb);
764                 return new EpiLur(la);
765         }
766     }
767     
768     private static boolean hasDirect(String simpleClassName, Object[] additionalTafLurs) {
769         if (additionalTafLurs!=null) {
770             for (Object tf : additionalTafLurs) {
771                 if (tf.getClass().getSimpleName().equals(simpleClassName)) {
772                     return true;
773                 }
774             }
775         }
776         return false;
777     }
778
779     public static Object loadAAFConnector(SecurityInfoC<HttpURLConnection> si, String aafURL) {
780         Access access = si.access;
781         Object aafcon = null;
782         Class<?> aafConClass = null;
783
784         try {
785             if (aafURL!=null) {
786                 String aafConnector = access.getProperty(AAF_CONNECTOR_CLASS, AAF_V2_0_AAF_CON_HTTP);
787                 if (AAF_V2_0_AAF_CON_HTTP.equals(aafConnector)) {
788                     aafConClass = loadClass(access, AAF_V2_0_AAF_CON_HTTP);
789                     if (aafConClass != null) {
790                         for (Constructor<?> c : aafConClass.getConstructors()) {
791                             List<Object> lo = new ArrayList<>();
792                             for (Class<?> pc : c.getParameterTypes()) {
793                                 if (pc.equals(Access.class)) {
794                                     lo.add(access);
795                                 } else if (pc.equals(Locator.class)) {
796                                     lo.add(loadLocator(si, aafURL));
797                                 }
798                             }
799                             if (c.getParameterTypes().length != lo.size()) {
800                                 continue; // back to another Constructor
801                             } else {
802                                 aafcon = c.newInstance(lo.toArray());
803                             }
804                             break;
805                         }
806                     }
807                 }
808                 if (aafcon != null) {
809                     String mechid = logProp(access, Config.AAF_APPID, null);
810                     String pass = access.getProperty(Config.AAF_APPPASS, null);
811                     if (mechid != null && pass != null) {
812                         try {
813                             Method basicAuth = aafConClass.getMethod("basicAuth", String.class, String.class);
814                             basicAuth.invoke(aafcon, mechid, pass);
815                         } catch (NoSuchMethodException nsme) {
816                             access.log(Level.NONE, nsme);
817                             // it's ok, don't use
818                         }
819                     }
820                 }
821             }
822         } catch (Exception e) {
823             access.log(e, "AAF Connector could not be constructed with given Constructors.");
824         }
825
826         return aafcon;
827     }
828
829     public static Class<?> loadClass(Access access, String className) {
830         Class<?> cls=null;
831         try {
832             cls = access.classLoader().loadClass(className);
833         } catch (ClassNotFoundException cnfe) {
834             access.log(Level.NONE, cnfe);
835             try {
836                 cls = access.getClass().getClassLoader().loadClass(className);
837             } catch (ClassNotFoundException cnfe2) {
838                 access.log(Level.NONE, cnfe2);
839                 // just return null
840             }
841         }
842         return cls;
843     }
844
845     @SuppressWarnings("unchecked")
846     public static Locator<URI> loadLocator(SecurityInfoC<HttpURLConnection> si, final String _url) throws LocatorException {
847         Access access = si.access;
848         Locator<URI> locator = null;
849         if (_url==null) {
850             access.log(Level.INIT,"No URL passed to 'loadLocator'. Disabled");
851         } else {
852 //            String url = _url.replace("/AAF_NS.", "/%C%CID%AAF_NS.");
853 //            String root_ns = access.getProperty(Config.AAF_ROOT_NS, null);
854                 String url;
855             RegistrationPropHolder rph;
856             try {
857                          rph = new RegistrationPropHolder(access, 0);
858                          url = rph.replacements("Config.loadLocator",_url, null, null);
859                          access.printf(Level.INFO, "loadLocator URL is %s",url);
860                 } catch (UnknownHostException | CadiException e1) {
861                         throw new LocatorException(e1);
862                 }
863
864             String aaf_locator_class;
865             if(_url.equals(url) && !url.contains("/locate/")) {
866                 aaf_locator_class = "org.onap.aaf.cadi.locator.DNSLocator";
867             } else {
868                 aaf_locator_class = AAF_LOCATOR_CLASS_DEF;
869             }
870             try {
871                 Class<?> lcls = loadClass(access,aaf_locator_class);
872                 if (lcls==null) {
873                     throw new CadiException("Need to include aaf-cadi-aaf jar for AAFLocator");
874                 }
875                 // First check for preloaded
876                 try {
877                     Method meth = lcls.getMethod("create",Access.class,String.class);
878                     locator = (Locator<URI>)meth.invoke(null,access,url);
879                 } catch (Exception e) {
880                     access.log(Level.TRACE, "(Not fatal) Cannot load by create(String)", e);
881                 }
882                 if (locator==null) {
883                     URI locatorURI = new URI(url);
884                     FixURIinfo fui = new FixURIinfo(locatorURI);
885                     Constructor<?> cnst = lcls.getConstructor(SecurityInfoC.class,URI.class);
886                     locator = (Locator<URI>)cnst.newInstance(new Object[] {si,locatorURI});
887                     int port = fui.getPort();
888                     String portS = port<0?"":(":"+port);
889                     
890                     access.log(Level.INFO, "AAFLocator enabled using " + locatorURI.getScheme() +"://"+fui.getHost() + portS);
891                 } else {
892                     access.log(Level.INFO, "AAFLocator enabled using preloaded " + locator.getClass().getSimpleName());
893                 }
894             } catch (InvocationTargetException e) {
895                 if (e.getTargetException() instanceof LocatorException) {
896                     throw (LocatorException)e.getTargetException();
897                 }
898                 access.log(Level.INIT,e.getTargetException().getMessage(),"AAFLocator for",url,"could not be created.",e);
899             } catch (Exception e) {
900                 access.log(Level.INIT,"AAFLocator for",url,"could not be created.",e);
901             }
902         }
903         return locator;
904     }
905
906     // Set by CSP, or is hostname.
907     public static String getDefaultRealm() {
908         return defaultRealm;
909     }
910     
911     public static String getAAFLocateUrl(Access access) {
912         String rv = null;
913         String cont = access.getProperty(AAF_LOCATOR_CONTAINER,null);
914         if(cont!=null) {
915                 rv = access.getProperty(AAF_LOCATE_URL + '.' +cont, null);
916         }
917         if(rv==null) {
918                 rv = access.getProperty(AAF_LOCATE_URL, null);
919         }
920         return rv;
921     }
922
923     private static class Priori<T> implements Comparable<Priori<T>> {
924         public final T t;
925         public final int priority;
926         
927         public Priori(final T t, final int priority) {
928                 this.t = t;
929                 this.priority = priority;
930         }
931
932                 @Override
933                 public int compareTo(Priori<T> o) {
934                         if(priority==o.priority) {
935                                 return 0;
936                         } else if(priority<o.priority) {
937                                 return -1;
938                         } else {
939                                 return 1;
940                         }
941                 }
942             public static<T> void add(Access access, final String tag, List<Priori<T>> list) {
943                     String plugins = access.getProperty(tag, null);
944                     if(plugins!=null) {
945                         for(String tafs : Split.splitTrim(';', plugins)) {
946                                 String[] pluginArray = Split.splitTrim(',', tafs);
947                                 String clssn = null;
948                                 int priority = 60;
949                                 switch(pluginArray.length) {
950                                         case 0:
951                                                 break;
952                                         case 1:
953                                                 clssn = tafs;
954                                                 break;
955                                         default:
956                                                 clssn = pluginArray[0];
957                                                 try {
958                                                         priority = Integer.parseInt(pluginArray[1]);
959                                                 } catch (NumberFormatException nfe) {
960                                                         access.printf(Level.ERROR, "%s format is <classname>,priority[;...]\n",CADI_ADD_TAFS);
961                                                 }
962                                 }
963                                 
964                                 if(clssn!=null) {
965                                         Class<?> cls = loadClass(access, clssn);
966                                         if(cls!=null) {
967                                                 try {
968                                                                 @SuppressWarnings("unchecked")
969                                                                 Constructor<T> cnst = (Constructor<T>)cls.getConstructor(Access.class);
970                                                 try {
971                                                                         list.add(new Priori<T>(cnst.newInstance(access),priority));
972                                                                 } catch (InstantiationException | IllegalAccessException | IllegalArgumentException | InvocationTargetException e) {
973                                                                         access.printf(Level.ERROR, "%s cannot be constructed with Access.\n",clssn);
974                                                                 }
975                                                         } catch (NoSuchMethodException | SecurityException e) {
976                                                                 access.printf(Level.ERROR, "%s needs a Constructor taking Access as sole param.\n",clssn);
977                                                         }
978                                         }
979                                 }
980                         }
981                     }
982                 }
983    }
984 }
985