← Tillbaka till startsidan

Användarguide

Så här anonymiserar du dokument med SMOB anonymiseringstjänst, steg för steg.

Innehåll

  1. Vad verktyget gör
  2. Komma igång med desktopappen
  3. Steg 1: Välj om en AI ska granska resultatet
  4. Steg 2: Lägg till filer
  5. Steg 3: Följ bearbetningen
  6. Steg 4: Resultatet
  7. Rapporten
  8. Vad platshållarna betyder
  9. Databas som källa: syntetisk kopia
  10. Webbversionen
  11. Vanliga frågor

1. Vad verktyget gör

Verktyget hittar personuppgifter i ett dokument och ersätter dem med platshållare, till exempel [PERSON_1] eller [PERSONNUMMER_1]. Resultatet är ett anonymiserat dokument som du kan använda vidare, till exempel i en extern AI-tjänst, utan att lämna ut personuppgifter.

Det finns två versioner som ser ut och fungerar likadant:

Verktyget är ett utvärderingsverktyg. Det kan missa personuppgifter och resultatet behöver alltid granskas manuellt innan det används.

2. Komma igång med desktopappen

  1. Hämta paketet för Windows eller Mac på sidan Ladda ner och packa upp zip-filen.
  2. Öppna mappen smob-anonymiseringsverktyg och starta start.cmd (Windows) eller start.command (Mac). Instruktioner finns också i filen LÄS MIG.txt i paketet.
  3. Första gången tar starten 5 till 15 minuter. Då hämtas det som behövs från vår egen server, aldrig från tredje part. Därefter startar appen på några sekunder.

När appen öppnas ser den ut så här. Fönstret är indelat i tre delar i den ordning du använder dem: inställningar, filer och resultat.

Appens startvy med de tre delarna Granska resultatet, Filer att anonymisera och Resultat
Startvyn. Raden längst ner visar vad appen gör just nu.

Om det står att verktyget laddar i bakgrunden kan du ändå lägga till filer direkt. Analysen startar så snart laddningen är klar.

3. Steg 1: Välj om en AI ska granska resultatet

Verktyget maskerar hellre för mycket än för lite. Ibland maskeras därför vanliga ord som inte är personuppgifter. Du väljer överst i fönstret om en AI-språkmodell ska granska de maskerade orden och återställa sådana som inte är personuppgifter.

Håll pekaren över frågetecknet så visas för- och nackdelar.

Hjälptexten vid frågetecknet med fördelar och nackdelar
Hjälptexten vid frågetecknet.

Väljer du extern AI-modell behöver du en access-token. Den får du av oss. Skriv in den i fältet som visas och låt Kom ihåg på den här datorn vara ikryssad om du vill slippa skriva in den nästa gång.

Extern AI-modell vald med fältet för access-token synligt
Med extern AI-modell vald visas fältet för access-token.

4. Steg 2: Lägg till filer

Analysen startar så snart du lägger till filer. Det finns tre sätt:

Filtyper som stöds

TypFiländelseKommentar
Textfil.txt
Word.docx, .doc.doc kräver att Word finns installerat och fungerar bara i desktopappen på Windows.
Excel.xlsxAlla blad läses som text.
PDF.pdfBara PDF-filer med text. Inskannade dokument utan textlager kan inte läsas.

Filer av andra typer hoppas över. Appen talar om vilka filer som hoppades över på raden längst ner.

5. Steg 3: Följ bearbetningen

Varje fil får ett eget kort under Resultat. Filerna bearbetas en i taget och kortet fylls med resultatet så snart filen är klar, medan nästa fil bearbetas. Raden längst ner visar vilken fil som bearbetas och vilket steg som pågår.

Två filer klara och en tredje som bearbetas, med knappen Avbryt nere till höger
Två filer är klara och den tredje bearbetas. Knappen Avbryt syns så länge analysen pågår.

Klicka på Avbryt om du vill stoppa. Det pågående steget körs klart först, sedan stannar analysen. Filer som redan är klara behålls. Filer som inte hann bearbetas markeras som avbrutna.

6. Steg 4: Resultatet

