HSA-schema tjänsteträdet Version 4.3
Innehåll Revisionshistorik... 3 1 Inledning... 4 1.1 Tabellen... 4 1.2 Regional information... 5 1.3 Övrig information... 5 1.3.1 Information från överliggande objekt... 5 1.3.2 Språk... 5 1.3.3 Rekommendationer kring tecken i objektsnamn... 5 1.3.4 Rekommendationer kring tecken i attributvärden... 6 2 Attribut i HSA Tjänsteträd... 7 2.1 Geografisk information... 7 2.1.1 Geografisk indelning... 7 2.2 Internetuppgifter... 8 2.3 SITHS Certifikatsinformation... 8 2.4 Enhetsinformation... 9 2.5 Objektinformation... 10 2.6 Teknisk information... 13 3 Syntax... 17 4 Förklaring till Format och Multiplicitet... 18 Referenser... 21 anisationsnummer Sid 2/21
Revisionshistorik I revisionshistoriken nedan redogörs för de ändringar som skett i denna version av HSAschemat. För information om tidigare versioners ändringar se aktuell version av detta dokument. Revisionshistoriken redogör även för ändringar av teknisk information som specificeras i motsvarande exceldokument [1]. Revisionshistorik Version Datum Status 4.2 2013-10-22 Fastställd i HSA Förvaltningsgrupp med följande ändringar: Införande av två nya grenar i HSA Tjänsteträd, se motsvarande excelark för information om attribut i dessa grenar: - Certifier (dc=certifier), för hantering av HOSP-kontroll för personer som inte finns i HSA (berör intygstjänster) - HSA Domain (dc=hsa Domain), för hantering av domäner och domänområden för administrativa uppdrag Borttag av attributet fakturaadress I HOSP-grenen (dc=hosp) har attributet beskrivning, description, lyfts fram eftersom det anger tidpunkt då HOSP senast uppdaterades med uppgifter ifrån Socialstyrelsen. 4.3 Fastställd i HSA Förvaltningsgrupp med följande ändringar: Förtydligande av syntax för attributet HSA-id Förtydligande av innehållsbekrivning för attributet slutdatum anisationsnummer Sid 3/21
1 Inledning Detta dokument är en fristående bilaga till RIV Informationsspecifikation HSA Struktur och innehåll [2] och beskriver objekt och attribut i HSA Tjänsteträd. Alla objekt och attribut som presenteras i HSA Tjänsteträd måste följa de anvisningar som beskrivs i detta dokument. 1.1 Tabellen Kolumnerna i tabellerna på nästföljande sidor har följande innebörd: Attribut Beskrivning Format Mult Kodverk/ Beslutsregel/ Teknisk beskrivning Det svenska namnet på attributen följt av attributets LDAP-namn. I de fall synonymer används för LDAP-namnet står även dessa med. Innehållsmässig beskrivning av attributet. Beskriver hur innehållet ska vara formaterat enligt RIV. För ytterligare information om format hänvisas till en beskrivning sist i dokumentet. I några fall anges format även direkt i fältet. Anger multiplicitet för attributet, dvs. antal möjliga förekomster av attributet. Attribut i HSA kan antingen vara envärdes- eller flervärdesattribut. attribut innebär att attributet endast kan ha ett värde för en viss instans av ett objekt. Flervärdesattribut kan däremot ha flera värden. Mer information om RIV-angivelse av detta finns i slutet av detta dokument. Anger namn på kodverket/värdemängden som innehåller tillåtna värden för attributet. Teknisk beskrivning av och eventuella kommentarer till attributen. imal teckenlängd i HSA för attributet. Detta är i de flesta fall ingen katalogteknisk begränsning utan en överenskommelse inom HSA för att underlätta användning av attribut inom andra områden. Ett kryss i denna kolumn anger att attributet används för objektklassen anization. Om Obl är angivet istället för ett kryss innebär detta att attributet är obligatoriskt för objektklassen, dvs. attributet ska ha innehåll. Ett kryss i denna kolumn anger att attributet används för objektklassen anizational. Om Obl är angivet istället för ett kryss innebär detta att attributet är obligatoriskt för objektklassen, dvs. attributet ska ha innehåll. anisationsnummer Sid 4/21
Ett kryss i denna kolumn anger att attributet används för objektklassen anizational (Funktion). Om Obl är angivet istället för ett kryss innebär detta att attributet är obligatoriskt för objektklassen, dvs. attributet ska ha innehåll. DomainComponent,, består av två nivåer. Den första nivån, Services, innehåller ingen annan information än själva namnet. Den andra nivån av DomainComponent kallas Nod X. Ett kryss i kolumnen anger att attributet används för den andra nivån av objektklassen DomainComponent. Om Obl är angivet istället för ett kryss innebär detta att attributet är obligatoriskt för objektklassen, dvs. attributet ska ha innehåll. 1.2 Regional information Det är tillåtet att lagra information i den egna delen av HSA som inte finns specificerad i detta dokument. Detta kan till exempel vara intressant för regiongemensamma ändamål. Vad man då bör vara uppmärksam på är att om man använder generella attribut och objekt ur LDAP/X.500- standarden löper man risken att dessa i ett senare skede blir formellt definierade i HSA och man blir då tvungen att anpassa sig. Dessutom finns vissa standardattribut som används på icke standardmässigt sätt i HSA. Det rekommenderas att man istället använder egna attribut med egna namn, lämpligen inledda med något eget prefix, och egna OID:er. Inom HSA har varje organisation möjlighet att få en egen OID-serie för dessa attribut. Dessa beskrivs i detta dokuments tillhörande excelark [1]. Det kan även vara lämpligt att dölja dessa för andra än dem som kan förstå dem. 1.3 Övrig information 1.3.1 Information från överliggande objekt Generellt försöker man undvika dubbellagring. Därför har i de flesta fall ett personobjekt till exempel ingen adressinformation. I de fall man saknar information av en viss typ på ett objekt bör man alltid söka informationen på närmast överliggande objekt. 1.3.2 Språk Alla attribut ska fyllas med svensk text. Om så önskas kan den svenska texten i tillämpliga fall kompletteras med text på andra språk. 1.3.3 Rekommendationer kring tecken i objektsnamn Den teknik som används i HSA ger vissa begränsningar i vilka tecken som kan användas i namn på objekt. Textsträngar som lagras i HSA kan rent tekniskt innehålla vilka tecken som helst men för att praktisk användning av allehanda tecken ska vara möjlig måste även samtliga klienter som använder HSA vara förberedda för att hantera alla tecken. Alla klienter på marknaden är inte förberedda och inom HSA finns inte total kontroll över vilka klienter som används. Istället finns dessa rekommendationer. Namn på personobjekt begränsas naturligt av vilka tecken som Skatteverket tillåter i folkbokföringen (ISO/IEC 8859-1). Vad gäller namn på enheter och funktioner, som oftast är anisationsnummer Sid 5/21
manuellt registrerade i katalogen/katalogerna, är det istället viktigt att rekommenderade tecken kan kommuniceras till administratörer. Tecken som kan orsaka tekniska problem och som ska undvikas i objektnamn är: Tecken * Stjärna Benämning + Plus \ Bakåt snedstreck, Komma ; Semikolon Citattecken < Mindre än > Större än ( Vänster parentes ) Höger parentes Mellanslag först och/eller sist i texten Null Inget tecken (Unicode 0000) Rekommendationen gäller i första hand attributen enhetsnamn, ou (organizationalname), organisationsnamn, o (organizationalname) och objektnamn, cn (commonname) men också alla andra attribut som kan uppträda som RDN (RelativeDistinguishedName). 1.3.4 Rekommendationer kring tecken i attributvärden Det är tillåtet att använda radbrytningstecken i fritextattribut vid behov. anisationsnummer Sid 6/21
2 Attribut i HSA Tjänsteträd 2.1 Geografisk information 2.1.1 Geografisk indelning Land (c, countryname) Landets tvåställiga bokstavsbeteckning enligt ISO 3166 om annat än Sverige. KTOV Beslutsregel/Teknisk kommentar Anges med 2 bokstäver enligt ISO 3166. 2 X X X Länskod (countycode) Kod för län enligt SCB där enheten fysiskt är placerad. KTOV enligt regel Länskod Om ifylld måste länsnamn vara ifylld. 2 X X X Länsnamn (countyname) Namn på län enligt SCB där enheten är placerad. KTOV enligt regel Länskod Om ifylld måste länskod vara ifylld. 64 X X X Associationer En Geografisk indelning indelar noll till flera Funktioner Beslutsregel En Geografisk indelning indelar noll till flera Enheter anisationsnummer Sid 7/21
2.2 Internetuppgifter Beslutsregel/Teknisk beskrivning e-postadress (mail, rfc822mailbox) Uppgift om e-postadress. KOM (e-post) enligt regel 255 X X X Associationer En Internetuppgift är kontaktuppgift till noll till flera Enheter Beslutsregel En Internetuppgift är kontaktuppgift till noll till flera Funktioner 2.3 SITHS Certifikatsinformation Certifikatsmottagare (hsacertificaterecipient) Certifikatsnummer (serialnumber) Här anges person- och kontaktuppgifter till behörig mottagare av certifikat för den aktuella funktionen om detta är annan person än ansvarig person. Exempel: Anna Andersson, anna.andersson @lio.se, 0706-222 111. SITHS-certifikatets serienummer. TXT II Flervärdes (0..*) Flervärdes (0..*) Beslutsregel/Teknisk beskrivning Informationen registreras av SITHS vid publicering av HCC. 128 X 64 X anisationsnummer Sid 8/21
Giltigt fr om (validnotbefore) Det datum som SITHScertifikatet är giltigt från och med. Datum (TP) Flervärdes (0..*) Beslutsregel/Teknisk beskrivning Informationen registreras av SITHS vid publicering av HCC. X Giltigt tom (validnotafter) HCC (usercertificate) Det datum som SITHScertifikatet är giltigt till och med. Giltiga SITHS-certifikat. Datum (TP) TXT (certifikat ) Flervärdes (0..*) Flervärdes (0..*) Informationen registreras av SITHS vid publicering av HCC. SITHS-certifikat av typen HCC Funktion X X Associationer En Certifikat innehas av noll eller en Funktion Beslutsregel 2.4 Enhetsinformation Enhetsnamn (ou, organizationalname) Kan i detta sammanhang vara enhetens namn eller namnet på en gruppering av tjänster. Exempel: erecept. Rekommendationen är att undvika å, ä, ö och mellanslag. TXT enligt regel (1..1) Beslutsregel/Teknisk beskrivning Rekommendationen är att skriva in hela enhetsnamnet istället för en förkortning. Enbart ett enhetsnamn får anges HSA. 64 Obl X anisationsnummer Sid 9/21
anisationsnamn (o, organizationname) I tjänsteträdet anges organisationsnamn utan å, ä, ö, och mellanslag. Exempel: o= Region_Skane. TXT enligt regel (1..1) Beslutsregel/Teknisk beskrivning 64 Obl X anisationsnummer (orgno) anisationsnummer enligt SCB/Bolagsverket. Exempel: 802006-3023 II (XXXXXX- XXXX) enligt regel Sekelsiffran 16 ska inte vara med. 12 Obl X X Associationer En Enhet består av noll eller flera Enheter Beslutsregel En Enhet hör till noll eller en Geografisk indelning En Enhet består av noll eller flera Funktioner 2.5 Objektinformation Ansvarig person (hsaresponsibleperson) Person- och kontaktuppgifter till den som ansvarar för funktionen eller enheten. TXT Flervärdes (0..*) Beslutsregel/Teknisk beskrivning På organisationsnivå kan t.ex. firmatecknare anges i detta attribut. För funktioner t.ex. systemägare eller motsvarande. Exempel: Systemägare Sven Svensson, sven.svensson@lio.se, 0703-111 222. 128 X X X anisationsnummer Sid 10/21
Beskrivning (description) Kort beskrivning/förklaring av speciellt intresse. TXT enligt regel Beslutsregel/Teknisk beskrivning Ska endast innehålla information som får visas för objektet. På o- nivå ska organisationens vedertagna namn skrivas, t ex Landstinget i Östergötland. För funktioner kan systemtyp anges och vad den används till. 1024 X X X X HSA-id (hsaidentity) Obligatorisk, unik identifierare för personer, enheter, funktioner och organisationer i HSA. II (HSAid) (1..1) Se beskrivning av HSA-id i dokumentet RIV Informationsspecifikation HSA Struktur och innehåll. Syntaxen är uppbyggd på följande sätt: SE<Katalogägarens organisationsnummer med 10 tecken>-<valfria bokstäver (A-Z och a-z) och siffror (0-9)>. Observera att tecknen å, ä, ö samt @-tecken inte är tillåtna. 31 Obl Obl Obl HSA-administratörens kommentar (hsaadmincomment) Administrativ kommenter, t.ex. information om extern konsults löptid för avtal. TXT Attributet är endast synligt för HSA-administratörer inom det egna behörighetsområdet. 1024 X X X anisationsnummer Sid 11/21
Objektnamn (cn, commonname) Funktionens namn. TXT enligt regel (1..1) Beslutsregel/Teknisk beskrivning URI/DNS-namn för tjänsten registreras alltid i attributets objektnamn om SITHS-certifikat ska skapas, ex cn=dsedix.ds.sll.se. 64 Obl Endast domännamn som ägs av organisationen de befinner sig under (o=[organisationen]) får läggas upp i objektnamn. Om andra domännamn läggs in skall skriftlig fullmakt finnas mellan organisationen som äger domännamnet och organisationen där objektnamnet finns. Slutdatum (enddate) Eventuellt slutdatum då en enhet eller funktion upphör sin verksamhet. Om inget slutdatum anges tolkas det som "tillsvidare". DT (Datum) Tidsangivelse I GMT (Greenwich Mean Time). Exempel: 20081112141347Z. X X X Startdatum (startdate) Startdatum då en enhet eller funktion startar sin verksamhet eller då en person börjar sin anställning. DT (Datum) Tidsangivelse I GMT (Greenwich Mean Time). Exempel: 20081112141347Z. X X X anisationsnummer Sid 12/21
Associationer Beslutsregel Beslutsregel/Teknisk beskrivning En Funktion hör till noll eller en geografisk indelning En Funktion är del av en och endast en Enhet En Funktion innehar noll eller flera Certifikat 2.6 Teknisk information Beslutsregel/Teknisk beskrivning antal närmast underliggande objekt (numsubordinates) antal underliggande objekt (numallsubordinates) Antal närmast underliggande objekt. Totalt antal underliggande objekt. KV KV (1..1) (1..1) Attributet används av SITHS statisitk och loggar. Attributet kan inte fyllas i manuellt utan innehållet skapas med automatik. Värdet är alltid 0 på person-, funktions- och uppdragsobjekt. Attributet används av SITHS statisitk och loggar. Attributet ska inte fyllas i manuellt utan innehållet skapas med automatik. Värdet är alltid 0 på person-, funktions- och uppdragsobjekt. X X X X X X X X X X anisationsnummer Sid 13/21
Beslutsregel/Teknisk beskrivning Domainnamn (dc, domaincomponent) Namn för Domain. Exempel: Nod 1. TXT (1..1) Obl HSA användarlösenord (userpassword) Lösenord för användare av HSA. När användare loggar in med HCC sätts ett slumpmässigt lösenord efter det att autentisering och behörighetskontroll har skett. 128 (Octet) X X HSA-id-prefix (hsaidprefix) Anger vilket HSA-idprefix som ska användas när objekt skapas. VÄ (SEXXXXX XXXXX-) 0..1 40 X HSA-id-räknare (hsaidcounter) Räknare som används för att skapa unika HSA-id:n. 0..* 40 X anisationsnummer Sid 14/21
Beslutsregel/Teknisk beskrivning Medlem i administratörsgruppen för HSA admingränssnitt (uniquemember) Pekare till person med administratörsrättighet er i administratörsgruppens delträd, dvs. den enhet som administratörsgruppen är placerad under med underliggande objekt. II Flervärdes (1..*) Attributet lagras i administratörsgrupper och ändras enbart i HSA Admingränssnitt. Exempel: "cn=maria Larsson,ou=Systemavdelningen,o=L andstinget Sörmland,l=Sörmlands län,c=se". Senaste förändringstidpunkt (modifytimestamp) Information om tidpunkt för senaste förändring. TP (Datum) Operativt attribut som skapas med automatik av databasen vid förändring av information på objektet i något attribut. Tidsangivelse i GMT (Greenwich Mean Time). Exempel: "20081112141347Z". X X X X av (modifiersname) DN för objekt (användare) som senast förändrade objektet. Kan vara en administratör eller ett system. II (DN) X X X X anisationsnummer Sid 15/21
Beslutsregel/Teknisk beskrivning Skapad av (creatorsname) DN för objekt (användare) som skapat objektet. Kan vara en administratör eller ett system. II (DN) X X X X Skapandetidpunkt (createtimestamp) Information om tidpunkt för skapandet av objektet. TP (Datum) Operativt attribut som skapas med automatik av databasen. Tidsangivelse i GMT (Greenwich Mean Time). Exempel: "20081112141347Z". X X X X anisationsnummer Sid 16/21
3 Syntax Datum HSAid Enligt RFC4517. Det vill säga minst YYYYMMDDhhZ. Där Z står för tidszonen Zulu, d v s UTC. SE[Katalogägarens organisationsnummer med 10 tecken]-[valfria bokstäver (A-Z och a-z) och siffror (0-9)]. Observera att tecknen å, ä, ö samt @-tecken inte är tillåtna. De katalogägare som redan börjat använda organisationsnummer med sekelsiffra (d.v.s. 12 tecken) får fortsätta med det men för nya katalogägare är det inte tillåtet. anisationsnummer Sid 17/21
4 Förklaring till Format och Multiplicitet Nedanstående datatyper för tidpunkter/-intervall utgår från ISO 8601 om inte annat anges. För information om ISO 8601 se t ex http://en.wikipedia.org/wiki/iso_8601. För ytterligare behov av specificering av datatyper kontakta RIV-förvaltningsgrupp. (Observera att nedanstående formattabell ska uppdateras av RIV.) Svensk benämning på datatyp Sant/Falskt/ Tomt Förkortning Datatyp enligt ISO Engelsk benämning enligt ISO Förklaring S/F/T BL Boolean Kan antingen vara sant, falskt eller tomt. Sant/Falskt S/F BN Boolean not null Kan antingen vara sant eller falskt. Kodat värde med text och OID KTOV CD Coded value Identifiering av berört kodverk/klassifikation (genom sk OID) samt aktuell kod och text Exempel: A00.9 Kolera, ospecificerat OID för KSH97 v97 mycket allvarlig kolera kod K aktuellt kodvärde text TX klartext kodverk OID identifierng av berört kodverk/ klassifikation version TX kodverkets version förtydliga nde TX används t ex vid förtydligande av kod Övrigt Instans identifierare II II Instance Identifier En unik identifikation av en instans, företeelse eller objekt. T.ex. remissid, personnummer, HSA-id. Exempel: MMÅÅDD-XXXX OID för personnummer kod CV aktuellt kodvärde kodverk OID identifierng av berört kodverk/klassifikation Datapaket DP ED Encapsulate d data Används för att ange typ av bild, ljud och andra multimediadata detta specificeras senare vid behov (för information kontakta RIV förvaltningsgrupp) anisationsnummer Sid 18/21
Svensk benämning på datatyp Förkortning Datatyp enligt ISO Engelsk benämning enligt ISO Förklaring Värde VÄ Uttrycker värdets datatyp och sort värde värdetyp Kodat värde aktuellt värde värdetsdatatyp enhet Text värdets enhet Kvantitet KV PQ Physical Quantity Uttrycker mängd och sort som resultat av en mätning. Exempel: 10 kg Flertal FLT<x> SET<x> Set Uttrycker ett flertal/upprepningar av angiven datatyp Exempel. FLT<DT> 20060915 20061001 20061105 Fritext TXT ST Simple Text Fritext Tele- och datakommunikati on KOM TEL/HL7 TEL/HL7 Beskriver telekommunikationsadresser t.ex. telefonnummer, fax och e-post. Möjlighet till fritext Datum DT Date Date Angivelse av datum. Formatet är ÅÅÅÅMMDD. Det är tillåtet att ange datum med lägre precision, dvs månad eller år. Datatypen kallas fortfarande datum. Formatet är ÅÅÅÅMM respektive ÅÅÅÅ Exempel: 20060713 Tidpunkt TP TS Point in Time Angivelse av datum och klockslag med exaktheten sekund. Formatet är ÅÅÅÅ-MM-DDThh:mm:ss.xxxxx Det är tillåtet att ange tidpunkt med lägre precision, dvs minut eller timme. Formatet är hhmm respektive hh. Exempel: ÅÅÅÅ-MM-DDThh:mm eller ÅÅÅÅ-MM- DDThh Detta format är enligt ISO8601. För ytterligare behov av datatyper för tidpunkter kontakta RIVförvaltningsgrupp. Tidsintervall IVL ITV<TS> Time interval Angivelse av ett utrymme i tiden. Detta kan anges på 4 sätt: 1. Start och slut anisationsnummer Sid 19/21
Svensk benämning på datatyp Förkortning Datatyp enligt ISO Engelsk benämning enligt ISO Förklaring 2. Start och varaktighet 3. Varaktighet och slut 4. Varaktighet (utan relation till realtid) Formatet är P[tY][mM][dD][T[hH][mM][s[.s]S]] där uppgifter inom [ ] är valfria. Av de första 3 krävs två separata värden åtskilda av /. Exempel: 1. 2002-03-01T13:00:00Z/2003-05-11T15:30:00Z 2. 2002-03-01T13:00:00Z/P1Y2M10DT2H30M 3. P1Y2M10DT2H30M/2003-05-11T15:30:00Z 4. PT2H31M26.34S, dvs jordbävningen pågick i 2 timmar, 31 minuter och 26,34 sekunder Webbadress URL URL Kolumn Multiplicitet (antal möjliga förekomster) Kod, ex Förklaring 1(1..1) En förekomst 0..1 Ingen eller en förekomst 0..* Ingen eller många förekomster 1..2 En till två förekomster 1..* En till många förekomster anisationsnummer Sid 20/21
Referenser [1] HSA-schema tjänsteträdet version 4.3.xls [2] RIV Informationsspecifikation HSA Struktur och innehåll. anisationsnummer Sid 21/21