| 1 | Update UA IdP to release attributes to Kuali Ready v. 2.0 2012-08-06 |
| 2 | |
| 3 | 1. Determine that the staging IdP on howkan is a working clone of the production IdP |
| 4 | |
| 5 | 2. Create attribute resolver for UA ID# scoped (30123456@alaska.edu) in /opt/shibboleth-idp/conf/attribute-resolver.xml |
| 6 | |
| 7 | <resolver:AttributeDefinition id="uakPersonID" xsi:type="Script" xmlns="urn:mace:shibboleth:2.0:resolver:ad"> |
| 8 | |
| 9 | <!-- uakPersonID is locally (U Alaska) defined. --> |
| 10 | <!-- Looks like ePPN except uses the unchanging ID # assigned in Banner ERP to students and employees --> |
| 11 | <!-- rather than modifiable netID or UA Username. format: 30012345@alaska.edu --> |
| 12 | |
| 13 | <resolver:Dependency ref="myLDAP" /> |
| 14 | |
| 15 | <!-- ID# is bannerid in EDIR LDAP or uaADIdentifier in UA AD (a few users are unique to each source) --> |
| 16 | |
| 17 | <resolver:Dependency ref="bannerid" /> |
| 18 | <resolver:Dependency ref="uaADIdentifier" /> |
| 19 | |
| 20 | <resolver:AttributeEncoder xsi:type="SAML1ScopedString" xmlns="urn:mace:shibboleth:2.0:attribute:encoder" |
| 21 | name="https://iam.alaska.edu/trac/wiki/IamUaArp#uakPersonID" /> |
| 22 | |
| 23 | <resolver:AttributeEncoder xsi:type="SAML2ScopedString" xmlns="urn:mace:shibboleth:2.0:attribute:encoder" |
| 24 | name="https://iam.alaska.edu/trac/wiki/IamUaArp#uakPersonID" friendlyName="uakPersonID" /> |
| 25 | |
| 26 | <Script> |
| 27 | |
| 28 | <![CDATA[ |
| 29 | |
| 30 | importPackage(Packages.edu.internet2.middleware.shibboleth.common.attribute.provider); |
| 31 | importPackage(Packages.org.slf4j); |
| 32 | |
| 33 | logger = LoggerFactory.getLogger("edu.internet2.middleware.shibboleth.resolver.Script.scriptTest"); |
| 34 | logger.debug("Starting uakPersonID Attribute Resolver Script:"); |
| 35 | |
| 36 | if (uakPersonID == null) |
| 37 | { |
| 38 | uakPersonID = new BasicAttribute("uakPersonID"); |
| 39 | } |
| 40 | |
| 41 | if (typeof bannerid != "undefined" && bannerid != null && bannerid.getValues().size() != 0) |
| 42 | { |
| 43 | logger.debug("EDIR LDAP Values: " + uasystemid.getValues()); |
| 44 | |
| 45 | for ( i = 0; i < bannerid.getValues().size(); i++ ) |
| 46 | { |
| 47 | value = bannerid.getValues().get(i); |
| 48 | uakPersonID.getValues().add(new ScopedAttributeValue(value, "alaska.edu")); |
| 49 | } |
| 50 | } |
| 51 | |
| 52 | else |
| 53 | { |
| 54 | if (typeof uaADIdentifier != "undefined" && uaADIdentifier != null && uaADIdentifier.getValues().size() != 0) |
| 55 | { |
| 56 | logger.debug("AD LDAP Values: " + uaADIdentifier.getValues()); |
| 57 | |
| 58 | for ( i = 0; i < uaADIdentifier.getValues().size(); i++ ) |
| 59 | { |
| 60 | value = uaADIdentifier.getValues().get(i); |
| 61 | uakPersonID.getValues().add(new ScopedAttributeValue(value, "alaska.edu")); |
| 62 | } |
| 63 | } |
| 64 | } |
| 65 | |
| 66 | logger.debug("uakPersonID values:" + uakPersonID.getValues()); |
| 67 | logger.debug("Completed uakPersonID Attribute Resolver Script"); |
| 68 | |
| 69 | ]]> |
| 70 | |
| 71 | </Script> |
| 72 | |
| 73 | </resolver:AttributeDefinition> |
| 74 | |
| 75 | |
| 76 | 3. Modify attribute filter (/opt/shibboleth-idp/conf/attribute-filter.xml in standard install) to add the the following release policy |
| 77 | releasing uakPersonID to Kuali Ready staging service. |
| 78 | <!-- ... --> |
| 79 | |
| 80 | <AttributeFilterPolicy id="releaseToKualiReady"> |
| 81 | <PolicyRequirementRule type="basic:OR"> |
| 82 | <Rule type="basic:AttributeRequesterString" value="https://us.ready-staging.kuali.org/shibboleth-sp"/> |
| 83 | </PolicyRequirementRule> |
| 84 | <AttributeRule attributeID="uakPersonID"> |
| 85 | <!-- UA ID #@alaska.edu, like ePPN, but with unchanging UAID# rather than name-based UA Username> --> |
| 86 | <PermitValueRule xsi:type="basic:ANY" /> |
| 87 | </AttributeRule> |
| 88 | <AttributeRule attributeID="displayName"> |
| 89 | <PermitValueRule xsi:type="basic:ANY" /> |
| 90 | </AttributeRule> |
| 91 | <AttributeRule attributeID="givenName"> |
| 92 | <PermitValueRule xsi:type="basic:ANY" /> |
| 93 | </AttributeRule> |
| 94 | <AttributeRule attributeID="surname"> |
| 95 | <PermitValueRule xsi:type="basic:ANY" /> |
| 96 | </AttributeRule> |
| 97 | <AttributeRule attributeID="email"> |
| 98 | <PermitValueRule xsi:type="basic:ANY" /> |
| 99 | </AttributeRule> |
| 100 | <AttributeRule attributeID="telephoneNumber"> |
| 101 | <PermitValueRule xsi:type="basic:ANY" /> |
| 102 | </AttributeRule> |
| 103 | </AttributeFilterPolicy> |
| 104 | |
| 105 | <!-- ... --> |
| 106 | |
| 107 | 3.1 Modify local hosts file to point to howkan; test the staging idp by pointing browser to: |
| 108 | https://us.ready-staging.kuali.org/uaa |
| 109 | https://us.ready-staging.kuali.org/uaf |
| 110 | https://us.ready-staging.kuali.org//uas |
| 111 | |
| 112 | 3.2 Coordinate with Kai Hsieh <kchsieh@berkeley.edu> to verify or correct as needed. |
| 113 | |
| 114 | 3.3 Comment out the modification to the local hosts file. |
| 115 | |
| 116 | 4. Upon successful staging, create service "modification/outage" notice; at scheduled time, |
| 117 | |
| 118 | [Need to verify hanin is near enough a clone of heald that it works as production IdP!] |
| 119 | |
| 120 | 4.1 modify attribute-filter.xml on the hot standby server (hanin) with production version of release policy: |
| 121 | <!-- ... --> |
| 122 | |
| 123 | <AttributeFilterPolicy id="releaseToKualiReady"> |
| 124 | <PolicyRequirementRule type="basic:OR"> |
| 125 | <Rule type="basic:AttributeRequesterString" value="https://us.ready.kuali.org/shibboleth-sp"/> |
| 126 | </PolicyRequirementRule> |
| 127 | <AttributeRule attributeID="uakPersonID"> |
| 128 | <!-- UA ID #@alaska.edu, like ePPN, but with unchanging UAID# rather than name-based UA Username> --> |
| 129 | <PermitValueRule xsi:type="basic:ANY" /> |
| 130 | </AttributeRule> |
| 131 | <AttributeRule attributeID="displayName"> |
| 132 | <PermitValueRule xsi:type="basic:ANY" /> |
| 133 | </AttributeRule> |
| 134 | <AttributeRule attributeID="givenName"> |
| 135 | <PermitValueRule xsi:type="basic:ANY" /> |
| 136 | </AttributeRule> |
| 137 | <AttributeRule attributeID="surname"> |
| 138 | <PermitValueRule xsi:type="basic:ANY" /> |
| 139 | </AttributeRule> |
| 140 | <AttributeRule attributeID="email"> |
| 141 | <PermitValueRule xsi:type="basic:ANY" /> |
| 142 | </AttributeRule> |
| 143 | <AttributeRule attributeID="telephoneNumber"> |
| 144 | <PermitValueRule xsi:type="basic:ANY" /> |
| 145 | </AttributeRule> |
| 146 | </AttributeFilterPolicy> |
| 147 | |
| 148 | <!-- ... --> |
| 149 | |
| 150 | 4.2 Restart the IdP |
| 151 | |
| 152 | 3.3 Test by editing /etc/hosts to point idp to hanin, pointing browser to |
| 153 | https://us.ready-staging.kuali.org/uaa |
| 154 | https://us.ready-staging.kuali.org/uaf |
| 155 | https://us.ready-staging.kuali.org//uas |
| 156 | |
| 157 | 5. If successful, switch equalizer to designate hanin as active, then use same change process on heald |
| 158 | |
| 159 | 6. Check the new attribute-resolver and attribute-filter.xml file into the subversion repository on iron. |
| 160 | |
| 161 | |
| 162 | |