{"id":11655,"date":"2016-10-13T10:17:45","date_gmt":"2016-10-13T15:17:45","guid":{"rendered":"http:\/\/jianmingli.com\/wp\/?p=11655"},"modified":"2016-10-25T09:26:47","modified_gmt":"2016-10-25T14:26:47","slug":"openam12-install-distributed-authentication-app","status":"publish","type":"post","link":"https:\/\/jianmingli.com\/wp\/?p=11655","title":{"rendered":"OpenAM12: Install Distributed Authentication App"},"content":{"rendered":"<div class='toc wptoc'>\n<h2>Contents<\/h2>\n<ol class='toc-odd level-1'>\n\t<li>\n\t\t<a href=\"#Overview\">Overview<\/a>\n\t<\/li>\n\t<li>\n\t\t<a href=\"#Install_Distributed_Authentication_Server\">Install Distributed Authentication Server<\/a>\n\t<\/li>\n\t<li>\n\t\t<a href=\"#Prepare_OpenAM_for_Distributed_Authentication\">Prepare OpenAM for Distributed Authentication<\/a>\n\t\t<ol class='toc-even level-2'>\n\t\t\t<li>\n\t\t\t\t<a href=\"#Prepare_Cookie_Domains\">Prepare Cookie Domains<\/a>\n\t\t\t<\/li>\n\t\t\t<li>\n\t\t\t\t<a href=\"#Prepare_RealmDNS_Aliases\">Prepare Realm\/DNS Aliases<\/a>\n\t\t\t<\/li>\n\t\t<\/ol>\n\t<li>\n\t\t<a href=\"#Configure_Distributed_Authentication_Application\">Configure Distributed Authentication Application<\/a>\n\t<\/li>\n\t<li>\n\t\t<a href=\"#Test\">Test<\/a>\n\t<\/li>\n\t<li>\n\t\t<a href=\"#References\">References<\/a>\n\t<\/li>\n<\/ol>\n<\/ol>\n<\/div>\n<div class='wptoc-end'>&nbsp;<\/div>\n<span id=\"Overview\"><h2>Overview<\/h2><\/span>\n<p>* Distributed authentication app is used,e.g. in DMZ, to proxy to OpenAM server<\/p>\n<span id=\"Install_Distributed_Authentication_Server\"><h2>Install Distributed Authentication Server<\/h2><\/span>\n<p>* Create DNS name by adding to hosts file<\/p>\n<pre lang=\"bash\">\r\n127.0.0.1\tdmz.my.com\r\n<\/pre>\n<p>* Install Tomcat:<br \/>\n&#8211; Unzip <em>apache-tomcat-7.0.72.zip<\/em> and rename as <em>c:\\prog\\apache-tomcat-7.0.72.dmz<\/em><br \/>\n&#8211; Change listening ports from 8xxx to 11xxx, e.g. 8080 to 11080 in <em>conf\\server.xml<\/em> file<br \/>\n8005 > 11005<br \/>\n8080 > 11080<br \/>\n8443 > 11443<br \/>\n8009 > 11009<br \/>\n&#8211; Add <em>setenv.bat<\/em> to <em>bin <\/em>directory to contain:<\/p>\n<pre lang=\"bash\">\r\nset JAVA_OPTS=-Dfile.encoding=UTF-8 -Xms128m -Xmx1024m -XX:PermSize=64m -XX:MaxPermSize=256m\r\nset JAVA_HOME=C:\\prog\\jdk1.7.0_45\r\n<\/pre>\n<p>&#8211; Start new Tomcat and point browser to: <a href=\"http:\/\/dmz.my.com:11080\/docs\">http:\/\/dmz.my.com:11080\/docs<\/a><br \/>\n* Deploy distributed authentication application<br \/>\n&#8211; Extract <em>OpenAM-DistAuth-12.0.0.war<\/em> from <em>OpenAM-12.0.0.zip<\/em><br \/>\n&#8211; Move it to <em>C:\\prog\\apache-tomcat-7.0.72.dmz\\webapps<\/em><br \/>\n&#8211; Rename it to <strong>openam-distauth.war<\/strong><\/p>\n<span id=\"Prepare_OpenAM_for_Distributed_Authentication\"><h2>Prepare OpenAM for Distributed Authentication<\/h2><\/span>\n<span id=\"Prepare_Cookie_Domains\"><h3>Prepare Cookie Domains<\/h3><\/span>\n<p>* Login OpenAM<br \/>\n* Go to: <em>Configuration > System > Platform<\/em><br \/>\n* Add domains for the distributed authentication server to cookie domains if it is different from OpenAM. In this case, both are <em>my.com<\/em> so no need to add:<\/p>\n<span id=\"\"><h6><a href=\"https:\/\/jianmingli.com\/wp\/wp-content\/uploads\/2016\/10\/OpenAM12_DistAuth_CookieDomains_1.jpg\" rel=\"attachment wp-att-11659\"><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/jianmingli.com\/wp\/wp-content\/uploads\/2016\/10\/OpenAM12_DistAuth_CookieDomains_1.jpg\" alt=\"openam12_distauth_cookiedomains_1\" width=\"421\" height=\"415\" class=\"aligncenter size-full wp-image-11659\" srcset=\"https:\/\/jianmingli.com\/wp\/wp-content\/uploads\/2016\/10\/OpenAM12_DistAuth_CookieDomains_1.jpg 421w, https:\/\/jianmingli.com\/wp\/wp-content\/uploads\/2016\/10\/OpenAM12_DistAuth_CookieDomains_1-300x296.jpg 300w\" sizes=\"auto, (max-width: 421px) 100vw, 421px\" \/><\/a><\/h6><\/span>\n<span id=\"Prepare_RealmDNS_Aliases\"><h3>Prepare Realm\/DNS Aliases<\/h3><\/span>\n<p>* Login OpenAM<br \/>\n* Go to: <em>Access Control > Top Realm > General<\/em><br \/>\n* Add DNS name, i.e. dmz.my.com, for the distributed authentication server:<\/p>\n<span id=\"_1\"><h6><a href=\"https:\/\/jianmingli.com\/wp\/wp-content\/uploads\/2016\/10\/OpenAM12_DistAuth_DNSAliases_1-1.jpg\" rel=\"attachment wp-att-11664\"><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/jianmingli.com\/wp\/wp-content\/uploads\/2016\/10\/OpenAM12_DistAuth_DNSAliases_1-1.jpg\" alt=\"openam12_distauth_dnsaliases_1\" width=\"420\" height=\"379\" class=\"aligncenter size-full wp-image-11664\" srcset=\"https:\/\/jianmingli.com\/wp\/wp-content\/uploads\/2016\/10\/OpenAM12_DistAuth_DNSAliases_1-1.jpg 420w, https:\/\/jianmingli.com\/wp\/wp-content\/uploads\/2016\/10\/OpenAM12_DistAuth_DNSAliases_1-1-300x271.jpg 300w\" sizes=\"auto, (max-width: 420px) 100vw, 420px\" \/><\/a><\/h6><\/span>\n<span id=\"Configure_Distributed_Authentication_Application\"><h2>Configure Distributed Authentication Application<\/h2><\/span>\n<p>* Start Tomcat and point browser to <a href=\"http:\/\/dmz.my.com:11080\/openam-distauth\/distAuthConfigurator.jsp\">http:\/\/dmz.my.com:11080\/openam-distauth\/distAuthConfigurator.jsp<\/a><br \/>\n* Enter values on the config page:<br \/>\n&#8211; Use <em>UrlAccessAgent <\/em>as application user name. It is setup during initial OpenAM setup.<\/p>\n<span id=\"_2\"><h6><a href=\"https:\/\/jianmingli.com\/wp\/wp-content\/uploads\/2016\/10\/OpenAM12_DistAuth_Config_1.jpg\" rel=\"attachment wp-att-11696\"><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/jianmingli.com\/wp\/wp-content\/uploads\/2016\/10\/OpenAM12_DistAuth_Config_1.jpg\" alt=\"openam12_distauth_config_1\" width=\"432\" height=\"696\" class=\"aligncenter size-full wp-image-11696\" srcset=\"https:\/\/jianmingli.com\/wp\/wp-content\/uploads\/2016\/10\/OpenAM12_DistAuth_Config_1.jpg 432w, https:\/\/jianmingli.com\/wp\/wp-content\/uploads\/2016\/10\/OpenAM12_DistAuth_Config_1-186x300.jpg 186w\" sizes=\"auto, (max-width: 432px) 100vw, 432px\" \/><\/a><\/h6><\/span>\n<span id=\"_3\"><h6><a href=\"https:\/\/jianmingli.com\/wp\/wp-content\/uploads\/2016\/10\/OpenAM12_DistAuth_Config_2.jpg\" rel=\"attachment wp-att-11698\"><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/jianmingli.com\/wp\/wp-content\/uploads\/2016\/10\/OpenAM12_DistAuth_Config_2.jpg\" alt=\"openam12_distauth_config_2\" width=\"887\" height=\"87\" class=\"aligncenter size-full wp-image-11698\" srcset=\"https:\/\/jianmingli.com\/wp\/wp-content\/uploads\/2016\/10\/OpenAM12_DistAuth_Config_2.jpg 887w, https:\/\/jianmingli.com\/wp\/wp-content\/uploads\/2016\/10\/OpenAM12_DistAuth_Config_2-300x29.jpg 300w, https:\/\/jianmingli.com\/wp\/wp-content\/uploads\/2016\/10\/OpenAM12_DistAuth_Config_2-768x75.jpg 768w\" sizes=\"auto, (max-width: 887px) 100vw, 887px\" \/><\/a><\/h6><\/span>\n<p>* Configuration is saved in <em>C:\\Users\\me\\FAMDistAuth\\_prog_apache-tomcat-7.0.72.dmz_webapps_openam-distauth_AMDistAuthConfig.properties<\/em><\/p>\n<span id=\"Test\"><h2>Test<\/h2><\/span>\n<p>* Use URL format: <em>PROTOCOL:\/\/DISTAUTH:PORT\/DEPLOYMENT-URI\/UI\/Login?goto=PROTECTEDCONTENT<\/em><br \/>\n* For example, point browser to:<br \/>\n<a href=\"http:\/\/dmz.my.com:11080\/openam-distauth\/UI\/Login?goto=http:\/\/tomcat6.my.com:10080\/docs\">http:\/\/dmz.my.com:11080\/openam-distauth\/UI\/Login?goto=http:\/\/tomcat6.my.com:10080\/docs<\/a><br \/>\n* Enter OpenAM username and password to login<\/p>\n<span id=\"References\"><h2>References<\/h2><\/span>\n","protected":false},"excerpt":{"rendered":"<p>Overview * Distributed authentication app is used,e.g. in DMZ, to proxy to OpenAM server Install Distributed Authentication Server * Create DNS name by adding to hosts file 127.0.0.1 dmz.my.com * Install Tomcat: &#8211; Unzip apache-tomcat-7.0.72.zip and rename as c:\\prog\\apache-tomcat-7.0.72.dmz &#8211; &hellip; <a href=\"https:\/\/jianmingli.com\/wp\/?p=11655\">Continue reading <span class=\"meta-nav\">&rarr;<\/span><\/a><\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_exactmetrics_skip_tracking":false,"_exactmetrics_sitenote_active":false,"_exactmetrics_sitenote_note":"","_exactmetrics_sitenote_category":0,"jetpack_post_was_ever_published":false,"_jetpack_newsletter_access":"","_jetpack_dont_email_post_to_subs":false,"_jetpack_newsletter_tier_id":0,"_jetpack_memberships_contains_paywalled_content":false,"_jetpack_memberships_contains_paid_content":false,"footnotes":"","jetpack_publicize_message":"","jetpack_publicize_feature_enabled":true,"jetpack_social_post_already_shared":false,"jetpack_social_options":{"image_generator_settings":{"template":"highway","default_image_id":0,"font":"","enabled":false},"version":2}},"categories":[720],"tags":[721],"class_list":["post-11655","post","type-post","status-publish","format-standard","hentry","category-openam","tag-openam"],"jetpack_publicize_connections":[],"jetpack_featured_media_url":"","jetpack_sharing_enabled":true,"jetpack_shortlink":"https:\/\/wp.me\/p8cRUO-31Z","_links":{"self":[{"href":"https:\/\/jianmingli.com\/wp\/index.php?rest_route=\/wp\/v2\/posts\/11655","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/jianmingli.com\/wp\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/jianmingli.com\/wp\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/jianmingli.com\/wp\/index.php?rest_route=\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/jianmingli.com\/wp\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=11655"}],"version-history":[{"count":10,"href":"https:\/\/jianmingli.com\/wp\/index.php?rest_route=\/wp\/v2\/posts\/11655\/revisions"}],"predecessor-version":[{"id":11699,"href":"https:\/\/jianmingli.com\/wp\/index.php?rest_route=\/wp\/v2\/posts\/11655\/revisions\/11699"}],"wp:attachment":[{"href":"https:\/\/jianmingli.com\/wp\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=11655"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/jianmingli.com\/wp\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=11655"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/jianmingli.com\/wp\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=11655"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}