====== eduPersonUniqueId ======

Die ''eduPersonUniqueId'' ist ein eindeutiger, pseudonymer Identifier (siehe die [[http://macedir.org/specs/internet2-mace-dir-eduperson-201310.html#eduPersonUniqueId|Spezifikation]]).

Ein Einsatzszenario für die eduPersonUniqueId ist das Mapping zwischen IdPs und Attribute Authorities.

<callout color="#ff9900" title="Attribute Authority?">
Im Kontext von Forschungsprojekten/-Infrastrukturen und Fachinformationsdiensten müssen häufig dienstspezifische Zugangsberechtigungen für Einzelpersonen oder einrichtungsübergreifende Personengruppen vergeben werden. Solche Informationen werden i.d.R. nicht in den IdMs der beteiligten Heimateinrichtungen gepflegt, sondern in eine weiteren Attributquelle: einer Attribute Authority. Attribute Authorities werden meist von den Projekten selbst betrieben. Sie verwalten nur community- bzw. projektspezifische Attribute und werden bei der Autorisierung zusätzlich zum IdP befragt.
</callout>

Die Attribute, die eine Attribut Authority verwaltet, müssen über einen global gültigen, eindeutigen Identifier auf die Accounts der Heimateinrichtungen gemappt werden. Dazu können z.B. ''eduPersonPrincipalName'', ''mail'' oder [[..:start|eduPersonUniqueId]] verwendet werden.

Die ''eduPersonUniqueId'' hat den Vorteil, dass sie pseudonym ist: Von SP-Seite aus kann nicht auf die dahinter liegende Identität rückgeschlossen werden.

===== Upgegradeter IdP 4.x (ohne Attribute Registry) =====
<file xml /opt/shibboleth-idp/conf/attribute-resolver.xml>
<AttributeDefinition xsi:type="ScriptedAttribute" id="eduPersonUniqueId">
    <InputAttributeDefinition ref="uid" />
    <DisplayName xml:lang="en">Unique ID</DisplayName>
    <DisplayName xml:lang="de">Eindeutige ID</DisplayName>
    <DisplayDescription xml:lang="en">Unique ID: A unique identifier for a person, mainly for inter-institutional user identification</DisplayDescription>
    <DisplayDescription xml:lang="de">Eindeutige Nutzerkennung</DisplayDescription>
    <AttributeEncoder xsi:type="SAML2String" name="urn:oid:1.3.6.1.4.1.5923.1.1.1.13" friendlyName="eduPersonUniqueId" />
    <Script><![CDATA[
        DigestUtils = Java.type("org.apache.commons.codec.digest.DigestUtils");
        // unique value erzeugen
        uniqueValue = uid.getValues().get(0) + "SALT_MIN_48_CHARS";
        // md5 value erzeugen
        localpart = DigestUtils.md5Hex(uniqueValue);
        // Scope anhängen
        eduPersonUniqueId.getValues().add(localpart + "@%{idp.scope}");     
        ]]>
    </Script>
</AttributeDefinition>
</file>

===== Neu installierter IdP 4.x (mit Attribute Registry) =====

<callout color="#ff9900" title="Best Practice">
Wir empfehlen, der [[de:shibidp:config-attributes-aaiplus#idp_4x | hier dokumentierten Best Practice]] zu folgen und zunächst einen subjectHash zu generieren, der dann sowohl für eduPersonUniqueId, als auch für die SAML Subject ID verwendet wird.
</callout>

Alternativ können Sie auch einen ähnlichen Weg wie oben gehen. Damit das Attribut hier von der Attribute Registry verarbeitet werden kann, können Sie so ein neues scoped Attribut erzeugen, das dann von der Registry mit den richtigen Transcoder verarbeitet wird.

<file xml /opt/shibboleth-idp/conf/attribute-resolver.xml>
<AttributeDefinition id="eduPersonUniqueId" xsi:type="ScriptedAttribute">
    <InputAttributeDefinition ref="uid" />
    <Script><![CDATA[
             var ScopedValue = Java.type("net.shibboleth.idp.attribute.ScopedStringAttributeValue");
             var DigestUtils = Java.type("org.apache.commons.codec.digest.DigestUtils");
             // unique value erzeugen (do not change salt)
             var uniqueValue = uid.getValues().get(0) + "SALT_MIN_48_CHARS";
             // md5 value erzeugen
             var idSaltHash = DigestUtils.md5Hex(uniqueValue);
             // Scope dazu
             eduPersonUniqueId.getValues().add(new ScopedValue(idSaltHash, "%{idp.scope}"));
             ]]>
    </Script>
</AttributeDefinition>
</file>

{{tag>idp4}}