Eksterne sites på brugerprofil
Funktionen "Eksterne sites" anvendes til at linke til en ekstern side udenfor intranettet som typisk kræver login, f.eks. Ekstrabladet eller Børsen.
Via angivelse af nogle parametre i URL'en, vil man kunne logge direkte ind på sin brugerprofil på det eksterne site fra intranettet.
Bemærk: Det skal afklares med hvert enkelt eksterne site man forsøger at linke til, om de kan tage imod de parametre som er nødvendige for at kunne logge på, så nedenstående skal ses som eksempler på hvordan funktionen kan sættes op.
Før du kan gå igang, skal menupunktet Eksterne sites oprettes et sted i navigationen - typisk via venstrenavigationen på administrationsdashboardet.
Først skal du dog sikre dig at menupunktet kan vælges, og det kræver at den dynamiske indstilling EMPLOYEES / USE_EXTERNAL_SITES er sat til ON.
Når man tilgår menupunktet Eksterne sites første gang, vil det se ud som på nedenstående billede.
Der kan oprettes URL'er til følgende typer eksterne sites:
Du kan læse mere om de forskellige typer i de følgende afsnit.
"Ingen kryptering" er den mest simple type eksternt site.
Titel: Angiv et valgfrit navn.
URL: Angiv URL'en til det eksterne site, inklusiv parametre. Det er modtagersitet som skal oplyse hvilke parametre deres side tager imod.
Nøgle: Angives IKKE for denne type.
Bemærk: Parametrene i URL'en SKAL hedde det samme, som de brugerdefinerede parametre man opretter for det eksterne site.
Validerings URL benyttes til at logge på et IPS-site fra et andet IPS-site. Det kunne f.eks. være fra et intranet til et ekstranet.
"Med blowfish kryptering" -typen krypterer parameterstrengen (vha. blowfish-kryptering)
Titel: Angiv et valgfrit navn.
URL: Angiv URL'en til det eksterne site, inklusiv parametre. Det er modtagersitet som skal oplyse hvilke parametre deres side tager imod.
Brug [Timestamp|format] for at indsætte et tidsstempel, eksempel: [Timestamp|dd-MM-yyyy HH:mm:ss]. Formatet er normal string-format syntax. Hvis ikke specificeret, så er standard yyyyMMddHHmmss
Brug {} omkring de sektioner der ønskes krypteret
Nøgle: Angiv den krypteringsnøgle, der skal benyttes.
De bytes, der anvendes til kryptering, kommer fra UTF8-repræsentationen af strengen. Prefix strengen med 0x for at specificere at strengen er i Hex-format, så vil de bytes der anvendes til kryptering, istedet læses som tocifrede hexadecimale tal fra strengen.
Da Blowfish benytter den samme nøgle til kryptering og dekryptering, er det naturligvis nødvendigt, at nøglen er magen til den nøgle, som modtagersitet benytter til dekrypteringen.
Her ses et eksempel på, hvordan parameterstrengen krypteres inden den sendes til modtagersitet:
"3DES kryptering"-typen krypterer parameterstrengen (vha. 3DES-kryptering) inden den sendes til modtagersitet.
Titel: Angiv et valgfrit navn.
URL: Angiv URL'en til det eksterne site, inklusiv parametre. Det er modtagersitet som skal oplyse hvilke parametre deres side tager imod.
Nøgle: Angiv den krypteringsnøgle, der benyttes. Da 3DES benytter den samme nøgle til kryptering og dekryptering, er det naturligvis nødvendigt, at nøglen er magen til den nøgle, som modtagersitet benytter til dekrypteringen.
Her ses et eksempel på, hvordan parameterstrengen krypteres inden den sendes til modtagersitet:
http://www.eb.dk?parm=66484A2B4F65627932734A4E38646C58566E6A786F516E72673252566F566F4177374B655A5179704250445A6E6E624A727A39445A466744616335455967772F78432B304E775A3935472F483731642F50574F66444F596F4B686F7350326F2B6E52637233446C5545463942353748506C2F7055754544596E52785A62527047416A2B4B35507666784F633D
Bemærk: Parametrene i URL'en SKAL hedde det samme, som de brugerdefinerede parametre man opretter for det eksterne site.
"GUID Validerings URL"-typen fungerer på den måde, at når brugeren klikker på det linket til det eksterne site, generer IntraNote WorkSpace en GUID til brugeren, og denne GUID sender brugeren som parameter. Det eksterne site benytter denne GUID til at spørge IntraNote WorkSpace om brugerens oplysninger. Se slutningen af afsnittet for udvikler-relateret information. Når IntraNote WorkSpace modtager denne forespørgsel tjekker den først om GUID'en er udløbet. Hvis det er tilfældet sendes brugerens oplysninger ikke til det eksterne site.
Hvor lang tid der går, før en GUID udløber indstilles med den dynamiske indstilling EMPLOYEES / EXTERNAL_SITE_VALIDATE_EXPIRE. Værdien af denne dynamiske indstilling er antallet af minutter, GUID'en skal være gyldig.
Titel: Angiv et valgfrit navn.
URL: Angiv URL'en til det eksterne site. Tagget
Nøgle: Angives IKKE for denne type.
Brugerdefinerede parametre benyttes ikke for denne type.
Bemærk: URL'en SKAL indeholde tagget 'GUID' som angivet i eksemplet
Udvikler-relateret information:
Når det eksterne site modtager GUID'en fra IntraNote WorkSpace, skal det eksterne site validere GUID'en ved at tilgå URL'en "[IntraNoteWorkSpacesitename]/GUIDvalidation/[GUID]". Hvis GUID'en ikke er udløbet, returnerer WorkSpace-servicen et domæne og et user_loginname (f.eks. INTRANOTE/PKH) som json. Hvis GUID'en er udløbet, returnerer WorkSpace-servicen en fejlkode for 'GUID expired'.
Ved at klikke på Gem når man opretter et eksternt site, fremkommer et ekstra menupunkt - Tilføj brugerdefineret parameter:
Klik på menupunktet for at tilføje parametre.
Der findes følgende typer parametre:
I dette eksempel vælges der "Dynamisk", og så indtastes parametrene "User" og "Password". Husk at sætte rettigheder på via nøgleikonet for at angive hvilke brugere, der må anvende denne funktionalitet via brugerlisten.
Bemærk: Parametrene SKAL stemme overens med de parametre, der benyttes URL'en til det eksterne site.
Efter at have udfyldt de 2 parametre, vil siden se ud som på nedenstående billede (i eksemplet er der benyttet typen "Ingen kryptering" for det eksterne site).
Via ens brugerprofil, kan den enkelte bruger nu selv indtaste login og password til den eksterne side. Det gøres ved at vælge sin brugerprofil og trykke på "Eksterne sites":
Herefter kan administratoren oprette et link til sitet via linkpickeren som ses på skærmbilledet neden for. Typen "Link til eksternt site" findes både i navigationen og når man laver link i indlæg.
Anvender man statiske parametre i stedet for dynamiske, skal/kan brugeren IKKE gå ind under sin brugerprofil og oprette sine personlige data. I stedet laves der et link i en navigation eller i et indlæg til det eksterne site.
Her vælges der Link til eksternt site i Type.