När en fil är klar visar kortet en sammanfattning och en förhandsvisning av den anonymiserade texten. Platshållarna är markerade så att de är lätta att hitta.

Ett resultatkort med sammanfattning, förhandsvisning och två knappar
Ett resultatkort. Sammanfattningen visar hur många uppgifter som maskerats och av vilka slag.

På kortet finns två knappar:

Vill du spara flera dokument på en gång kryssar du i rutan på varje kort, eller Välj alla, och klickar på Spara valda anonymiserade dokument…. Då väljer du en mapp och alla filer sparas där.

Resultatvyn med flera klara kort och knapparna Välj alla och Spara valda
Flera klara filer. Kryssrutorna och knappen överst används för att spara flera dokument på en gång.

Lägger du till fler filer läggs de nya korten överst. De tidigare ligger kvar tills du stänger appen.

7. Rapporten

Rapporten öppnas i webbläsaren och innehåller:

Rapportens överdel med sammanfattning, kategorier och anonymiserad text
Rapportens överdel.

I desktopappen sparas rapporterna som filer i mappen reports i appens mapp. Rapporten innehåller originaltexten i jämförelsen, så hantera den som originalet.

8. Vad platshållarna betyder

Varje uppgift ersätts med en platshållare som talar om vilken sorts uppgift det var. Samma uppgift får samma platshållare i hela dokumentet, så [PERSON_1] är samma person varje gång.

PlatshållareBetyder
[PERSON_1]Namn på en person
[PERSONNUMMER_1]Personnummer eller samordningsnummer
[EMAIL_1]E-postadress
[PHONE_1]Telefonnummer
[ADDRESS_1]Gatuadress
[LOCATION_1]Ort eller plats
[ORGANIZATION_1]Företag, myndighet eller annan organisation
[BANK_ACCOUNT_1]Kontonummer
[IBAN_1]Internationellt kontonummer (IBAN)
[BANK_CARD_1]Kortnummer

Rapporten och sammanfattningen på kortet visar kategorierna med namn på svenska.

9. Databas som källa: syntetisk kopia

Förutom filer kan desktopappen läsa tabeller direkt ur en databas och skapa en kopia där personuppgifterna är utbytta mot påhittade men trovärdiga värden. Kopian kan användas som testdata: namn ser ut som namn, personnummer har rätt form och kontrollsiffra, e-postadresser följer namnen. Samma person får samma påhittade namn i alla tabeller, så att kopplingar mellan tabellerna håller. Funktionen finns bara i desktopappen.

Kopian skapas av verktyget, aldrig i källdatabasen. Källan öppnas bara för läsning och ändras inte.

Vad som byts ut

UppgiftErsätts med
PersonnamnEtt påhittat för- och efternamn, samma för samma person i alla tabeller och i fritext.
E-postadressEn adress på en exempeldomän som följer det påhittade namnet.
TelefonnummerEtt nummer ur den serie Post- och telestyrelsen reserverat för film och tv, så det kan inte tillhöra någon.
PersonnummerEtt slumpat nummer med samma födelseår, rätt form och kontrollsiffra.
Adress, ort, organisationPåhittade gatuadresser, orter och företagsnamn.
IBAN, bankkonto, kortnummerPåhittade nummer med giltiga kontrollsummor.

Kolumner som enligt namnet innehåller en viss uppgift, till exempel Förnamn, Efternamn, Email, Telefon eller Personnummer, byts ut rakt av. Övriga textkolumner granskas av samma igenkänning som för dokument, och träffarna byts ut mitt i texten. Tal, datum och tekniska värden lämnas orörda.

Steg för steg

  1. Klicka på Välj databas… i rutan Filer eller databas att anonymisera.
  2. Ange Typ (SQL Server är förvalt; PostgreSQL, MySQL/MariaDB och SQLite-fil finns också), Adress och vid behov Port. För en namngiven SQL Server-instans skriver du adressen som server\INSTANS och låter porten stå kvar.
  3. Välj inloggning. Windows-autentisering använder den användare du är inloggad som på datorn och är förvalt. På Mac heter valet Kerberos. Annars anger du användarnamn och lösenord. Lösenordet sparas inte.
  4. Klicka på Anslut. Serverns databaser hämtas.
