Förutsättningar

1. Lärosätet har en IdP uppsatt som är medlem i SWAMID (Om frågor - kontakta operations snabel-a SWAMID.SE).
2. Attribut skickas till samtliga SP i Swamid enligt wikisidan SWAMID HowTo (Shibboleth 2.x).
3. Verifiera att din IdP har tillgång till personnummer kopplat till användarnamn för aktuella studenter enligt wikisidan norEduPersonNIN och Svenska Personnummer.
4. VHS SP är medlem i SWAMID med (namnen) https://www.studera.nu/shibboleth-sp och https://www.antagning.se/shibboleth-sp (samt test-miljöerna på https://www.studera.testa.antagning.se/aws-sp och https://www.studera.testb.antagning.se/shibboleth-sp).
5. VHS har en dropdown-lista (på studera.nu - inloggning högskola) som under hösten klarar ANTINGEN CWAA eller SAML, dock EJ båda samtidigt.

Rekommenderad arbetsgång

1. Modifiera attribute-resolvern för din IdP så att den inkluderar personnummer enligt nedan beskrivet format (norEduPersonNIN (nepn))
2. Modifiera attribute-release policy för din IdP enligt kod nedan. Syftet är att tillåta ivägskickande av personnummer till VHS SAMT för test sp.swamid.se
3. Verifiera mot sp.swamid.se att ni ser personnummer och användarnamn.
4. Kontakta VHS för att få sin IdP inlagd i VHSs testmiljö - appldrift_saml snabel-a VHS.SE.
5. Verifiera att test fungerar via aktuell inloggningslänk som VHS tillhandahåller.
6. Bestäm tillsammans med VHS om ett datum för skarp driftsättning
7. Genomför den skarpa driftsättningen.

Konfiguration för Shibboleth

Modifiera filen attribute-resolver.xml:

Personnummer överförs från din IdP till VHS anstagningssystem med attributet norEduPersonNIN. Konfigurationen för norEduPersonNIN i attribute-resolver.xml finns på sidan Attributdefinitioner norEdu-familjen. Konfigurationen förutsätter att personnummer finns lagrat i din katalog (LDAP) med attributet norEduPersonNIN enligt skatteverkets rekommendation, för mer info se norEduPersonNIN och Svenska Personnummer.

Modifiera filen attribute-filter.xml:

Från september 2011 kommer VHS byta namn på sin SP. Beroende på detta lägger vi redan nu med båda namnen för att säkerställa en enkel övergång från https://www.studera.nu till https://www.antagning.se. Notera att https://sp.swamid.se/shibboleth, https://www.studera.testa.antagning.se/aws-sp samt https://www.studera.testb.antagning.se/shibboleth-sp ligger med i test-syfte och KAN tas bort efter att tester och verifiering är klara.

<AttributeFilterPolicy id="releaseNorEduPersonNIN">
   <PolicyRequirementRule xsi:type="basic:OR">
      <basic:Rule 

OBS! Instruktionerna nedan är EJ färdiga utan är under utveckling.

VHS kommer att driftsätta tjänsten den 13 september 2010, innan dess går det inte att få generell tillgång till tjänsten. mvh Valter

Mål: Att ersätta ett CWAA med lärosätets IdP (SAML-teknologi)

Rekommenderad arbetsgång:

Sätt upp en IdP för test/konfigurering (om man inte har en, endast Dalarna samt Chalmers har ingen IdP idag)
Säkerställ att denna IdP har tillgång till användarnamn kopplat till personnummer för aktuella studenter.
Kontakta VHS för att få sin IdP inlagd i VHSs wayf/DS.
Konfigurera IdP enligt nedan för att skicka personnummer till VHS SP såsom attributet norEduPersonNIN.
Testa.

Följande filer (OBS, Shibboleth-specifikt) skall editeras:

Modifiera attribute-resolver.xml enligt:

<resolver:AttributeDefinition id="norEduPersonNIN" xsi:type="Simple" xmlns="urn:mace:shibboleth:2.0:resolver:ad" sourceAttributeID="norEduPersonNIN"> <resolver:Dependency ref="myLDAP" />
<resolver:DisplayName xml:lang="en">Swedish civic registration number</resolver:DisplayName>
<resolver:DisplayName xml:lang="sv">Personnummer</resolver:DisplayName>

SWAMIDs rekommendation kring format på personnummer:

Skatteverket publicerar en skrift SKV 704 (upplaga 8 är senaste i skrivande stund) som beskriver hur personnummret är uppbyggt. I avsnittet "Personnummer i ADB-system" står följande:
Personnummer i ADB-system
Inom Skatteverkets ADB-system för folkbokföring
lagras personnumret med tolv siffror, där de två in-
ledande siffrorna anger under vilket århundrade en
person är född. Siffran för århundrade kan vara 18, 19
eller – efter millennieskiftet – 20.
Siffran visas normalt inte på terminalbilder eller
utskrifter men ingår i aviseringen av folkbokförings-
uppgifter till andra myndigheter via Navet, Skatte-
verkets system för distribution av folkbokföringsupp-
gifter till samhället.
SWAMID rekommenderar att man följer denna princip för personnummer som skickas via attributet norEduPersonNIN, dvs att personnummer representeras som 12 siffror utan bindestreck eller mellanslag.

Modifiera attribute-filter.xml enligt:

Alt 1: (hämta maskiner från en xml-fil) (OBS, certifikaten skall matchas)
<AttributeFilterPolicy>
<PolicyRequirementRule xsi:type="saml:AttributeRequesterInEntityGroup" groupID="http(s?)://wayf.swamid.se/md/nya-1.0-testing.xml" />
<AttributeRule attributeID="norEduPersonNIN">
<PermitValueRule xsi:type="basic:ANY" />
</AttributeRule>
</AttributeFilterPolicy>

...

xsi:type="basic:AttributeRequesterString"  value="https://

...

www.studera.nu/shibboleth-sp"

...

 />
      <basic:Rule xsi:type="basic:

...

Modifiera relying-party.xml (behövs EJ i framtiden om VHS SP ingår i SWAMID):

...

AttributeRequesterString"  value="https://www.antagning.se/shibboleth-sp" />
      <basic:Rule xsi:type="

...

basic:AttributeRequesterString"  value="https://www.studera.testa.antagning.se/aws-sp" />
      <basic:Rule xsi:type="

...

basic:AttributeRequesterString"  value="

...

https://www.studera.testb.antagning.se/shibboleth-sp" />
      <basic:Rule xsi:type="

...

basic:AttributeRequesterString"  value="

...

https://sp.swamid.se/shibboleth" />
   </PolicyRequirementRule>
    <AttributeRule  attributeID="norEduPersonNIN">
      <PermitValueRule xsi:type="basic:ANY" />
   </AttributeRule>
</AttributeFilterPolicy>