Databasdialogen med typ, adress, port och inloggning ifyllda innan Anslut
Server och inloggning. Efter Anslut låses källa och destination upp.
  1. Välj källdatabas under Källa. Tabellerna visas med en kryssruta var. Kryssa i de som ska tas med, eller Välj alla.
  2. Markera en tabell för att se dess kolumner till höger. Alla kolumner granskas från början. Kryssa av kolumner som ska kopieras som de är, till exempel tekniska loggkolumner där igenkänningen bara stör. Granska inga kopierar hela tabellen oförändrad.
Källdatabas vald, två tabeller ikryssade och kolumnpanelen för den markerade tabellen
Tabeller och kolumner. Här kopieras kolumnen Meddelande i dbo.Logg utan granskning.
  1. Välj destination. Samma server använder samma inloggning som källan. Skriv ett nytt databasnamn så skapas databasen, eller välj en befintlig i listan. Förslaget är källans namn med -maskad. Finns databasen redan ersätts tabeller med samma namn.
  2. Med Annan server anger du adress och inloggning till en annan server av samma typ och klickar på Anslut där. Rullistan visar sedan den serverns databaser.
  3. Klicka på Kopiera. Förloppet visas på raden längst ner i appen och Avbryt stoppar efter nästa omgång rader. När kopieringen är klar står det hur många celler som ändrats och hur många namn och andra uppgifter som bytts ut.
Destination på en annan server med eget inloggningsformulär
Destination på en annan server. Typen är låst till samma som källan.

Bra att veta

10. Webbversionen

Webbversionen på startsidan ser ut och fungerar som desktopappen. Skillnaderna är:

Webbversionens startvy, som ser ut som desktopappen
Webbversionen.

Vill du att ingenting lämnar datorn ska du använda desktopappen utan AI-granskning.

11. Vanliga frågor

Appen säger att ODBC-drivrutinen för SQL Server saknas

SQL Server nås via Microsofts ODBC-drivrutin, som inte ingår i appen. På Windows hämtar du Microsoft ODBC Driver 18 for SQL Server och installerar den (kräver administratörsrättigheter). På Mac installeras den med Homebrew i Terminal:

brew tap microsoft/mssql-release https://github.com/Microsoft/homebrew-mssql-release
brew update && HOMEBREW_ACCEPT_EULA=Y brew install msodbcsql18 mssql-tools18

Starta om appen efteråt. PostgreSQL, MySQL/MariaDB och SQLite behöver ingen extra drivrutin.

Anslutningen till databasen får timeout

Felet "Server is not found or not accessible" betyder att inget svarar på serverns port, oftast för att en brandvägg spärrar den eller att instansen lyssnar på en annan port. Kontrollera adress och port med den som sköter servern. Inloggningen prövas först när porten svarar.

Appen säger att filtypen inte stöds

Bara .txt, .docx, .doc, .xlsx och .pdf kan läsas. Spara dokumentet i ett av de formaten och försök igen.

Appen säger att access-token saknas

Du har valt extern AI-modell utan att ange access-token. Skriv in den token du fått av oss, eller välj Ingen granskning.

AI-granskningen genomfördes inte

Servern eller leverantören svarade inte, eller access-token avvisades. Resultatet är ändå klart: inget har återställts och den maskerade texten används som slutresultat. Du kan köra filen igen senare.

Första starten tar lång tid

Det är normalt. Första gången hämtas Python-paket och språkmodellen, sammanlagt några gigabyte. Nästa start går på några sekunder.

Var hamnar rapporterna?

I mappen reports i appens mapp. Raden längst ner i appen visar sökvägen när analysen är klar.

Kan verktyget missa något?

Ja. Verktyget är ett utvärderingsverktyg och kan missa personuppgifter, särskilt ovanliga namn eller uppgifter som bara framgår av sammanhanget. Läs alltid igenom resultatet innan det används.

Vad händer med mina uppgifter?

Se Behandling av personuppgifter.